/pika:explainer
약 60~80초 분량의 URL 설명 동영상을 생성합니다: 비트 시트 타임라인에 따라 실제 브라우저를 URL로 구동하고, 내레이션에 맞춘 아바타 립싱크를 생성한 다음, 이를 1280×800 macOS Sonoma 프레임(240픽셀 내부 아바타, 3px 흰색 테두리 포함 246픽셀 외부) 캔버스 위치 (20, 476)에 합성하고 중간 섹션 비트마다 요소별 확대/축소를 적용합니다. 모든 URL(제품 페이지, 문서 사이트, 블로그 게시물, 출시 페이지)에서 작동합니다. GitHub URL은 저장소 인식 모드(README 스캔 + 라이브 데모 탐지)를 활성화하고, 그 외 모든 URL은 일반 페이지 탐색 흐름을 사용합니다.
사용법: /pika:explainer <url> [--focus "앵글"] [--avatar <url>] [--voice <id>] [--lipsync-provider pika|kling] [--preview] [--live-url <url>]
비용 투명성 게이트
유료 MCP 호출 전에 identity_balance({verbose: true})를 한 번 호출합니다. 현재 잔액, 최근 사용 속도, 남은 실행 가능 기간을 표시하고 다음 정확한 메시지로 실행을 제어합니다:
예상 비용: 립싱크 제공자, 내레이션, 자막, 미리보기 모드에 따라 약 50-500 크레딧 (~$0.50-$5.00)입니다. 최대 $5까지 도달할 수 있으니, 계속하려면
proceed를, 중단하려면cancel을 답장해 주세요.
사용자가 proceed라고 답장할 때까지 유료 MCP 도구를 호출하지 마십시오. 사용자가 cancel이라고 답장하면 생성하지 않고 중단합니다. 게이트는 URL과 선택적 플래그가 확인된 후, 아바타 생성, 음성, 립싱크, 자막 또는 비디오 합성 전에 실행됩니다.
동작 방식
기본값 — 불필요한 중간 확인 없이 신속하게 실행
- 아바타 / 음성을 자동으로 결정합니다. 실행 전에 "제 아바타를 사용할까요?" 또는 "어떤 음성을 사용할까요?"라고 묻지 않습니다.
--avatar,--voice가 제공되면 명시적 값을 사용하고, 그렇지 않으면 프레젠터 아바타를 생성하고 기본 음성을 선택한 후 진행합니다. 전체 해결 과정은 1단계를 참조하세요. - 비용 투명성 게이트만
proceed를 요청합니다. 5단계 미리보기는 명시적 아바타의 경우 일반적으로--preview를 통해 선택하지만, 아바타 소스가generated또는regenerated폴백인 경우 필수 자동 미리보기가 됩니다. 비용 게이트 이후에는 해당 필수 폴백 아바타 미리보기 안전장치를 제외하고 전체 흐름이 종단간 실행됩니다. --focus에 대해서도 묻지 않습니다. 페이지 구조를 기반으로 자신있게 첫 번째 시도를 하고, 각도가 맞지 않으면 사용자가--focus "X"로 재실행합니다.
이러한 기본값은 미디어 생성 도구(Midjourney / Sora / Runway / HeyGen / Pika.art)의 업계 표준과 일치합니다: 제출 → 렌더링 → 반환. 계정 크레딧 잔액 + 제공자 장애 조치(9단계)가 표준 안전장치입니다.
Claude Desktop의 로컬 아바타 이미지
Claude Desktop은 아직 MCP 도구에 인라인 붙여넣기 이미지를 전달할 수 없습니다(Anthropic 측 제한). 사용자가 사진을 인라인으로 붙여넣거나 --avatar로 사용할 로컬 파일을 언급하면, 1단계를 일시 중지하고 친절하게 다음 메시지를 보내세요:
참고 — Claude Desktop에서는 붙여넣은 이미지가 MCP 도구에 도달하지 않습니다(Anthropic 제한 사항). 아바타에 대한 두 가지 쉬운 옵션이 있습니다:
- URL을 붙여넣으세요 이미지가 이미 호스팅된 경우(Imgur, S3, 귀하의 사이트) — 가장 빠름
- 이미지 파일을 첨부하여 생성 전에 업로드할 수 있습니다.
로컬 파일이 도착하면 upload_asset으로 변환하여 공개 URL로 만들고 반환된 public_url을 --avatar <url>로 사용하여 1단계 전에 진행합니다. 이미 호스팅된 https://... URL은 그대로 작동하며 이 단계를 완전히 건너뜁니다. 아바타가 전혀 제공되지 않으면 프레젠터 초상화가 자동으로 생성됩니다(1단계).
0단계 — URL 확인 (인수 없음 메뉴)
$ARGUMENTS에서 플래그(--focus, --avatar, --voice, --live-url, --lipsync-provider, --no-captions, --preview, --skip-preview, --yes) 및 key=value 매개변수를 제거합니다. 남은 내용에 https://... URL이 포함되어 있지 않으면(또는 비어 있거나 공백만 있는 경우) 다음 메뉴를 그대로 전체 응답으로 출력한 다음 중단하고 사용자의 다음 메시지를 기다립니다. 여기서 도구를 호출하면 잘못된 페이지를 녹화하거나 설명할 위험이 있습니다. $ARGUMENTS에 이미 URL이 있으면 이 단계를 자동으로 건너뛰고 1단계로 진행합니다.
어떤 URL을 설명해 드릴까요? 다음 중 하나에서 작동합니다:
- GitHub 저장소 — 예:
https://github.com/anthropics/claude-code(저장소 인식 모드 활성화: README 스캔 + 라이브 데모 탐지)- 제품 페이지 / 출시 페이지 — 예:
https://pika.art- 문서 사이트 — 예:
https://docs.anthropic.com- 블로그 게시물 / 기사 URL
출력: 1280×800 macOS Sonoma 프레임, 하단 왼쪽 아바타 립싱크, 중간 섹션 비트마다 요소별 확대/축소. 비용 게이트 이후 기본 흐름이 종단간 실행됩니다. 명시적 아바타에 대한 3초 립싱크 확인을 원하면
--preview를 전달하세요. 생성/재생성된 폴백 아바타는 해당 미리보기 안전장치를 자동 실행합니다.URL을 답장해 주시면 시작하겠습니다.
팁:
/pika:explainer를 입력할 필요 없이 — "을 설명해줘", "의 데모 동영상을 만들어줘", "이 저장소를 설명해줘: "와 같이 말하면 이 스킬이 자동으로 실행됩니다.
사용자가 URL로 답장하면 이를 확인된 입력으로 처리하고 1단계로 진행합니다. 다시 묻지 마세요.
1단계 — 입력 구문 분석 + 모드 감지
필수: url (https://... 형식이어야 함).
선택 사항: --avatar <url> (프레젠터 사진, 생략 시 자동 생성), --voice <minimax-voice-id>, --focus "..." (vo_text에 반영될 편집 가이드), --live-url <url> (라이브 데모 URL 강제 제공 — GitHub 모드 전용), --lipsync-provider <pika|kling> (기본값 pika — parrot a2v, 약 2-5분 실제 시간, 약간 더 극적인 머리 움직임. 얼굴 중심 출력이 필요한 경우 kling 전달, 약 5-30분 실제 시간 소요 — Kling은 머리 움직임이 최소인 프레젠터 샷을 생성하지만 가장 오래 걸리는 단계이므로 중요한 렌더링에 사용), --no-captions (11단계 자막 삽입 건너뛰기 — 기본값은 자막 켜짐), --preview (명시적 아바타에 대한 5단계 미리보기 게이트 선택; 생성 및 재생성된 폴백 아바타는 전체 립싱크 전에 미리보기 게이트를 자동 실행). --skip-preview 및 --yes는 하위 호환성을 위해 허용되지만 아무 작업도 수행하지 않습니다.
모드 감지:
- GitHub 모드 — URL 호스트가
github.com이고 경로가/{owner}/{repo}와 일치함 (저장소 루트 이후 추가 경로 세그먼트 없음). 저장소 인식 추가 기능 활성화: README 스캔, 라이브 데모 탐지, GitHub 특정 선택자. - 일반 URL 모드 — 그 외 모든 경우 (제품 페이지, 문서 사이트, 블로그 게시물,
/blob/HEAD/path와 같은 더 깊은 GitHub 경로). GitHub 추가 기능을 건너뛰고 일반 CSS 선택자를 사용하며 URL 자체를 탐색합니다.
아바타 결정 (자동 — 사용자에게 묻지 않음):
--avatar <url>이 전달되면 이를 사용합니다.- 그렇지 않으면
generate_image를 한 번 호출하여 프롬프트"전문 프레젠터, 친근한 기술 내레이터, 스튜디오 초상화, 1:1, 자연광"으로 생성하고 반환된 URL을 사용합니다. 사용자에게 "하나 생성할까요?"라고 묻지 않습니다 — 자동으로 생성합니다.
avatar_source를 explicit, generated 또는 regenerated 중 하나로 추적합니다.
아바타 적합성 게이트 (립싱크 비용 발생 전 필수):
4단계 TTS 및 모든 generate_lipsync 미리보기/전체 호출 전에 확인된 아바타 이미지에 대해 analyze_media(media=<avatar>, query=<gate_query>)를 한 번 호출합니다. 아바타 분석이 필요한 유일한 경우입니다. 아바타는 중앙 프레젠터 자산이며 잘못 생성된 아바타는 전체 렌더링을 망칠 수 있기 때문입니다.
게이트 쿼리:
Return JSON only: {
"is_single_front_facing_coherent_human_face": boolean,
"has_visible_mouth": boolean,
"is_faceless_or_masked": boolean,
"is_mascot_illustration_or_non_human": boolean,
"face_suitability_score": 0-100,
"apparent_gender": "female" | "male" | "unclear",
"reason": string
}
Is this image suitable for talking-head lipsync: a single front-facing coherent human face with a visible mouth? Flag faceless, masked, mascot, illustration-only, non-human, or distorted avatars.
is_single_front_facing_coherent_human_face == true, has_visible_mouth == true, is_faceless_or_masked == false, is_mascot_illustration_or_non_human == false, face_suitability_score >= 75인 경우에만 통과합니다.
아바타가 실패하고 avatar_source가 explicit이면 유료 립싱크 전에 중단하고 --avatar <실제-처럼-보이는-사진-url> 또는 프레젠터 초상화 생성을 위한 권한을 요청합니다. 아바타가 실패하고 avatar_source가 generated이면 generate_image를 한 번 호출하여 프롬프트 "realistic professional presenter portrait, single front-facing coherent human face, visible mouth, friendly tech narrator, neutral studio background, 1:1, natural lighting"로 생성합니다. avatar_source = "regenerated"로 설정하고 재생성된 아바타에 대해 이 적합성 게이트를 다시 실행합니다. 재생성된 아바타도 실패하면 립싱크를 시도하지 않고 명확한 오류와 함께 중단합니다.
avatar_source가 generated 또는 regenerated일 때마다 avatar_auto_preview_required = true로 설정합니다. 그렇지 않으면 사용자가 --preview를 전달하지 않는 한 false입니다.
음성 결정 (자동 — 사용자에게 묻지 않음):
-
--voice <id>가 전달되면 이를 사용합니다. -
그렇지 않으면 결정된 아바타의 인식된 성별과 일치하는 캐주얼 MiniMax
speech-2.8-hd프리셋을 선택합니다:- 여성 코딩 아바타 →
English_PlayfulGirl(따뜻하고 캐주얼하며 명확히 여성 음성 — 확인됨) - 남성 코딩 아바타 →
English_Jovialman(따뜻하고 캐주얼한 남성) - 불명확 / 성별 중립 →
English_Jovialman(기본값)
아바타 적합성 게이트 결과(
apparent_gender)에서 성별을 유추합니다. 사용자에게 묻지 않습니다.English_FriendlyPerson을 사용하지 마십시오 — MiniMax 카탈로그에서 "여성"으로 분류되었지만 표시 이름이 "Friendly Guy"이고 재생 시 남성으로 읽힙니다.English_PlayfulGirl이 표준 캐주얼 여성 선택입니다. 확인된 다른 여성 대안:English_Upbeat_Woman,English_LovelyGirl,English_radiant_girl. - 여성 코딩 아바타 →
아래 흐름은 각 단계별로 GitHub 전용, 일반 전용 또는 두 모드 모두로 주석 처리되어 있습니다.
2단계 — 소스 읽기 (MCP 호출 없음)
두 모드 모두: Claude의 WebFetch를 입력 URL에 사용하여 페이지의 주요 콘텐츠(h1, 히어로 섹션, 제목, 주요 카피)를 가져옵니다.
이 소스 읽기 중에 proper_noun_glossary를 구축합니다. URL/도메인, 페이지 제목, h1, README 제목, 저장소 메타데이터, 패키지 이름 및 반복되는 대문자 토큰에서 제품, 저장소, 회사, 모델, 프레임워크 및 고유 명사의 표준 철자를 포함하세요. GitHub 저장소의 경우 README/소스 스캔에서 표면화된 정확한 철자를 유지하세요(예: Ollama, Llama, DeepSeek, Gemma). 이 용어집을 나중에 내레이션 작성 및 수동 자막 삽입 시 사용하여 자막 텍스트가 "Olama" 또는 "DeepSeq"와 같은 철자 오류로 음성적으로 표류하지 않도록 합니다.
GitHub 모드 추가 사항: 또한 최상위 파일 트리, (최선 노력) package.json / pyproject.toml, GitHub API 저장소 메타데이터를 gh api repos/{owner}/{repo}를 통해 가져와 homepage, description, language, topics를 확인합니다. 다음 우선순위로 후보 live_url을 감지합니다:
- 사용자가 제공한
--live-url. - GitHub API
meta.homepage필드 — 유지 관리자가 GitHub 설정에서 저장소의 홈페이지를 구성한 경우 설정됩니다. package.json의"homepage"필드.- README에서
https?://[^\s)\"'<>]+(?:vercel\.app|netlify\.app|github\.io|fly\.dev|railway\.app|render\.com|herokuapp\.com|surge\.sh)[^\s)\"'<>]*의 첫 번째 일치 항목. - README에서 배지 영역 / "라이브 데모" / "프로젝트 페이지" / "데모" 텍스트가 가리키는 다른 모든 URL. 위의 허용 목록 정규식은 사용자 정의 도메인(예:
<project>-project-page.com)을 놓칩니다. README가 프로젝트 페이지를 명시적으로 지정하는 경우 github.io 폴백보다 우선합니다. - GitHub Pages 규칙
https://{owner}.github.io/{repo}— 그러나 깊은 트리에 프론트엔드 신호(index.html,App.tsx,App.jsx,App.vue,app.py,main.py중 하나)가 포함된 경우에만 사용합니다.
후보가 확인되지 않으면 비트 시트에서 비트 6-7을 건너뜁니다.
일반 URL 모드: 입력 URL 자체가 비트가 탐색하는 유일한 URL입니다. live_url 추론 없음, 추가 메타데이터 가져오기 없음. 2.5단계와 3.0단계를 건너뛰고 직접 3단계로 이동합니다.
2.5단계 — live_url 접근 가능성 확인 (GitHub 모드 전용, MCP 호출 없음)
후보 live_url이 선택된 경우, 비트 6-7을 작성하기 전에 실제 콘텐츠를 제공하는지 확인합니다. 후보에 WebFetch를 사용하고 응답을 확인합니다:
- 응답 상태가 4xx / 5xx이면
live_url을 None으로 설정하고 비트 6-7을 건너뜁니다. 특히 github.io 폴백은 호스트 이름으로는 접근 가능하지만 Pages를 활성화하지 않은 저장소의 경우 자주 404를 반환합니다("There isn't a GitHub Pages site here") — 해당 404 페이지를 녹화하면 설명 동영상의 약 12초를 잘못된 콘텐츠로 낭비하게 됩니다. - 응답이 GitHub Pages "404 — There isn't a GitHub Pages site here." 템플릿을 렌더링하는 경우(휴리스틱: 응답 본문에
"There isn't a GitHub Pages site here"포함),live_url을 삭제하고 비트 6-7을 건너뜁니다. - 그렇지 않으면 비트 6-7을 위해
live_url을 유지합니다.
이는 짧은 시간 초과로 live_url을 확인하고 리디렉션을 따르던 레거시 접근 가능성 게이트를 반영합니다.
2.6단계 — 일반 URL 사전 점검 (일반 URL 모드 전용, MCP 호출 없음)
비 GitHub URL에 대한 비트를 작성하기 전에 입력 URL을 WebFetch하고 응답을 검사합니다. 이 단계는 세 가지 일반적인 일반 URL 실패 모드를 방지합니다: (a) 콘텐츠 대신 캡차/봇 차단 페이지 녹화, (b) 쿠키/동의 배너가 비디오의 처음 ~3초를 차지, (c) 일반 CSS 선택자가 페이지의 실제 히어로/섹션을 놓칩니다.
A. 봇 차단 / 캡차 감지 — 일치 시 중단:
응답 본문에 다음 중 하나가 포함된 경우:
"Verify you are human"/"verify you are not a robot""captcha"/"CAPTCHA"/"reCAPTCHA""403 Forbidden"/"Access Denied""Just a moment"+cf-chl-bypass(Cloudflare 챌린지)"We're sorry, something went wrong"(Amazon 스타일 봇 차단)<title>또는 h1이 단순히 "Robot Check" / "Are you a robot?"인 경우
→ 중단하고 사용자에게 명확한 오류 메시지를 표시합니다: "일반 URL 모드가 이 사이트를 렌더링할 수 없습니다 — 페이지가 헤드리스 Chrome에서 봇 감지/캡차 챌린지를 보여주고 있습니다. 다른 URL을 시도하거나 페이지의 실제 사용자 버전을 먼저 실행하여 깨끗하게 로드되는지 확인하세요."
B. 쿠키 / 동의 배너 감지 — extra_css + 선택적 클릭으로 무력화:
다음 패턴에 대해 응답을 스캔합니다(대소문자 구분 없음):
onetrust-,truste-로 시작하는 ID / 클래스