The Yoh skill for AI agents
The MCP server gives your agent the tools; the skill teaches it the craft. A SKILL.md in the open Agent Skills format tells the agent how to make a Yoh story well and the rules that are easy to get wrong.
Install the skill
Claude Code
Claude picks the skill up automatically when you ask for a Yoh video. The command stops if a Yoh skill is already installed, so it never overwrites your changes.
( set -eu skill_dir="$HOME/.claude/skills/yoh" if [ -e "$skill_dir" ]; then printf '%s\n' 'Yoh skill already exists. Use the setup prompt to check or update it.' >&2 exit 1 fi mkdir -p "$skill_dir/references" "$skill_dir/scripts" curl --fail --show-error --location 'https://www.yoh.app/skills/yoh/SKILL.md' --output "$skill_dir/SKILL.md" curl --fail --show-error --location 'https://www.yoh.app/skills/yoh/references/browser-workflow.md' --output "$skill_dir/references/browser-workflow.md" curl --fail --show-error --location 'https://www.yoh.app/skills/yoh/references/checking-clips.md' --output "$skill_dir/references/checking-clips.md" curl --fail --show-error --location 'https://www.yoh.app/skills/yoh/references/common-jobs.md' --output "$skill_dir/references/common-jobs.md" curl --fail --show-error --location 'https://www.yoh.app/skills/yoh/references/editing-clips.md' --output "$skill_dir/references/editing-clips.md" curl --fail --show-error --location 'https://www.yoh.app/skills/yoh/references/errors-and-refusals.md' --output "$skill_dir/references/errors-and-refusals.md" curl --fail --show-error --location 'https://www.yoh.app/skills/yoh/references/generation-and-pricing.md' --output "$skill_dir/references/generation-and-pricing.md" curl --fail --show-error --location 'https://www.yoh.app/skills/yoh/references/gotchas.md' --output "$skill_dir/references/gotchas.md" curl --fail --show-error --location 'https://www.yoh.app/skills/yoh/references/hires-ads-publishing.md' --output "$skill_dir/references/hires-ads-publishing.md" curl --fail --show-error --location 'https://www.yoh.app/skills/yoh/references/lines-and-voices.md' --output "$skill_dir/references/lines-and-voices.md" curl --fail --show-error --location 'https://www.yoh.app/skills/yoh/references/looks-and-assets.md' --output "$skill_dir/references/looks-and-assets.md" curl --fail --show-error --location 'https://www.yoh.app/skills/yoh/references/mcp-tool-index.md' --output "$skill_dir/references/mcp-tool-index.md" curl --fail --show-error --location 'https://www.yoh.app/skills/yoh/references/recipes.md' --output "$skill_dir/references/recipes.md" curl --fail --show-error --location 'https://www.yoh.app/skills/yoh/references/setup-and-clients.md' --output "$skill_dir/references/setup-and-clients.md" curl --fail --show-error --location 'https://www.yoh.app/skills/yoh/references/stories-and-scripts.md' --output "$skill_dir/references/stories-and-scripts.md" curl --fail --show-error --location 'https://www.yoh.app/skills/yoh/references/timeline-analysis.md' --output "$skill_dir/references/timeline-analysis.md" curl --fail --show-error --location 'https://www.yoh.app/skills/yoh/references/timeline-and-edit-mode.md' --output "$skill_dir/references/timeline-and-edit-mode.md" curl --fail --show-error --location 'https://www.yoh.app/skills/yoh/references/upload-and-cut.md' --output "$skill_dir/references/upload-and-cut.md" curl --fail --show-error --location 'https://www.yoh.app/skills/yoh/references/writing-clips.md' --output "$skill_dir/references/writing-clips.md" curl --fail --show-error --location 'https://www.yoh.app/skills/yoh/scripts/download_timeline_analysis.py' --output "$skill_dir/scripts/download_timeline_analysis.py" )Codex
In Codex, call it with $yoh.
( set -eu skill_dir="$HOME/.agents/skills/yoh" if [ -e "$skill_dir" ]; then printf '%s\n' 'Yoh skill already exists. Use the setup prompt to check or update it.' >&2 exit 1 fi mkdir -p "$skill_dir/references" "$skill_dir/scripts" curl --fail --show-error --location 'https://www.yoh.app/skills/yoh/SKILL.md' --output "$skill_dir/SKILL.md" curl --fail --show-error --location 'https://www.yoh.app/skills/yoh/references/browser-workflow.md' --output "$skill_dir/references/browser-workflow.md" curl --fail --show-error --location 'https://www.yoh.app/skills/yoh/references/checking-clips.md' --output "$skill_dir/references/checking-clips.md" curl --fail --show-error --location 'https://www.yoh.app/skills/yoh/references/common-jobs.md' --output "$skill_dir/references/common-jobs.md" curl --fail --show-error --location 'https://www.yoh.app/skills/yoh/references/editing-clips.md' --output "$skill_dir/references/editing-clips.md" curl --fail --show-error --location 'https://www.yoh.app/skills/yoh/references/errors-and-refusals.md' --output "$skill_dir/references/errors-and-refusals.md" curl --fail --show-error --location 'https://www.yoh.app/skills/yoh/references/generation-and-pricing.md' --output "$skill_dir/references/generation-and-pricing.md" curl --fail --show-error --location 'https://www.yoh.app/skills/yoh/references/gotchas.md' --output "$skill_dir/references/gotchas.md" curl --fail --show-error --location 'https://www.yoh.app/skills/yoh/references/hires-ads-publishing.md' --output "$skill_dir/references/hires-ads-publishing.md" curl --fail --show-error --location 'https://www.yoh.app/skills/yoh/references/lines-and-voices.md' --output "$skill_dir/references/lines-and-voices.md" curl --fail --show-error --location 'https://www.yoh.app/skills/yoh/references/looks-and-assets.md' --output "$skill_dir/references/looks-and-assets.md" curl --fail --show-error --location 'https://www.yoh.app/skills/yoh/references/mcp-tool-index.md' --output "$skill_dir/references/mcp-tool-index.md" curl --fail --show-error --location 'https://www.yoh.app/skills/yoh/references/recipes.md' --output "$skill_dir/references/recipes.md" curl --fail --show-error --location 'https://www.yoh.app/skills/yoh/references/setup-and-clients.md' --output "$skill_dir/references/setup-and-clients.md" curl --fail --show-error --location 'https://www.yoh.app/skills/yoh/references/stories-and-scripts.md' --output "$skill_dir/references/stories-and-scripts.md" curl --fail --show-error --location 'https://www.yoh.app/skills/yoh/references/timeline-analysis.md' --output "$skill_dir/references/timeline-analysis.md" curl --fail --show-error --location 'https://www.yoh.app/skills/yoh/references/timeline-and-edit-mode.md' --output "$skill_dir/references/timeline-and-edit-mode.md" curl --fail --show-error --location 'https://www.yoh.app/skills/yoh/references/upload-and-cut.md' --output "$skill_dir/references/upload-and-cut.md" curl --fail --show-error --location 'https://www.yoh.app/skills/yoh/references/writing-clips.md' --output "$skill_dir/references/writing-clips.md" curl --fail --show-error --location 'https://www.yoh.app/skills/yoh/scripts/download_timeline_analysis.py' --output "$skill_dir/scripts/download_timeline_analysis.py" )Cursor
Installs into ~/.cursor/skills. On Windows, the setup page has PowerShell versions of every command.
( set -eu skill_dir="$HOME/.cursor/skills/yoh" if [ -e "$skill_dir" ]; then printf '%s\n' 'Yoh skill already exists. Use the setup prompt to check or update it.' >&2 exit 1 fi mkdir -p "$skill_dir/references" "$skill_dir/scripts" curl --fail --show-error --location 'https://www.yoh.app/skills/yoh/SKILL.md' --output "$skill_dir/SKILL.md" curl --fail --show-error --location 'https://www.yoh.app/skills/yoh/references/browser-workflow.md' --output "$skill_dir/references/browser-workflow.md" curl --fail --show-error --location 'https://www.yoh.app/skills/yoh/references/checking-clips.md' --output "$skill_dir/references/checking-clips.md" curl --fail --show-error --location 'https://www.yoh.app/skills/yoh/references/common-jobs.md' --output "$skill_dir/references/common-jobs.md" curl --fail --show-error --location 'https://www.yoh.app/skills/yoh/references/editing-clips.md' --output "$skill_dir/references/editing-clips.md" curl --fail --show-error --location 'https://www.yoh.app/skills/yoh/references/errors-and-refusals.md' --output "$skill_dir/references/errors-and-refusals.md" curl --fail --show-error --location 'https://www.yoh.app/skills/yoh/references/generation-and-pricing.md' --output "$skill_dir/references/generation-and-pricing.md" curl --fail --show-error --location 'https://www.yoh.app/skills/yoh/references/gotchas.md' --output "$skill_dir/references/gotchas.md" curl --fail --show-error --location 'https://www.yoh.app/skills/yoh/references/hires-ads-publishing.md' --output "$skill_dir/references/hires-ads-publishing.md" curl --fail --show-error --location 'https://www.yoh.app/skills/yoh/references/lines-and-voices.md' --output "$skill_dir/references/lines-and-voices.md" curl --fail --show-error --location 'https://www.yoh.app/skills/yoh/references/looks-and-assets.md' --output "$skill_dir/references/looks-and-assets.md" curl --fail --show-error --location 'https://www.yoh.app/skills/yoh/references/mcp-tool-index.md' --output "$skill_dir/references/mcp-tool-index.md" curl --fail --show-error --location 'https://www.yoh.app/skills/yoh/references/recipes.md' --output "$skill_dir/references/recipes.md" curl --fail --show-error --location 'https://www.yoh.app/skills/yoh/references/setup-and-clients.md' --output "$skill_dir/references/setup-and-clients.md" curl --fail --show-error --location 'https://www.yoh.app/skills/yoh/references/stories-and-scripts.md' --output "$skill_dir/references/stories-and-scripts.md" curl --fail --show-error --location 'https://www.yoh.app/skills/yoh/references/timeline-analysis.md' --output "$skill_dir/references/timeline-analysis.md" curl --fail --show-error --location 'https://www.yoh.app/skills/yoh/references/timeline-and-edit-mode.md' --output "$skill_dir/references/timeline-and-edit-mode.md" curl --fail --show-error --location 'https://www.yoh.app/skills/yoh/references/upload-and-cut.md' --output "$skill_dir/references/upload-and-cut.md" curl --fail --show-error --location 'https://www.yoh.app/skills/yoh/references/writing-clips.md' --output "$skill_dir/references/writing-clips.md" curl --fail --show-error --location 'https://www.yoh.app/skills/yoh/scripts/download_timeline_analysis.py' --output "$skill_dir/scripts/download_timeline_analysis.py" )Connect the MCP server
The skill works through the Yoh MCP server, so connect it too (see the Claude, Codex or MCP pages).
Then just ask
- “Make a 60-second story about a night-shift nurse who can hear ghosts.”
- “Turn this script into a five-episode series and show me the cast before you draw anything.”
- “Tighten episode 3: trim the dead air, move the captions onto the beats, then quote the render.”
- “Swap the lead in clip 4 for my character and redo only that clip's video.”
Why it works well
What the skill teaches
Start every episode inside a series so the cast carries over; quote before spending and show the price; look at the clips before judging them; and when to drive the yoh.app page in a browser next to the tools.
Three ways to work
Tools plus browser (the agent checks each result on the real page), browser only, or tools only for scripts, CI and agencies.
Always current
The files are served from yoh.app and updated with the server. To update an installed copy without losing your own edits, use the setup prompt on the guided setup page.
Nothing is charged without your OK
Reading and editing are free. Every step that spends credits (drawing pictures, generating clip videos, rendering) first returns a price. The agent shows it to you and only goes ahead after you approve, and the same approval cannot be charged twice.
Questions
What is a SKILL.md?
A skill is a Markdown file with instructions an AI agent loads when a task matches it. The Yoh skill uses the open Agent Skills format, so it works in Claude Code, Codex, Cursor and other agents that read skills.
Do I need the skill if I have the MCP server?
It is optional but recommended. Without it the agent sees the tools; with it the agent follows the workflow that makes good videos and avoids wasted credits.
Is it free?
Yes. The skill is a free download; only generation uses Yoh credits.
Full reference: Yoh docs · Pricing
Other ways to connect
- Make AI videos with ClaudeConnect Claude to your Yoh account and make video stories by asking. Claude writes the script, keeps characters consistent, generates the clips, edits the timeline and renders the finished video, and checks with you before anything costs credits.
- Make AI videos with CodexConnect Codex to Yoh and let it produce video stories from your terminal or editor: script, cast, clips, voices, captions and the final render, with a price shown and approved before every paid step.
- The Yoh MCP server for AI videoOne remote MCP endpoint gives any agent the whole Yoh studio: write a story, cast and draw characters, generate clip videos with voices and music, edit the timeline and captions, render and publish. Every tool follows the same rules as the yoh.app editor.
- AI video generation APISend a prompt, get back a finished video: Yoh writes the script, casts consistent characters, adds voices, music and captions and renders the MP4. Or drive each step yourself: stories, series, clips, characters, timeline and renders.