/pika:explainer
Genera un video explicativo de una URL de ~60-80 segundos: navega un navegador real por la URL siguiendo una línea de tiempo de ritmos, genera una sincronización de labios del avatar de la narración y lo compone todo en un marco de macOS Sonoma de 1280×800 con un avatar interior de 240 píxeles (246 píxeles exterior incluyendo un anillo de trazo blanco de 3px) en el lienzo (20, 476) y un zoom dirigido a elementos en cada ritmo de la sección media. Funciona en cualquier URL: páginas de producto, sitios de documentación, publicaciones de blog, lanzamientos. Las URLs de GitHub activan un modo consciente del repositorio (escaneo de README + detección de demo en vivo); todas las demás URLs utilizan un flujo genérico de recorrido de página.
Uso: /pika:explainer <url> [--focus "ángulos"] [--avatar <url>] [--voice <id>] [--lipsync-provider pika|kling] [--preview] [--live-url <url>]
Compuerta de transparencia de costos
Antes de cualquier llamada MCP paga, llama a identity_balance({verbose: true}) una vez. Muestra el saldo actual, la tasa de quema reciente y el tiempo restante, luego bloquea la ejecución con este mensaje exacto:
Costo estimado: alrededor de 50-500 créditos (~$0.50-$5.00) dependiendo del proveedor de sincronización de labios, narración, subtítulos y modo de vista previa. Esto puede llegar a $5, así que responde
proceedpara continuar ocancelpara detenerte.
No llames a ninguna herramienta MCP paga hasta que el usuario responda proceed. Si el usuario responde cancel, detente sin generar nada. La compuerta se ejecuta después de que la URL y las banderas opcionales sean conocidas, antes de la generación del avatar, voz, sincronización de labios, subtítulos o composición de video.
Comportamiento
Valores predeterminados: dispara rápido, sin confirmación innecesaria en medio del flujo
- Resuelve avatar / voz en silencio. Nunca preguntes "¿debería usar tu avatar?" o "¿qué voz?" antes de disparar. Respeta las modificaciones explícitas (
--avatar,--voice) cuando se proporcionen; de lo contrario, genera un avatar presentador y elige una voz predeterminada, y continúa. Consulta el Paso 1 para la cascada de resolución completa. - Solo la compuerta de transparencia de costos pide
proceed. La vista previa del Paso 5 es normalmente opt-in mediante--previewpara avatares explícitos, pero se convierte en una vista previa automática obligatoria cuando la fuente del avatar es un respaldogeneratedoregenerated. Después de la compuerta de costos, el flujo se ejecuta de principio a fin, excepto por esa barrera de seguridad de vista previa obligatoria para avatares de respaldo. - No solicites
--focustampoco. Haz un primer intento confiado a partir de la estructura de la página; los usuarios vuelven a ejecutar con--focus "X"si el ángulo falló.
Estos valores predeterminados coinciden con el estándar de la industria para herramientas de generación de medios (Midjourney / Sora / Runway / HeyGen / Pika.art): enviar → renderizar → devolver. El saldo de créditos de la cuenta + la conmutación por error del proveedor (Paso 9) son las barreras de seguridad canónicas.
Imágenes de avatar locales en Claude Desktop
Claude Desktop aún no puede pasar imágenes pegadas en línea a las herramientas MCP (limitación del lado de Anthropic). Si el usuario pega una foto en línea o menciona un archivo local que quiera usar como --avatar, pausa el Paso 1 y envíale amablemente esto, algo como:
Aviso: las imágenes pegadas no llegan a las herramientas MCP en Claude Desktop todavía (limitación de Anthropic). Dos opciones fáciles para tu avatar:
- Pega una URL si ya está alojada (Imgur, S3, tu sitio) — la más rápida
- Adjunta el archivo de imagen para que pueda subirlo antes de la generación.
Cuando llegue un archivo local, conviértelo a una URL pública con upload_asset y usa la public_url devuelta como --avatar <url> antes del Paso 1. Las URLs https://... ya alojadas funcionan tal cual y omiten esto por completo. Si no se proporciona ningún avatar, se genera un retrato de presentador en silencio (Paso 1).
Paso 0 — Resolver URL (menú de argumentos vacíos)
Elimina las banderas (--focus, --avatar, --voice, --live-url, --lipsync-provider, --no-captions, --preview, --skip-preview, --yes) y los parámetros clave=valor de $ARGUMENTS. Si lo que queda no contiene una URL https://... (o está vacío / solo espacios en blanco), imprime este menú textualmente como tu respuesta completa, luego detente y espera el siguiente mensaje del usuario. Llamar a una herramienta aquí corre el riesgo de grabar o explicar la página incorrecta. Si $ARGUMENTS ya contiene una URL, omite este paso en silencio y continúa con el Paso 1.
¿Qué URL te gustaría que recorra? Funciona en cualquiera de:
- Un repositorio de GitHub — p. ej.
https://github.com/anthropics/claude-code(activa el modo consciente del repositorio: escaneo de README + detección de demo en vivo)- Una página de producto / página de lanzamiento — p. ej.
https://pika.art- Un sitio de documentación — p. ej.
https://docs.anthropic.com- Una publicación de blog / URL de artículo
Salida: marco de macOS Sonoma de 1280×800 con un avatar de sincronización de labios en la parte inferior izquierda y zoom dirigido a elementos en cada ritmo de la sección media. El flujo predeterminado se ejecuta de principio a fin después de la compuerta de costos; pasa
--previewsi quieres una verificación de cordura de sincronización de labios de 3 segundos para un avatar explícito. Los avatares de respaldo generados / regenerados ejecutan automáticamente esa barrera de seguridad de vista previa.Responde con la URL y empezaré.
Consejo: no necesitas escribir
/pika:explainer— solo di cosas como "recórreme ", "haz un video demo de " o "explica este repositorio: " y activaré este skill automáticamente.
Cuando el usuario responda con una URL, trátala como la entrada resuelta y continúa con el Paso 1. No vuelvas a preguntar.
Paso 1 — Analizar entrada + detectar modo
Requerido: url (debe ser https://...).
Opcional: --avatar <url> (la foto del presentador; si se omite, se genera una), --voice <minimax-voice-id>, --focus "..." (guía editorial entretejida en vo_text), --live-url <url> (forzar suministro de URL de demo en vivo — solo modo GitHub), --lipsync-provider <pika|kling> (predeterminado a pika — loro a2v, ~2-5 min de tiempo real, movimiento de cabeza ligeramente más dramático. Pasa kling para una salida más ajustada centrada en la cara a ~5-30 min de tiempo real — Kling produce tomas de presentador con movimiento mínimo de cabeza pero es la etapa de cuello de botella; resérvalo para renderizados de alto riesgo), --no-captions (omitir la quema de subtítulos del Paso 11 — el valor predeterminado es subtítulos activados), --preview (opt-in a la compuerta de vista previa del Paso 5 para avatares explícitos; los avatares de respaldo generados y regenerados ejecutan automáticamente la compuerta de vista previa antes de la sincronización de labios completa). --skip-preview y --yes se aceptan como no operativos para compatibilidad hacia atrás.
Detección de modo:
- Modo GitHub — el host de la URL es
github.comY la ruta coincide con/{owner}/{repo}(sin segmentos de ruta adicionales más allá de la raíz del repositorio). Activa los extras conscientes del repositorio: escaneo de README, detección de demo en vivo, selectores específicos de GitHub. - Modo URL genérica — cualquier otra cosa (una página de producto, sitio de documentación, publicación de blog, ruta más profunda de GitHub como
/blob/HEAD/path). Omite los extras de GitHub; usa selectores CSS genéricos y recorre la propia URL.
Resolución de avatar (en silencio — nunca preguntes al usuario):
- Si se pasó
--avatar <url>, úsala. - De lo contrario, llama a
generate_imageuna vez con el prompt"presentador profesional, narrador técnico amigable, retrato de estudio, 1:1, iluminación natural"y usa la URL devuelta. No preguntes al usuario "¿debería generar una?" — solo genera en silencio.
Rastrea avatar_source como uno de explicit, generated o regenerated.
Compuerta de idoneidad del avatar (obligatoria antes de cualquier gasto de sincronización de labios):
Llama a analyze_media(media=<avatar>, query=<gate_query>) una vez en la imagen de avatar resuelta antes del Paso 4 TTS y antes de cualquier llamada generate_lipsync de vista previa/completa. Este es el único caso en el que se requiere un análisis de avatar, porque el avatar es el activo central del presentador y un avatar generado malo puede arruinar todo el renderizado.
Consulta de compuerta:
Devuelve JSON solo: {
"is_single_front_facing_coherent_human_face": booleano,
"has_visible_mouth": booleano,
"is_faceless_or_masked": booleano,
"is_mascot_illustration_or_non_human": booleano,
"face_suitability_score": 0-100,
"apparent_gender": "female" | "male" | "unclear",
"reason": cadena
}
¿Es esta imagen adecuada para la sincronización de labios de cabeza parlante: un solo rostro humano coherente y frontal con una boca visible? Marca avatares sin rostro, enmascarados, de mascota, solo ilustración, no humanos o distorsionados.
Pasa solo si is_single_front_facing_coherent_human_face == true, has_visible_mouth == true, is_faceless_or_masked == false, is_mascot_illustration_or_non_human == false y face_suitability_score >= 75.
Si el avatar falla y avatar_source es explicit, detente antes de la sincronización de labios paga y pide --avatar <real-looking-photo-url> o permiso para generar un retrato de presentador. Si el avatar falla y avatar_source es generated, llama a generate_image una vez con el prompt "retrato de presentador profesional realista, un solo rostro humano coherente y frontal, boca visible, narrador técnico amigable, fondo de estudio neutro, 1:1, iluminación natural"; establece avatar_source = "regenerated" y vuelve a ejecutar esta compuerta de idoneidad en el avatar regenerado. Si el avatar regenerado también falla, aborta con un error claro en lugar de intentar la sincronización de labios.
Establece avatar_auto_preview_required = true siempre que avatar_source sea generated o regenerated; de lo contrario, falso a menos que el usuario haya pasado --preview.
Resolución de voz (en silencio — nunca preguntes al usuario):
-
Si se pasó
--voice <id>, úsala. -
De lo contrario, elige un preset casual de MiniMax
speech-2.8-hdque coincida con el género aparente del avatar resuelto:- Avatar de género femenino →
English_PlayfulGirl(cálida, casual, claramente con voz femenina — verificado) - Avatar de género masculino →
English_Jovialman(cálido, casual, masculino) - No claro / género neutro →
English_Jovialman(predeterminado)
Infiere el género del resultado de la compuerta de idoneidad del avatar (
apparent_gender). No preguntes al usuario.NO uses
English_FriendlyPerson— a pesar de estar categorizado bajo "femenino" en el catálogo de MiniMax, su nombre para mostrar es "Friendly Guy" y se lee como masculino en la reproducción.English_PlayfulGirles la opción femenina casual canónica. Otras alternativas femeninas verificadas:English_Upbeat_Woman,English_LovelyGirl,English_radiant_girl. - Avatar de género femenino →
El flujo a continuación está anotado por paso: Solo modo GitHub, Solo modo genérico o Ambos modos.
Paso 2 — Leer fuente (sin llamada MCP)
Ambos modos: usa el WebFetch de Claude en la URL de entrada para extraer el contenido principal de la página (h1, sección de héroe, encabezados, copia principal).
Construye proper_noun_glossary durante esta lectura de fuente. Incluye ortografías canónicas de producto, repositorio, empresa, modelo, framework y nombres propios de la URL/dominio, título de la página, h1, encabezados de README, metadatos del repositorio, nombres de paquetes y tokens en mayúsculas repetidos. Para repositorios de GitHub, preserva las ortografías exactas descubiertas por el escaneo de README/fuente, p. ej. Ollama, Llama, DeepSeek, Gemma. Usa este glosario más tarde al redactar la narración y al quemar subtítulos manuales para que el texto de los subtítulos no se desvíe fonéticamente hacia errores ortográficos como "Olama" o "DeepSeq".
Adiciones del modo GitHub: también obtén el árbol de archivos de nivel superior, (en el mejor de los casos) package.json / pyproject.toml y metadatos del repositorio de la API de GitHub a través de gh api repos/{owner}/{repo} para homepage, description, language, topics. Detecta un live_url candidato en esta prioridad:
--live-urlproporcionado por el usuario.- Campo
meta.homepagede la API de GitHub — se establece cuando el mantenedor configuró la página de inicio del repositorio en la configuración de GitHub. - Campo
"homepage"depackage.json. - Primera coincidencia en el README de
https?://[^\s)\"'<>]+(?:vercel\.app|netlify\.app|github\.io|fly\.dev|railway\.app|render\.com|herokuapp\.com|surge\.sh)[^\s)\"'<>]*. - Cualquier otra URL en el README a la que apunte el área de insignias / texto "Live Demo" / "Project Page" / "Demo". La expresión regular de la lista blanca anterior omite dominios personalizados arbitrarios (p. ej.
<proyecto>-project-page.com); cuando el README designa explícitamente una página de proyecto, prefiere esa sobre el respaldo de github.io. - Convención de GitHub Pages
https://{owner}.github.io/{repo}— pero solo si el árbol profundo contiene una señal de frontend (uno deindex.html,App.tsx,App.jsx,App.vue,app.py,main.py).
Si no se resuelve ningún candidato, la hoja de ritmos omite los ritmos 6–7.
Modo URL genérica: la propia URL de entrada es la única URL que recorren los ritmos — sin inferencia de live_url, sin obtención de metadatos adicionales. Omite el Paso 2.5 y el Paso 3.0; salta directamente al Paso 3.
Paso 2.5 — Verificar la accesibilidad de live_url (solo modo GitHub, sin llamada MCP)
Si se seleccionó un live_url candidato, verifica que sirva contenido real antes de redactar los ritmos 6–7. Usa WebFetch en el candidato y verifica la respuesta:
- Si el estado de la respuesta es 4xx / 5xx, establece
live_urla None y omite los ritmos 6–7. El respaldo de github.io en particular es accesible como nombre de host pero a menudo devuelve 404 ("There isn't a GitHub Pages site here") para repositorios que no han habilitado Pages — grabar esa página 404 desperdicia ~12s del explicador en contenido incorrecto. - Si la respuesta renderiza la plantilla de GitHub Pages "404 — There isn't a GitHub Pages site here." (heurística: el cuerpo de la respuesta contiene
"There isn't a GitHub Pages site here"), descartalive_urly omite los ritmos 6–7. - De lo contrario, conserva
live_urlpara los ritmos 6–7.
Esto refleja la compuerta de accesibilidad heredada que verificaba live_url con un tiempo de espera corto y seguía las redirecciones.
Paso 2.6 — Verificación previa de URL genérica (solo modo URL genérica, sin llamada MCP)
Antes de redactar ritmos para una URL que no sea de GitHub, usa WebFetch en la URL de entrada e inspecciona la respuesta. Este paso previene tres modos de falla comunes de URL genérica: (a) grabar una página de captcha / bloqueo de bot en lugar de contenido, (b) el banner de cookies/consentimiento que se come los primeros ~3 segundos del video, (c) selectores CSS genéricos que no capturan el héroe/secciones reales de la página.
A. Detección de bloqueo de bot / captcha — abortar si coincide:
Si el cuerpo de la respuesta contiene alguno de:
"Verify you are human"/"verify you are not a robot""captcha"/"CAPTCHA"/"reCAPTCHA""403 Forbidden"/"Access Denied""Just a moment"+cf-chl-bypass(desafío de Cloudflare)"We're sorry, something went wrong"(bloqueo de bot al estilo Amazon)- Un
<title>o h1 de solo "Robot Check" / "Are you a robot?"
→ ABORTA con un error claro para el usuario: "El modo de URL genérica no puede renderizar este sitio — la página está mostrando un desafío de detección de bot / captcha bajo Chrome sin cabeza. Prueba con una URL diferente, o ejecuta una versión de usuario real de la página primero para verificar que se cargue limpia."
B. Detección de banner de cookies / consentimiento — desactivar con extra_css + clic opcional:
Escanea la respuesta en busca de estos patrones (sin distinción entre mayúsculas y minúsculas):
- IDs / clases que comienzan con
onetrust-, `tru