> ## Documentation Index
> Fetch the complete documentation index at: /docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Skills and agent roles

> The video workflows (skills) and helper agents CoClip gives every agent, and when to ask for them.

CoClip teaches your agent how to make videos with **skills** (step-by-step workflows) and **agent roles** (helper agents that work in parallel). They come with every AI dock session: Claude, Codex, OpenCode and Antigravity. Outside the editor, Claude Code gets them from the [CoClip plugin](/docs/ai-agents/outside-the-editor.md#claude-code).

## How to use them

* **Just describe the task.** The agent picks the matching skill from what you ask, for example "make a 45-second explainer from this script".
* **Name the skill** if you want a specific workflow: "Use the reference-remake skill on this video".
* **In Claude Code**, you can also run a skill as a command: `/coclip:explainer-video`, `/coclip:brand` and so on.

## Skills

| Skill | What it does | Ask for it when |
| - | - | - |
| `explainer-video` | Makes a short vertical explainer or ad: voice-over, big on-screen titles, cards and doodles timed to the words. | You want an explainer, a product ad, a "how it works" or a tips video. |
| `elements` | Adds animated motion elements: charts, maps with flight paths, counters, lower thirds, kinetic text, social mockups, Lottie/Rive animations and more. | A scene needs a chart, a map, a counter or another animated element. |
| `graphics` | Adds on-screen graphics: section headers, sticky notes, app-window cards, chat bubbles, arrows, ticks, underlines and circles. Uses editable graphic elements first. | A scene needs a card, a doodle or a UI mock, not a photo. |
| `voice-music` | Voice-over (ElevenLabs or Vbee), pronunciation fixes, music under the voice and sound effects placed on visual cues. | You need a voice-over, music or sound effects, or a word is mispronounced or cut off. |
| `threads-story` | Builds or edits a "Threads story": a chain of Threads-style post cards read by a voice-over, with replies, music and captions. | You want a social-post story or a thread ad. |
| `reference-remake` | Studies a reference video (structure, pacing, text style, voice, music) and turns it into a blueprint and a new clip script. | You share a video and say "make one like this". |
| `brand` | Creates, edits and applies brand kits: brief, voice, logos, colours, fonts, text styles and TTS voice. | You name a brand, product or website, or want your brand kit applied. |
| `parallel-build` | Builds a video with several sections using helper agents at the same time: a sample section first, then the rest in parallel. | The clip script is approved, the video has more than one section, and you want it built faster. |

Voice, music and image generation use your own connector accounts. See [Connectors](/docs/reference/connectors.md).

## Agent roles

Agent roles are helper agents. The main session starts them; you usually do not call them yourself.

| Role | What it does | Used when |
| - | - | - |
| `reference-analyst` | Imports and analyses a reference video, fills its blueprint and returns a short summary, so frame images stay out of your main conversation. | You say "analyse this reference", or before a remake. |
| `element-artist` | Writes and tests one custom element from a written spec. Never places items on the timeline. | A parallel build needs a custom element. |
| `asset-maker` | Makes static assets (graphics, generated images, imported files) into the Library without placing them. Asks before spending paid credits. | A parallel build needs images or graphics. |
| `chapter-builder` | Builds one section of the video inside its time range and checks it. | A parallel build, one per section. |
| `qa-reviewer` | Checks a part of the video for layout problems, blank gaps, unlinked script lines and other issues. Changes nothing. | After a section is built, or over the whole video before the finish. |

In Codex, OpenCode and Antigravity sessions the roles carry a `coclip-` prefix, for example `coclip-qa-reviewer`.

## Rules every workflow follows

* **No export without you.** When the video is done, the agent asks whether to export. It runs the export only after you say yes. Helper agents have no export tools.
* **Every edit is named and can be undone.** Helper agents' edits show in the **AI log** as the session name plus the role, for example `Claude 1 · chapter-1`. See [AI log and undo](/docs/ai-agents/ai-log-and-undo.md).

## Related pages

* [Example prompts](/docs/ai-agents/example-prompts.md)
* [MCP tools](/docs/ai-agents/mcp-tools.md)
* [Reference videos](/docs/library/reference-videos.md)
* [Brand kit](/docs/library/brand-kit.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.