Communitygithub.com

Pika-Labs/Pika-Plugins

Génère une vidéo explicative de 60 à 80 secondes pour n'importe quelle URL (dépôt GitHub, page produit, documentation, article, lancement). Navigue automatiquement sur la page, crée un avatar en lipsync et assemble le tout dans un cadre macOS Sonoma 1280×800.

Qu'est-ce que Pika-Plugins ?

Cette compétence permet de créer des vidéos explicatives courtes et professionnelles pour n'importe quelle URL. Elle automatise l'ensemble du processus : navigation web réelle, génération d'un avatar parlant avec lipsync, synthèse vocale et composition vidéo dans un cadre macOS Sonoma 1280×800. Pour les URLs GitHub, elle active un mode spécifique qui analyse le README, détecte les démos en direct et utilise des sélecteurs CSS adaptés. Pour les autres URLs, elle utilise un mode générique de parcours de page. La compétence intègre des garde-fous importants : une porte de transparence des coûts avant toute dépense, une analyse de qualité de l'avatar avant le lipsync, et une détection des pages bloquées par des captchas ou des bannières de consentement. Elle prend en charge les fournisseurs de lipsync Pika et Kling, et propose des options de prévisualisation et de sous-titrage.

Compatible avec✓Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/Pika-Labs/Pika-Plugins/tree/HEAD/skills/explainer

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

/pika:explainer

Génère une vidéo explicative d'environ 60 à 80 secondes pour une URL : navigue sur la page avec un vrai navigateur selon un story-board temporel, génère un avatar en lipsync de la narration, et assemble le tout dans un cadre macOS Sonoma 1280×800 avec un avatar interne de 240 pixels (246 pixels avec l'anneau blanc de 3 px) positionné en bas à gauche aux coordonnées (20, 476) et un zoom ciblé sur les éléments de chaque séquence centrale. Fonctionne pour n'importe quelle URL — pages produit, documentation, articles, lancements. Les URLs GitHub activent un mode spécifique (analyse du README + détection de démo en direct) ; toutes les autres URLs utilisent un parcours générique de la page.

Utilisation : /pika:explainer <url> [--focus "angles"] [--avatar <url>] [--voice <id>] [--lipsync-provider pika|kling] [--preview] [--live-url <url>]

Porte de transparence des coûts

Avant tout appel MCP payant, appelez identity_balance({verbose: true}) une fois. Affichez le solde actuel, le taux de consommation récent et la durée restante, puis conditionnez l'exécution avec ce message exact :

Coût estimé : environ 50 à 500 crédits (~0,50 € à 5,00 €) selon le fournisseur de lipsync, la narration, les sous-titres et le mode de prévisualisation. Ce coût peut atteindre 5 €. Répondez proceed pour continuer ou cancel pour arrêter.

N'appelez aucun outil MCP payant tant que l'utilisateur n'a pas répondu proceed. Si l'utilisateur répond cancel, arrêtez-vous sans rien générer. Cette vérification a lieu une fois l'URL et les options facultatives connues, avant la génération de l'avatar, de la parole, du lipsync, des sous-titres ou de la composition vidéo.

Comportement

Valeurs par défaut — agir vite, pas de confirmation inutile en cours de route

  • Résoudre l'avatar / la voix silencieusement. Ne demandez jamais « dois-je utiliser votre avatar ? » ou « quelle voix ? » avant d'agir. Honorez les surcharges explicites (--avatar, --voice) si fournies ; sinon, générez un avatar présentateur et choisissez une voix par défaut, puis continuez. Voir l'Étape 1 pour la résolution complète.
  • Seule la porte de transparence des coûts demande proceed. L'aperçu de l'Étape 5 est normalement optionnel via --preview pour les avatars explicites, mais devient un aperçu automatique obligatoire lorsque la source de l'avatar est un repli généré ou régénéré. Après la porte de coût, le flux s'exécute de bout en bout, sauf pour cette barrière de sécurité d'aperçu obligatoire pour les avatars de repli.
  • Ne sollicitez pas --focus non plus. Faites une première tentative confiante à partir de la structure de la page ; les utilisateurs relancent avec --focus "X" si l'angle n'était pas le bon.

Ces valeurs par défaut correspondent aux standards de l'industrie pour les outils de génération média (Midjourney / Sora / Runway / HeyGen / Pika.art) : soumettre → générer → retourner. Le solde du compte et le basculement vers un autre fournisseur (Étape 9) sont les garde-fous canoniques.

Images d'avatar locales sur Claude Desktop

Claude Desktop ne peut pas encore transmettre d'images collées en ligne aux outils MCP (limitation côté Anthropic). Si l'utilisateur colle une photo en ligne ou mentionne un fichier local à utiliser comme --avatar, mettez en pause l'Étape 1 et envoyez-lui aimablement ce message — par exemple :

Attention — les images collées n'atteignent pas encore les outils MCP sur Claude Desktop (limitation Anthropic). Deux options simples pour votre avatar :

  • Collez une URL si elle est déjà hébergée (Imgur, S3, votre site) — le plus rapide
  • Joignez le fichier image pour que je puisse le télécharger avant la génération.

Lorsqu'un fichier local arrive, convertissez-le en URL publique avec upload_asset et utilisez l'public_url renvoyée comme --avatar <url> avant l'Étape 1. Les URLs https://... déjà hébergées fonctionnent telles quelles et ignorent complètement cette étape. Si aucun avatar n'est fourni, un portrait de présentateur est généré silencieusement (Étape 1).

Étape 0 — Résoudre l'URL (menu sans arguments)

Supprimez les drapeaux (--focus, --avatar, --voice, --live-url, --lipsync-provider, --no-captions, --preview, --skip-preview, --yes) et les paramètres clé=valeur de $ARGUMENTS. Si ce qui reste ne contient pas d'URL https://... (ou est vide / ne contient que des espaces), affichez ce menu textuellement comme votre réponse complète, puis arrêtez-vous et attendez le prochain message de l'utilisateur. Appeler un outil ici risquerait d'enregistrer ou d'expliquer la mauvaise page. Si $ARGUMENTS contient déjà une URL, passez cette étape silencieusement et passez à l'Étape 1.

Quelle URL souhaitez-vous que je parcoure ? Fonctionne pour :

  • Un dépôt GitHub — par exemple https://github.com/anthropics/claude-code (active le mode dépôt : analyse du README + détection de démo en direct)
  • Une page produit / page de lancement — par exemple https://pika.art
  • Un site de documentation — par exemple https://docs.anthropic.com
  • Un article de blog / une URL d'article

Résultat : cadre macOS Sonoma 1280×800 avec un avatar en lipsync en bas à gauche et un zoom ciblé sur les éléments de chaque séquence centrale. Le flux par défaut s'exécute de bout en bout après la porte de coût ; passez --preview si vous souhaitez une vérification rapide de 3 secondes du lipsync pour un avatar explicite. Les avatars de repli générés / régénérés exécutent automatiquement cette barrière de sécurité d'aperçu.

Répondez avec l'URL et je commence.

Astuce : vous n'avez pas besoin de taper /pika:explainer — dites simplement « explique-moi », « fais une vidéo de démo de » ou « explique ce dépôt : » et je déclencherai cette compétence automatiquement.

Lorsque l'utilisateur répond avec une URL, traitez-la comme l'entrée résolue et passez à l'Étape 1. Ne redemandez pas.

Étape 1 — Analyser l'entrée et détecter le mode

Requis : url (doit être https://...). Facultatif : --avatar <url> (la photo du présentateur ; si omise, une est générée), --voice <minimax-voice-id>, --focus "..." (orientation éditoriale intégrée dans vo_text), --live-url <url> (URL de démo en direct fournie — mode GitHub uniquement), --lipsync-provider <pika|kling> (par défaut pika — a2v perroquet, ~2-5 min temps réel, mouvement de tête légèrement plus prononcé. Passez kling pour un résultat plus centré sur le visage à ~5-30 min temps réel — Kling produit des plans de présentateur avec peu de mouvement de tête mais constitue l'étape la plus longue ; réservez-le pour des rendus importants), --no-captions (ignore le brûlage de sous-titres de l'Étape 11 — par défaut, les sous-titres sont activés), --preview (option d'adhesion à la porte d'aperçu de l'Étape 5 pour les avatars explicites ; les avatars de repli générés et régénérés exécutent automatiquement la porte d'aperçu avant le lipsync complet). --skip-preview et --yes sont acceptés comme des non-opérations pour la rétrocompatibilité.

Détection de mode :

  • Mode GitHub — L'hôte de l'URL est github.com ET le chemin correspond à /{propriétaire}/{dépôt} (pas de segments de chemin supplémentaires au-delà de la racine du dépôt). Active les extras spécifiques au dépôt : analyse du README, détection de démo en direct, sélecteurs GitHub.
  • Mode URL générique — tout le reste (une page produit, un site de documentation, un article de blog, un chemin GitHub plus profond comme /blob/HEAD/path). Ignore les extras GitHub ; utilise des sélecteurs CSS génériques et parcourt l'URL elle-même.

Résolution de l'avatar (silencieuse — ne demandez jamais à l'utilisateur) :

  1. Si --avatar <url> a été passé, utilisez-le.
  2. Sinon, appelez generate_image une fois avec le prompt "présentateur professionnel, narrateur technique amical, portrait studio, 1:1, éclairage naturel" et utilisez l'URL renvoyée. Ne demandez pas à l'utilisateur « dois-je en générer un ? » — générez simplement silencieusement.

Suivez source_avatar comme l'une des valeurs suivantes : explicite, généré ou régénéré.

Porte de qualité de l'avatar (obligatoire avant toute dépense de lipsync) :

Appelez analyze_media(media=<avatar>, query=<requête_porte>) une fois sur l'image d'avatar résolue avant l'Étape 4 TTS et avant tout appel generate_lipsync d'aperçu/complet. C'est le seul cas où l'analyse de l'avatar est requise, car l'avatar est l'actif central du présentateur et un mauvais avatar généré peut gâcher tout le rendu.

Requête de la porte :

Retourne uniquement du JSON : {
  "is_single_front_facing_coherent_human_face": booléen,
  "has_visible_mouth": booléen,
  "is_faceless_or_masked": booléen,
  "is_mascot_illustration_or_non_human": booléen,
  "face_suitability_score": 0-100,
  "apparent_gender": "female" | "male" | "unclear",
  "reason": chaîne de caractères
}
Cette image est-elle adaptée au lipsync d'une tête parlante : un seul visage humain cohérent et de face avec une bouche visible ? Signalez les avatars sans visage, masqués, mascotte, illustration uniquement, non humains ou déformés.

Ne passez que 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 et face_suitability_score >= 75.

Si l'avatar échoue et que source_avatar est explicite, arrêtez-vous avant le lipsync payant et demandez --avatar <url-photo-réaliste> ou l'autorisation de générer un portrait de présentateur. Si l'avatar échoue et que source_avatar est généré, appelez generate_image une fois avec le prompt "portrait de présentateur professionnel réaliste, un seul visage humain cohérent et de face, bouche visible, narrateur technique amical, fond de studio neutre, 1:1, éclairage naturel" ; définissez source_avatar = "régénéré" et réexécutez cette porte de qualité sur l'avatar régénéré. Si l'avatar régénéré échoue également, abandonnez avec une erreur claire au lieu de tenter le lipsync.

Définissez aperçu_auto_avatar_requis = true chaque fois que source_avatar est généré ou régénéré ; sinon false, sauf si l'utilisateur a passé --preview.

Résolution de la voix (silencieuse — ne demandez jamais à l'utilisateur) :

  1. Si --voice <id> a été passé, utilisez-le.

  2. Sinon, choisissez un préréglage MiniMax speech-2.8-hd occasionnel correspondant au genre apparent de l'avatar résolu :

    • Avatar à codage féminin → English_PlayfulGirl (chaleureuse, décontractée, voix clairement féminine — vérifié)
    • Avatar à codage masculin → English_Jovialman (chaleureux, masculin décontracté)
    • Non clair / genre neutre → English_Jovialman (par défaut)

    Déduisez le genre du résultat de la porte de qualité de l'avatar (apparent_gender). Ne demandez pas à l'utilisateur.

    N'utilisez PAS English_FriendlyPerson — bien qu'il soit classé sous « féminin » dans le catalogue de MiniMax, son nom d'affichage est « Friendly Guy » et il sonne masculin à la lecture. English_PlayfulGirl est le choix féminin occasionnel canonique. Autres alternatives féminines vérifiées : English_Upbeat_Woman, English_LovelyGirl, English_radiant_girl.

Le flux ci-dessous est annoté par étape : mode GitHub uniquement, Générique uniquement ou Les deux.

Étape 2 — Lire la source (pas d'appel MCP)

Les deux modes : utilisez la fonction WebFetch de Claude sur l'URL d'entrée pour extraire le contenu principal de la page (h1, section hero, titres, texte principal).

Construisez glossaire_noms_propres lors de cette lecture de la source. Incluez les orthographes canoniques des noms de produit, dépôt, entreprise, modèle, framework et noms propres de l'URL/domaine, du titre de la page, du h1, des titres du README, des métadonnées du dépôt, des noms de paquets et des tokens en majuscules répétés. Pour les dépôts GitHub, conservez les orthographes exactes révélées par l'analyse du README/source, par exemple Ollama, Llama, DeepSeek, Gemma. Utilisez ce glossaire plus tard lors de la rédaction de la narration et lors du brûlage manuel des sous-titres afin que le texte des sous-titres ne dérive pas phonétiquement vers des fautes d'orthographe comme « Olama » ou « DeepSeq ».

Ajouts du mode GitHub : récupérez également l'arborescence des fichiers de premier niveau, (au mieux) package.json / pyproject.toml, et les métadonnées du dépôt via l'API GitHub avec gh api repos/{propriétaire}/{dépôt} pour homepage, description, language, topics. Détectez une live_url candidate dans cet ordre de priorité :

  1. --live-url fourni par l'utilisateur.
  2. Champ GitHub API meta.homepage — défini lorsque le mainteneur a configuré la page d'accueil du dépôt dans les paramètres GitHub.
  3. Champ "homepage" de package.json.
  4. Première correspondance dans le README d'une https?://[^\s)\"'<>]+(?:vercel\.app|netlify\.app|github\.io|fly\.dev|railway\.app|render\.com|herokuapp\.com|surge\.sh)[^\s)\"'<>]*.
  5. Toute autre URL dans le README vers laquelle pointent la zone de badge / le texte « Live Demo » / « Project Page » / « Demo ». L'expression régulière de la liste autorisée ci-dessus ne tient pas compte des domaines personnalisés arbitraires (par exemple <projet>-project-page.com) ; lorsque le README désigne explicitement une page de projet, préférez-la au repli github.io.
  6. Convention GitHub Pages https://{propriétaire}.github.io/{dépôt} — mais uniquement si l'arborescence profonde contient un signal frontend (l'un des suivants : index.html, App.tsx, App.jsx, App.vue, app.py, main.py).

Si aucun candidat n'est résolu, le story-board ignore les séquences 6 à 7.

Mode URL générique : l'URL d'entrée elle-même est la seule URL que le story-board parcourt — pas d'inférence de live_url, pas de récupération de métadonnées supplémentaires. Ignorez l'Étape 2.5 et l'Étape 3.0 ; passez directement à l'Étape 3.

Étape 2.5 — Vérifier l'accessibilité de live_url (mode GitHub uniquement, pas d'appel MCP)

Si un candidat live_url a été sélectionné, vérifiez qu'il sert du contenu réel avant de rédiger les séquences 6 et 7. Utilisez WebFetch sur le candidat et vérifiez la réponse :

  • Si le statut de la réponse est 4xx / 5xx, supprimez live_url (mettez-le à None) et ignorez les séquences 6 et 7. Le repli github.io en particulier est accessible en tant que nom d'hôte mais renvoie souvent une erreur 404 (« There isn't a GitHub Pages site here ») pour les dépôts qui n'ont pas activé Pages — enregistrer cette page 404 gaspille environ 12 secondes de l'explication avec un contenu erroné.
  • Si la réponse affiche le template GitHub Pages « 404 — There isn't a GitHub Pages site here. » (heuristique : le corps de la réponse contient "There isn't a GitHub Pages site here"), supprimez live_url et ignorez les séquences 6 et 7.
  • Sinon, conservez live_url pour les séquences 6 et 7.

Cela reflète l'ancienne porte d'accessibilité qui vérifiait live_url avec un court délai d'attente et suivait les redirections.

Étape 2.6 — Pré-vol URL générique (mode URL générique uniquement, pas d'appel MCP)

Avant de rédiger les séquences pour une URL non GitHub, utilisez WebFetch sur l'URL d'entrée et inspectez la réponse. Cette étape évite trois modes de défaillance courants du mode URL générique : (a) enregistrer une page captcha / de blocage de robot au lieu du contenu, (b) la bannière de cookies/consentement qui mange les 3 premières secondes de la vidéo, (c) des sélecteurs CSS génériques qui manquent le hero / les sections réels de la page.

A. Détection de blocage de robot / captcha — abandonnez si correspondant :

Si le corps de la réponse contient l'un des éléments suivants :

  • "Verify you are human" / "verify you are not a robot"
  • "captcha" / "CAPTCHA" / "reCAPTCHA"
  • "403 Forbidden" / "Access Denied"
  • "Just a moment" + cf-chl-bypass (défi Cloudflare)
  • "We're sorry, something went wrong" (blocage de robot de type Amazon)
  • Un <title> ou h1 qui est simplement « Robot Check » / « Are you a robot? »

→ ABANDONNEZ avec une erreur claire à l'utilisateur : « Le mode URL générique ne peut pas rendre ce site — la page affiche un défi de détection de robot / captcha sous Chrome headless. Essayez une URL différente, ou exécutez d'abord une version utilisateur réel de la page pour vérifier qu'elle se charge correctement. »

B. Détection de bannière de cookies / consentement — désamorcez avec extra_css + clic optionnel :

Analysez la réponse pour ces motifs (insensibles à la casse) :

  • IDs / classes commençant par onetrust-, tru

... [tronqué pour la traduction]

Skills associés