← Files Creative ClawARCHIVED FILE
skills/creativeclaw/references/tool-catalog.md
11.8 KB · Sep 30, 2026 · 23:19 UTC
# Tool catalog
Use this as routing guidance. Tool availability varies by client; never recite the catalog to the user or invent a missing tool.
## Models and generation
| Tool | Use |
| ------------------ | ------------------------------------------------------------------------------------------------------------------------- |
| `list_models` | Discover current image, video, speech, and audio models. Filter by category. |
| `get_model_params` | Read the chosen model's actual schema, defaults, enums, and extra fields. |
| `generate_image` | Generate an image or edit a source supplied as `image_url`. Additional model-specific references normally go in `extras`. |
| `generate_video` | Generate, animate, extend, retake, reframe, edit, or drive video according to model capability and `operation`. |
| `generate_speech` | Generate speech. Supports model-specific voices, delivery controls, reference audio, and Characters. |
| `generate_music` | Generate scores, music beds, stings, jingles, themes, or songs with ElevenLabs Music. |
| `generate_sound_effect` | Generate sound effects, ambience, Foley, transitions, impacts, or textures with ElevenLabs. |
Use `list_models` before relying on a remembered model ID. Use `get_model_params` before sending `extras`, reference arrays, resolution, duration, or operation-specific fields. Route speech to `generate_speech`, music to `generate_music`, and sound effects to `generate_sound_effect`.
For a model comparison, call `generate_image` once per selected model with the same prompt and settings, then present the results together.
## Curated examples
| Tool | Use |
| ----------------- | -------------------------------------------------------------------------------------------------------- |
| `search_examples` | Browse lean summaries and previews. Filter by query, output type, exact model ID, tags, and page cursor. |
| `get_example` | Load one selected example's complete agent-ready prompt and generation hints by ID or slug. |
Use `creativeclaw-find-examples` when the user asks for examples, inspiration, style directions, alternatives, or a close starting point. Do not search automatically before every generation. Tags are conjunctive: every supplied tag must match. After selection, load one example, adapt its generation prompt to the user's subject, and keep the owning generation workflow in control.
## Deterministic HTML rendering
| Tool | Use |
| ------------------- | -------------------------------------------------------------------------------------------------------------- |
| `render_html_image` | Render a deterministic HTML/CSS layout to a PNG via Chromium. |
| `render_html_video` | Queue a HyperFrames-backed HTML/CSS/JS motion render; resolve the final video URL with `check_job`. |
| `create_template` | Save a reusable parameterized HTML or generative layout. |
| `render_template` | Render a saved template with provided values. |
The image and video renderers are explicit-only choices. Use them only when the user asks for HTML/CSS, HyperFrames, code-driven rendering, supplies HTML, or explicitly accepts the method. A generic poster, social card, overlay, intro, or outro request is not sufficient by itself.
## Themes
| Tool | Use |
| -------------- | ----------------------------------------------------------------------------------------------------- |
| `list_themes` | Discover theme names and the default theme. |
| `get_theme` | Fetch the default or named theme, including structured data and reference images. |
| `update_theme` | Open the visual editor with `interactive: true`, or directly create/update data and reference images. |
| `delete_theme` | Remove a theme only when explicitly requested. |
For conversational setup or edits, prefer `update_theme({ interactive: true })`. For exact programmatic changes, fetch first and send the smallest direct update. Theme `data` shallow-merges; `images` replaces the full reference-image array.
## Assets and imports
| Tool | Use |
| ----------------------------------- | ------------------------------------------------------------------------------------------------------ |
| `search_assets` | Find recent or matching media by type, query, tags, exact name, or source. |
| `update_asset` | Set a unique name, replace tags, or update a description. |
| `delete_asset` | Soft-delete an asset only when explicitly requested. |
| `load_image` | Display an image URL inline when exposed. |
| `import_chatgpt_media` | Convert one native ChatGPT attachment into a durable Creative Claw asset when exposed. |
| `import_media` | Open the picker when the user still needs to choose a file. |
| `get_upload_url` + `confirm_upload` | Upload local bytes from clients that can perform an HTTP PUT. |
| `upload_asset` | Copy a public, directly downloadable URL into the library. Requires `url`, `content_type`, and `type`. |
Read `platform-upload.md` before choosing an import route.
## Characters and films
| Tool | Use |
| ----------------------------------------- | ------------------------------------------------------------------------------------------------- |
| `manage_character` | Create or update a visual persona with a description and reference image. |
| `clone_voice` | Create or replace a consented ElevenLabs voice clone attached to an existing Character. |
| `list_characters` | Find reusable Characters and IDs. |
| `delete_character` | Remove a Character only when explicitly requested. |
| `create_film_project` | Create a multi-shot Film project. |
| `update_film_project` | Save script, shots, storyboards, clips, audio, and approval state. |
| `get_film_project` / `list_film_projects` | Inspect Film projects. |
| `assemble_film` | Concatenate every approved shot clip into a first cut and optionally overlay one project narration track. |
## Media processing
| Tool | Use |
| ------------------- | ----------------------------------------------------------------------------------------- |
| `remove_background` | Remove an image or video background. |
| `upscale_media` | Upscale image or video. |
| `trim_video` | Cut a time range. |
| `scale_video` | Resize, crop, or pad video. |
| `add_subtitles` | Burn captions into video. |
| `extract_frames` | Extract one or more still frames from video. |
| `merge_media` | Concatenate videos or audio, or combine an audio track with video. |
| `transcribe` | Produce a timed transcript from audio, video, or a public YouTube URL. |
| `isolate_audio` | Remove noise, music, and reverb from a voice recording. Queued; resolve with `check_job`. |
## Account and billing
Use `manage_account` to view the connected account, balances, recent generations and credit activity, including charges and refunds. Open `overview` for the balance, `activity` for a specific generation's recorded cost, or `settings` for generation preferences. Its account-page link provides user-operated purchase and subscription management; calling this read-only tool does not change billing.
Read [account guidance](workflows/account.md) to match jobs to charges, distinguish gross charges/refunds/net cost, and handle missing or older records. Use `estimate_generation` for future quotes, not proof of what a past generation cost. A balance question alone is not a feedback submission request.
## Jobs and credits
| Tool | Use |
| --------------------- | -------------------------------------------------------------------- |
| `check_job` | Resolve queued work by `job_id` when a completed result is required. |
| `estimate_generation` | Estimate one planned generation, check the current balance, and return affordable H3 alternatives when needed. The final cost is confirmed after generation finishes. |
| `get_credits_balance` | Check balance and usage when exposed. |
| `get_credits_link` | Return a user-operated top-up link when exposed. |
## Product feedback
| Tool | Use |
| ----------------- | ------------------------------------------------------------------------------------------------------------ |
| `submit_feedback` | Report a bug, missing feature or model, confusing flow, generation-quality issue, or explicit user praise. |
Use `source: "agent"` for friction observed during a task and `source: "user"` when relaying the user's own feedback. Send one concise, specific report only when the user asks or approves; a complaint or account question alone is not authorization. Completed playable video generations are charged even if the user is disappointed. Feedback helps improve future generations and does not itself trigger a refund. For critical issues, users can also contact support@creativeclaw.co. Read [feedback guidance](workflows/feedback.md) before reporting.
## Metadata conventions
- Use concise unique names such as `acme-launch-hero-v2`.
- Use lowercase stable tags such as `acme`, `launch-2026`, `approved`, `reference`, `character-mira`.
- `update_asset.tags` replaces the current tag array; include every tag that should remain.
- Search before generating a duplicate and before assigning a name that must be unique.
SHA-256: abb953d62af907581d14158903979d8528c2a7e4e5018101451889817b4079d1