AI 에이전트를 위한 Yoh 스킬
MCP 서버는 에이전트에게 도구를 주고, 스킬은 다루는 요령을 가르칩니다. 공개 Agent Skills 형식의 SKILL.md가 Yoh 스토리를 잘 만드는 방법과 놓치기 쉬운 규칙을 에이전트에게 알려 줍니다.
스킬 설치하기
Claude Code
Yoh 영상을 요청하면 Claude가 스킬을 자동으로 불러옵니다. 이미 Yoh 스킬이 설치되어 있으면 명령이 멈추므로 직접 수정한 내용을 덮어쓰지 않습니다.
( 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
Codex에서는 $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
~/.cursor/skills에 설치됩니다. Windows용으로는 설정 페이지에 모든 명령의 PowerShell 버전이 있습니다.
( 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" )MCP 서버 연결
스킬은 Yoh MCP 서버를 통해 작동하므로 서버도 연결하세요(Claude, Codex, MCP 페이지 참고).
그다음 요청만 하세요
- “유령의 목소리를 듣는 야간 근무 간호사 이야기를 60초 영상으로 만들어 주세요.”
- “이 대본을 5화짜리 시리즈로 만들고, 그림을 그리기 전에 캐스팅부터 보여 주세요.”
- “3화를 다듬어 주세요. 빈 구간을 잘라 내고 자막을 박자에 맞춘 다음 렌더링 견적을 알려 주세요.”
- “4번 클립의 주인공을 제 캐릭터로 바꾸고 그 클립 영상만 다시 만들어 주세요.”
잘 작동하는 이유
스킬이 알려 주는 것
출연진이 이어지도록 모든 에피소드를 시리즈 안에서 시작하기, 쓰기 전에 견적을 받고 가격 보여 주기, 클립을 직접 본 뒤 판단하기, 그리고 도구와 함께 브라우저에서 yoh.app 페이지를 다뤄야 할 때를 알려 줍니다.
세 가지 작업 방식
도구와 브라우저 함께(에이전트가 실제 페이지에서 결과를 하나씩 확인), 브라우저만, 또는 스크립트·CI·에이전시를 위한 도구만.
항상 최신
파일은 yoh.app에서 제공되며 서버와 함께 업데이트됩니다. 직접 수정한 내용을 잃지 않고 설치본을 업데이트하려면 안내형 설정 페이지의 설정 프롬프트를 쓰세요.
승인 없이는 결제되지 않습니다
보기와 편집은 무료입니다. 크레딧이 드는 단계(그림 그리기, 클립 영상 생성, 렌더링)는 모두 먼저 가격을 알려 줍니다. 에이전트가 가격을 보여 주고 승인한 뒤에만 진행하며, 같은 승인으로 두 번 결제되지 않습니다.
자주 묻는 질문
SKILL.md란 무엇인가요?
스킬은 작업이 맞을 때 AI 에이전트가 불러오는 지침이 담긴 Markdown 파일입니다. Yoh 스킬은 공개 Agent Skills 형식을 쓰므로 Claude Code, Codex, Cursor 등 스킬을 읽는 에이전트에서 작동합니다.
MCP 서버가 있으면 스킬도 필요한가요?
선택이지만 권장합니다. 스킬이 없으면 에이전트는 도구만 봅니다. 스킬이 있으면 좋은 영상을 만드는 작업 흐름을 따르고 크레딧 낭비를 피합니다.
무료인가요?
네. 스킬은 무료로 내려받을 수 있고, 크레딧은 생성할 때만 쓰입니다.
다른 연결 방법
- Claude로 AI 영상 만들기Claude를 Yoh 계정에 연결하고 요청만으로 영상 스토리를 만드세요. Claude가 대본을 쓰고, 캐릭터를 일관되게 유지하고, 클립을 생성하고, 타임라인을 편집하고, 완성 영상을 렌더링합니다. 크레딧이 드는 작업은 먼저 확인을 받습니다.
- Codex로 AI 영상 만들기Codex를 Yoh에 연결하고 터미널이나 편집기에서 영상 스토리를 만들게 하세요. 대본, 캐스팅, 클립, 음성, 자막, 최종 렌더링까지 하며, 유료 단계마다 가격을 보여 주고 승인을 받습니다.
- AI 영상을 위한 Yoh MCP 서버원격 MCP 엔드포인트 하나로 어떤 에이전트든 Yoh 스튜디오 전체를 쓸 수 있습니다. 스토리를 쓰고, 캐릭터를 캐스팅해 그리고, 음성과 음악이 들어간 클립 영상을 생성하고, 타임라인과 자막을 편집하고, 렌더링해 게시합니다. 모든 도구는 yoh.app 편집기와 같은 규칙을 따릅니다.
- AI 영상 생성 API프롬프트를 보내면 완성 영상이 돌아옵니다. Yoh가 대본을 쓰고, 일관된 캐릭터를 캐스팅하고, 음성·음악·자막을 넣어 MP4로 렌더링합니다. 스토리, 시리즈, 클립, 캐릭터, 타임라인, 렌더링을 단계별로 직접 제어할 수도 있습니다.