Custom Skills
Each project can have custom skills — packaged .zip bundles you upload through the web UI. They’re loaded alongside the built-in skills whenever the agent runs.
Getting started
- Navigate to Brand Assets in your project dashboard
- Click Custom Skills in the sidebar
- Click + New skill, pick a slug, and upload a
.zip containing SKILL.md
Skill package layout
Inside the zip:
The only required file is SKILL.md at the root of the zip.
Writing a SKILL.md
A skill file has two parts: frontmatter (metadata) and body (instructions for the agent).
Frontmatter fields
Body
The body is free-form Markdown. Write it as if you’re briefing a colleague — the agent reads these instructions when the skill is relevant to the current task.
Common sections to include:
- When to use — triggers and scenarios
- How to use — step-by-step patterns
- Rules — constraints, gotchas, things to avoid
- Examples — sample prompts or code snippets
Adding reference files
For complex skills, break additional context into separate files under a rules/ subdirectory and reference them from SKILL.md:
This keeps the main skill file scannable while allowing deep-dive content when needed.
Example: brand voice skill
Reserved skill names
Some skill names have special meaning — the agent’s built-in workflows look for them by name. If you create a skill with a reserved name, it plugs directly into the corresponding pipeline.
content-lookup
The video assembly pipeline uses this skill to discover source video content. When the agent needs raw footage for clip selection, it invokes content-lookup to get a list of available content entries with preview URLs.
Your content-lookup skill should return structured information about where to find source videos — for example, an API endpoint, a folder path, or a catalog of entries with URLs the agent can fetch.
Without a content-lookup skill, the agent won’t know where to find source footage for video assembly. Add this skill first if you’re producing video ads.
Updating skills
Re-upload the skill using the same slug — the new zip replaces the old one.
The agent picks up changes on the next sync (automatic on sandbox wake, or
trigger manually with the sync_skills tool during a session).
Built-in skills
Your custom skills run alongside the built-in skills that ship with the agent. These include skills for Remotion video production, ElevenLabs voice synthesis, video assembly, frontend design, and more. Custom skills take the same format and have equal priority.
