Vidmoat Skills
Video editing craft, written down as Agent Skills: how
to caption so people can read it, how to sit music under a voice, and more.
Each skill is a folder with a SKILL.md that any skills-aware agent can load
when the task calls for it: Claude Code, Codex, GitHub Copilot, Cursor, Gemini
CLI and others.
The skills are tool-agnostic. They work in whatever editor you use, and every
one has a path that needs nothing but ffmpeg. They come from the editing
guidance inside Vidmoat, an AI video editor; the editor
itself stays closed, the craft is open.
What is in a skill
skills/core/caption-styling/
SKILL.md defaults, workflow, gotchas (loaded when relevant)
references/ detail the agent reads only when it needs it
scripts/ small standard-library tools (no network, no installs)
evals/evals.json trigger cases and graded output cases
Every skill has a Gotchas section of corrections learned from real
failures, and an eval suite that checks both that the skill loads when it
should (and stays out of the way on near misses) and that answers with the
skill beat answers without it.
Catalogue
Generated by npm run catalogue from each SKILL.md. Do not edit by hand.
Core (maintainer-curated)
| Skill | Version | What it does |
|---|
audio-ducking | 1.0.0 | Mix voice over music so every word stays clear. |
caption-styling | 1.1.0 | Style, time and place captions and subtitles so they read on a phone with the sound off. |
Community
No community skills yet. See CONTRIBUTING.md to propose one.
Vidmoat (official: the skills the Vidmoat editor loads)
| Skill | Version | What it does |
|---|
accessibility-lead | 2.0.0 | Accessibility Lead specialist, tagged @accessibility-lead or consulted for a review against a written standard: broadcast caption limits (32 characters a line, 17 a second),... |
ad-director | 2.0.0 | Ad Creative Director specialist, tagged @ad-director or consulted for an ad concept: a premise per product, a purpose per shot, no invented claims. |
ad-promo | 1.0.1 | Ads and promos: the product in use within 2 seconds, proof, one next action, supplied facts only. |
audio-cleanup | 2.0.0 | Diagnosing and fixing voice and source audio: the right control for hiss, rumble, hum and sibilance, levels and EQ. |
beat-sync | 1.1.0 | Cutting picture on a measured beat grid: markers, one slice, grouped snapping, transitions and the last cut on the beat. |
brand-guardian | 1.0.1 | Brand Guardian specialist, tagged @brand-guardian or consulted for a brand audit: fonts, sizes, colours and timings collapsed onto tokens, one accent per frame. |
camera-motion | 1.0.1 | Virtual camera moves: punch-ins, Ken Burns on stills, shake on impacts, rack focus, whip pans and subtle depth. |
This repository is the single source for every Vidmoat skill. core skills
are curated by maintainers and tool-agnostic. community skills are
contributed by anyone, reviewed and linted the same way, and never loaded
automatically by Vidmoat. vidmoat skills are the ones the Vidmoat editor
loads (its specialists, its editing craft and its MCP manual): they name
Vidmoat's editing commands, and the craft in them carries to any editor.
The editor loads core and vidmoat skills from a pinned, reviewed commit of
this repository. A pull request merged here reaches the editor when a
maintainer imports that commit into the product (a reviewed change there) and
it ships with the next deploy; nothing is fetched at run time. See
CONTRIBUTING.md and
docs/product-import.md.
Install
Claude Code
/plugin marketplace add vidmoat/skills
/plugin install vidmoat-core@vidmoat-skills
From a shell: claude plugin marketplace add vidmoat/skills. To stay on
released versions only, add vidmoat/skills#stable instead. Community skills
are a separate plugin, vidmoat-community@vidmoat-skills, so you opt in to
them deliberately, and so are the official product skills,
vidmoat-editor@vidmoat-skills (most useful with the Vidmoat MCP server).
To use a single skill without the plugin system, copy its folder into
.claude/skills/ in your project or ~/.claude/skills/ for every project.
Codex, GitHub Copilot, Cursor, Gemini CLI and other clients
Most clients read skills from a skills directory. .agents/skills/ (in a
project) and ~/.agents/skills/ (for your user) are the shared convention at
the time of writing; check your client's documentation for its current paths.
git clone --depth 1 --branch stable https://github.com/vidmoat/skills.git vidmoat-skills
mkdir -p .agents/skills
cp -r vidmoat-skills/skills/core/caption-styling .agents/skills/
| Client | Project folder | User folder |
|---|
| Codex | .agents/skills/ | ~/.agents/skills/ |
| GitHub Copilot | .github/skills/ or .agents/skills/ | ~/.copilot/skills/ or ~/.agents/skills/ |
| Cursor | .cursor/skills/ or .agents/skills/ | see Cursor docs |
| Gemini CLI | .gemini/skills/ or .agents/skills/ | ~/.gemini/skills/ or ~/.agents/skills/ |
Community installers that understand this layout, such as the skills CLI
(npx skills add vidmoat/skills), should also work. We do not maintain them;
read what they install before you run them.
Pinning for production
If you load these skills into a product, pin an exact commit or a release
archive and verify its checksum. See docs/consuming.md.
Contributing
New skills, fixes and gotchas from real failures are welcome. In short:
- Open an issue with the New skill or Gotcha report template first.
- Add your skill under
skills/community/<name>/ with SKILL.md, a Gotchas
section and evals/evals.json (trigger cases with near-miss negatives, and
output cases with assertions).
- Run
npm test (Node 20 or newer, no dependencies) and fix what it reports.
- Sign off every commit (
git commit -s): we use the
Developer Certificate of Origin, not a CLA.
Read CONTRIBUTING.md for the full guide and style rules, and
docs/authoring.md for how to write a skill that helps.
Please also read the Code of Conduct.
Security
Skills are instructions an agent follows, so this repository treats skill text
like code: hidden Unicode, HTML comments, network calls and package installs in
scripts, and prompt-injection phrasing all fail CI. Report a vulnerability
privately as described in SECURITY.md; the threat model is in
docs/security.md.
Licences
| Path | Licence |
|---|
Skill prose: skills/**/*.md and other non-code skill files (including evals/) | CC-BY-4.0 |
Code: skills/**/scripts/**, tools/**, .github/** and other code files | Apache-2.0 |
Repository docs: README.md, docs/**, CONTRIBUTING.md and similar | CC-BY-4.0 |
CODE_OF_CONDUCT.md | Contributor Covenant 2.1, CC-BY-4.0 |
Attribution for CC-BY-4.0 content: "Vidmoat Skills contributors,
https://github.com/vidmoat/skills". Neither licence grants rights to the
Vidmoat name or logo; see TRADEMARKS.md.
