דילוג לתוכן

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.

Easiest: let your AI set it upCopy one prompt into Claude Code, Codex or Cursor. It installs Yoh and walks you through sign-in, on macOS, Linux or Windows.

Install the skill

  1. 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"
    )
  2. 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"
    )
  3. 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"
    )
  4. 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