/pika:explainer
Gere um vídeo explicativo de ~60–80s para uma URL: navegue por um navegador real através da URL seguindo um roteiro de batidas, gere um lipsync de avatar da narração e componha tudo em um frame macOS Sonoma 1280×800 com um avatar interno de 240 pixels (246 pixels externos, incluindo um anel de stroke branco de 3px) no canvas (20, 476) e zoom direcionado a elementos em cada batida do meio da seção. Funciona em qualquer URL — páginas de produto, sites de documentação, posts de blog, lançamentos. URLs do GitHub ativam um modo consciente de repositório (leitura de README + detecção de demonstração ao vivo); todas as outras URLs usam um fluxo genérico de demonstração de página.
Uso: /pika:explainer <url> [--focus "ângulos"] [--avatar <url>] [--voice <id>] [--lipsync-provider pika|kling] [--preview] [--live-url <url>]
Portão de transparência de custos
Antes de qualquer chamada MCP paga, chame identity_balance({verbose: true}) uma vez. Mostre o saldo atual, a taxa de consumo recente e o tempo restante, e então bloqueie a execução com esta mensagem exata:
Custo estimado: cerca de 50-500 créditos (~$0.50-$5.00) dependendo do provedor de lipsync, narração, legendas e modo de pré-visualização. Isso pode chegar a $5, então responda
proceedpara continuar oucancelpara parar.
Não chame nenhuma ferramenta MCP paga até que o usuário responda proceed. Se o usuário responder cancel, pare sem gerar nada. O portão é executado depois que a URL e as flags opcionais são conhecidas, antes da geração do avatar, fala, lipsync, legendas ou composição do vídeo.
Comportamento
Padrões — execute rápido, sem confirmação desnecessária no meio do fluxo
- Resolva avatar / voz silenciosamente. Nunca pergunte "devo usar seu avatar?" ou "qual voz?" antes de executar. Honre sobreposições explícitas (
--avatar,--voice) quando fornecidas; caso contrário, gere um avatar de apresentador e escolha uma voz padrão, e prossiga. Veja a Etapa 1 para a resolução completa. - Apenas o portão de transparência de custos pede
proceed. A pré-visualização da Etapa 5 é normalmente opt-in via--previewpara avatares explícitos, mas se torna pré-visualização automática obrigatória quando a fonte do avatar é um fallbackgeneratedouregenerated. Após o portão de custos, o fluxo é executado de ponta a ponta, exceto por essa salvaguarda de pré-visualização obrigatória para avatar fallback. - Também não solicite
--focus. Faça uma primeira tentativa confiável a partir da estrutura da página; os usuários executam novamente com--focus "X"se o ângulo falhou.
Esses padrões estão alinhados com o padrão da indústria para ferramentas de geração de mídia (Midjourney / Sora / Runway / HeyGen / Pika.art): enviar → renderizar → retornar. O saldo de crédito da conta + failover do provedor (Etapa 9) são as salvaguardas canônicas.
Imagens de avatar locais no Claude Desktop
O Claude Desktop ainda não pode passar imagens coladas embutidas para ferramentas MCP (limitação do lado da Anthropic). Se o usuário colar uma foto embutida, ou mencionar um arquivo local que deseja usar como --avatar, pause a Etapa 1 e envie gentilmente a ele algo como:
Atenção — imagens coladas não alcançam as ferramentas MCP no Claude Desktop ainda (limitação da Anthropic). Duas opções fáceis para seu avatar:
- Cole uma URL se ela já estiver hospedada (Imgur, S3, seu site) — mais rápido
- Anexe o arquivo de imagem para que eu possa enviá-lo antes da geração.
Quando um arquivo local chegar, converta-o em uma URL pública com upload_asset e use a public_url retornada como --avatar <url> antes da Etapa 1. URLs https://... já hospedadas funcionam como estão e ignoram isso completamente. Se nenhum avatar for fornecido, um retrato de apresentador é gerado silenciosamente (Etapa 1).
Etapa 0 — Resolver URL (menu de argumentos vazios)
Remova flags (--focus, --avatar, --voice, --live-url, --lipsync-provider, --no-captions, --preview, --skip-preview, --yes) e parâmetros chave=valor de $ARGUMENTS. Se o que restar não contiver uma URL https://... (ou estiver vazio / apenas espaços em branco), imprima este menu textualmente como sua resposta completa, então pare e aguarde a próxima mensagem do usuário. Chamar uma ferramenta aqui arrisca gravar ou explicar a página errada. Se $ARGUMENTS já contiver uma URL, pule esta etapa silenciosamente e prossiga para a Etapa 1.
Qual URL você gostaria que eu explicasse? Funciona em qualquer uma:
- Um repositório GitHub — por exemplo,
https://github.com/anthropics/claude-code(ativa o modo consciente de repositório: leitura de README + detecção de demonstração ao vivo)- Uma página de produto / página de lançamento — por exemplo,
https://pika.art- Um site de documentação — por exemplo,
https://docs.anthropic.com- Uma URL de post de blog / artigo
Saída: Frame macOS Sonoma 1280×800 com um lipsync de avatar no canto inferior esquerdo e zoom direcionado a elementos em cada batida do meio da seção. O fluxo padrão é executado de ponta a ponta após o portão de custos; passe
--previewse quiser uma verificação de sanidade de lipsync de 3 segundos para um avatar explícito. Avatares fallback gerados / regenerados executam automaticamente essa salvaguarda de pré-visualização.Responda com a URL e eu começarei.
Dica: você não precisa digitar
/pika:explainer— basta dizer coisas como "explique-me ", "faça um vídeo de demonstração de " ou "explique este repositório: " e eu executarei esta skill automaticamente.
Quando o usuário responder com uma URL, trate-a como a entrada resolvida e prossiga para a Etapa 1. Não pergunte novamente.
Etapa 1 — Analisar entrada + detectar modo
Obrigatório: url (deve ser https://...).
Opcional: --avatar <url> (a foto do apresentador; se omitida, uma é gerada), --voice <minimax-voice-id>, --focus "..." (orientação editorial tecida no vo_text), --live-url <url> (fornecer URL de demonstração ao vivo — apenas modo GitHub), --lipsync-provider <pika|kling> (padrão é pika — parrot a2v, ~2-5 min de relógio, movimento de cabeça ligeiramente mais dramático. Passe kling para uma saída mais focada no rosto com ~5-30 min de relógio — Kling produz takes de apresentador com movimento mínimo de cabeça, mas é o estágio mais demorado; reserve para renderizações de alto risco), --no-captions (pular a queima de legendas da Etapa 11 — o padrão é legendas ativadas), --preview (opt-in para o portão de pré-visualização da Etapa 5 para avatares explícitos; avatares fallback gerados e regenerados executam automaticamente o portão de pré-visualização antes do lipsync completo). --skip-preview e --yes são aceitos como no-ops para compatibilidade reversa.
Detecção de modo:
- Modo GitHub — O host da URL é
github.comE o caminho corresponde a/{owner}/{repo}(nenhum segmento de caminho adicional além da raiz do repositório). Ativa os extras conscientes de repositório: leitura de README, detecção de demonstração ao vivo, seletores específicos do GitHub. - Modo URL genérica — qualquer outra coisa (uma página de produto, site de documentação, post de blog, caminho GitHub mais profundo como
/blob/HEAD/path). Pula os extras do GitHub; usa seletores CSS genéricos e percorre a própria URL.
Resolução de avatar (silenciosa — nunca pergunte ao usuário):
- Se
--avatar <url>foi passado, use-o. - Caso contrário, chame
generate_imageuma vez com o prompt"professional presenter, friendly tech narrator, studio portrait, 1:1, natural lighting"e use a URL retornada. Não pergunte ao usuário "devo gerar um?" — apenas gere silenciosamente.
Rastreie avatar_source como um de explicit, generated ou regenerated.
Portão de adequação do avatar (obrigatório antes de qualquer gasto com lipsync):
Chame analyze_media(media=<avatar>, query=<gate_query>) uma vez na imagem de avatar resolvida antes da Etapa 4 TTS e antes de qualquer chamada generate_lipsync de pré-visualização/completa. Este é o único caso em que a análise de avatar é necessária, porque o avatar é o ativo central do apresentador e um avatar gerado ruim pode queimar toda a renderização.
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.
Passe apenas se is_single_front_facing_coherent_human_face == true, has_visible_mouth == true, is_faceless_or_masked == false, is_mascot_illustration_or_non_human == false e face_suitability_score >= 75.
Se o avatar falhar e avatar_source for explicit, pare antes do lipsync pago e peça --avatar <real-looking-photo-url> ou permissão para gerar um retrato de apresentador. Se o avatar falhar e avatar_source for generated, chame generate_image uma vez com o prompt "realistic professional presenter portrait, single front-facing coherent human face, visible mouth, friendly tech narrator, neutral studio background, 1:1, natural lighting"; defina avatar_source = "regenerated" e reexecute este portão de adequação no avatar regenerado. Se o avatar regenerado também falhar, abortar com um erro claro em vez de tentar o lipsync.
Defina avatar_auto_preview_required = true sempre que avatar_source for generated ou regenerated; caso contrário, false, a menos que o usuário tenha passado --preview.
Resolução de voz (silenciosa — nunca pergunte ao usuário):
-
Se
--voice <id>foi passado, use-o. -
Caso contrário, escolha um preset casual MiniMax
speech-2.8-hdcorrespondendo ao gênero aparente do avatar resolvido:- Avatar codificado como feminino →
English_PlayfulGirl(quente, casual, claramente com voz feminina — verificado) - Avatar codificado como masculino →
English_Jovialman(quente, masculino casual) - Incerto / neutro em gênero →
English_Jovialman(padrão)
Infira o gênero a partir do resultado do portão de adequação do avatar (
apparent_gender). Não pergunte ao usuário.NÃO use
English_FriendlyPerson— apesar de ser categorizado sob "feminino" no catálogo da MiniMax, seu nome de exibição é "Friendly Guy" e soa como masculino na reprodução.English_PlayfulGirlé a escolha casual-feminina canônica. Outras alternativas femininas verificadas:English_Upbeat_Woman,English_LovelyGirl,English_radiant_girl. - Avatar codificado como feminino →
O fluxo abaixo é anotado por etapa: Apenas GitHub, Apenas Genérico ou Ambos modos.
Etapa 2 — Ler fonte (sem chamada MCP)
Ambos os modos: use o WebFetch do Claude na URL de entrada para obter o conteúdo principal da página (h1, seção de herói, cabeçalhos, texto principal).
Construa proper_noun_glossary durante esta leitura da fonte. Inclua grafias canônicas de produto, repositório, empresa, modelo, framework e substantivos próprios da URL/domínio, título da página, h1, cabeçalhos do README, metadados do repositório, nomes de pacotes e tokens capitalizados repetidos. Para repositórios GitHub, preserve as grafias exatas encontradas pela leitura do README/fonte, por exemplo, Ollama, Llama, DeepSeek, Gemma. Use este glossário mais tarde ao redigir a narração e ao queimar legendas manuais para que o texto da legenda não se desvie foneticamente para erros de ortografia como "Olama" ou "DeepSeq".
Adições do modo GitHub: também busque a árvore de arquivos do nível superior, (melhor esforço) package.json / pyproject.toml e metadados do repositório da API GitHub via gh api repos/{owner}/{repo} para homepage, description, language, topics. Detecte um live_url candidato nesta prioridade:
--live-urlfornecido pelo usuário.- Campo
meta.homepageda API GitHub — definido quando o mantenedor configurou a homepage do repositório nas configurações do GitHub. - Campo
"homepage"dopackage.json. - Primeira correspondência no README de
https?://[^\s)\"'<>]+(?:vercel\.app|netlify\.app|github\.io|fly\.dev|railway\.app|render\.com|herokuapp\.com|surge\.sh)[^\s)\"'<>]*. - Qualquer outra URL no README para a qual o texto da área de emblemas / "Demonstração ao Vivo" / "Página do Projeto" / "Demo" aponte. A regex da lista de permissões acima perde domínios personalizados arbitrários (por exemplo,
<project>-project-page.com); quando o README designa explicitamente uma página de projeto, prefira isso ao fallback do github.io. - Convenção do GitHub Pages
https://{owner}.github.io/{repo}— mas apenas se a árvore profunda contiver um sinal de frontend (um deindex.html,App.tsx,App.jsx,App.vue,app.py,main.py).
Se nenhum candidato for resolvido, o roteiro de batidas pula as batidas 6–7.
Modo URL genérica: a própria URL de entrada é a única URL que as batidas percorrem — nenhuma inferência de live_url, nenhuma busca de metadados extras. Pule a Etapa 2.5 e a Etapa 3.0; vá direto para a Etapa 3.
Etapa 2.5 — Verificar acessibilidade de live_url (apenas modo GitHub, sem chamada MCP)
Se um live_url candidato foi selecionado, verifique se ele fornece conteúdo real antes de redigir as batidas 6–7. Use WebFetch no candidato e verifique a resposta:
- Se o status da resposta for 4xx / 5xx, defina
live_urlcomo None e pule as batidas 6–7. O fallback do github.io em particular é acessível como nome de host, mas frequentemente retorna 404 ("There isn't a GitHub Pages site here") para repositórios que não ativaram o Pages — gravar essa página 404 desperdiça ~12s do explicador em conteúdo errado. - Se a resposta renderizar o template do GitHub Pages "404 — There isn't a GitHub Pages site here." (heurística: o corpo da resposta contém
"There isn't a GitHub Pages site here"), descartelive_urle pule as batidas 6–7. - Caso contrário, mantenha
live_urlpara as batidas 6–7.
Isso espelha o portão de acessibilidade legado que verificava live_url com um tempo limite curto e seguia redirecionamentos.
Etapa 2.6 — Pré-verificação de URL genérica (apenas modo URL genérica, sem chamada MCP)
Antes de redigir batidas para uma URL não-GitHub, use WebFetch na URL de entrada e inspecione a resposta. Esta etapa evita três modos de falha comuns de URL genérica: (a) gravar uma página de captcha / bloqueio de bot em vez de conteúdo, (b) o banner de cookie/consentimento ocupando os primeiros ~3 segundos do vídeo, (c) seletores CSS genéricos perdendo o herói / seções reais da página.
A. Detecção de bloqueio de bot / captcha — abortar se corresponder:
Se o corpo da resposta contiver qualquer um de:
"Verify you are human"/"verify you are not a robot""captcha"/"CAPTCHA"/"reCAPTCHA""403 Forbidden"/"Access Denied""Just a moment"+cf-chl-bypass(desafio Cloudflare)"We're sorry, something went wrong"(bloqueio de bot estilo Amazon)- Um
<title>ou h1 de apenas "Robot Check" / "Are you a robot?"
→ ABORTE com um erro claro para o usuário: "O modo de URL genérica não pode renderizar este site — a página está mostrando um desafio de detecção de bot / captcha sob Chrome headless. Tente uma URL diferente ou execute uma versão de usuário real da página primeiro para verificar se ela carrega corretamente."
B. Detecção de banner de cookie / consentimento — desativar com extra_css + clique opcional:
Varra a resposta em busca desses padrões (insensível a maiúsculas/minúsculas):
- IDs / classes começando com
onetrust-, `tru