Communitygithub.com

viralprinter

Vidéo courte structurée en premier. Transformez un sujet, un produit ou une URL de vidéo courte en un dossier de tournage basé sur des preuves ; composez une chronologie déclarative en mp4 avec ffmpeg ; et notez n'importe quelle vidéo courte — y compris la sortie de tout générateur vidéo IA — selon les règles de structure virale. L'agent raisonne et compose ; les preuves sont fournies, jamais inventées.

Qu'est-ce que viralprinter ?

viralprinter est une compétence d'agent IA spécialisée dans la création et l'évaluation de vidéos courtes (short-form video) avec une approche axée sur la structure et les preuves, plutôt que sur la génération prédictive de vues. Elle offre deux composants principaux : un outil CLI local (validation, composition via ffmpeg, notation) et une source de preuves optionnelle via l'API MCP de Shorti (analyse de vidéos réelles, leurs généalogies et formules d'emprunt). La compétence est conçue pour les agents capables de raisonner et de composer des séquences vidéo, en utilisant des données factuelles issues d'un corpus d'analyse. Elle prend en charge plusieurs flux de travail : création à partir d'un sujet ou d'un produit, analyse d'une URL existante, coaching en cours de tournage, briefing hebdomadaire, et notation de n'importe quel fichier vidéo (y compris les sorties de générateurs IA comme Sora, Runway, etc.) sans nécessiter de compte. Le flux central aboutit à la rédaction d'un « packet » (dossier de tournage structuré contenant formule d'emprunt, liste de plans, répliques, rubrique de notation et preuves), puis à la compilation d'une chronologie JSON validée et transformée en fichier MP4 via ffmpeg. Les résultats de notation sont présentés sous forme de carte détaillée sans note globale, indiquant les catégories mesurées, non mesurées et hors bande avec leurs raisons. La compétence insiste sur l'honnêteté (absence de prédiction de performance, abstention en cas de données insuffisantes), la discipline de réessai unique, et l'interdiction d'inventer des médias ou des scores.

Compatible avec✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/ds4psb-ai/viralprinter/tree/main

Demander à votre IA préférée

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

Documentation

viralprinter — composer et noter des vidéos courtes, avec preuves de structure

Vous pilotez deux parties.

  • Local, toujours disponible. La CLI viralprinter dans ce dépôt : validate, compose (chronologie JSON → mp4 via ffmpeg), et grade (notez toute vidéo courte selon les règles de structure virale). Pas de compte, pas de clés, pas de téléversement.
  • Preuves, optionnelles. La porte MCP en lecture seule de Shorti : clips courts réels analysés, leur lignée (ce qui a bougé, ce qui a muté, ce qui est mort), et les formules d'emprunt par clip (garder / changer / ne_jamais_toucher) avec reçus du public.

Shorti n'est pas un générateur vidéo et vous ne devez pas le présenter comme tel. Vous faites le raisonnement et la composition. Shorti fournit des preuves et s'abstient honnêtement lorsque les preuves sont minces — transmettez ses abstentions ; ne les remplissez jamais.

Si l'utilisateur souhaite seulement qu'une vidéo courte soit notée, ignorez entièrement la partie preuves : Flux G.

Configuration

L'outil (requis pour composer et noter)

git clone https://github.com/ds4psb-ai/viralprinter && cd viralprinter
uv pip install -e .          # ou : pip install -e .

Python ≥ 3.11. ffmpeg et ffprobe doivent être dans le PATH — la composition et la notation en mode vidéo les utilisent en ligne de commande. Confirmez avec viralprinter --help avant de promettre un fichier rendu. Si la commande ou les binaires sont manquants, dites-le et arrêtez-vous plutôt que de décrire une sortie que vous n'avez pas produite.

Preuves Shorti (optionnelles)

claude mcp add --transport http shorti https://api.shorti.ai/mcp/public-read/mcp

Tout client d'agent compatible MCP utilise cette URL de la même manière. Le premier appel déclenche OAuth dans le navigateur — dites à l'utilisateur de le terminer, puis réessayez une fois. Cette compétence ne collecte jamais de clés API, ne demande jamais à l'utilisateur de coller des secrets dans le chat, et ne téléverse jamais les médias de l'utilisateur : le montage est en lecture seule par contrat (il ne publie, édite, publie, supprime ou dépense jamais). La notation et la composition n'ont pas besoin de compte Shorti ; les paquets de preuves sont la partie qui en a besoin.

Règles de fonctionnement

  1. Une seule question combinée, au maximum. Si des entrées manquent (sujet vs produit vs URL, aspect cible, langue), demandez une fois, ensemble. Ne demandez jamais de confirmation entre les appels d'outils.
  2. Locale. Passez locale correspondant à la langue de l'utilisateur (en, ko, ja) sur chaque appel qui l'accepte, et répondez entièrement dans la langue de l'utilisateur.
  3. Chiffres. Les observed_metrics dans les résultats de preuves sont des décomptes factuels du corpus — citez-les comme preuve. Les chiffres du noteur sont des mesures du fichier devant vous — citez-les comme mesures. Ne produisez jamais de chiffres prédictifs : pas de prévisions de vues, pas de multiplicateurs « N× », pas de pourcentages de ROI. Affirmations de structure, pas de promesses de résultat.
  4. Absence honnête. Des preuves minces ou une abstention sont le bon fonctionnement de l'outil, tout comme une catégorie du noteur signalant state : not_measured avec une raison. Signalez l'abstention telle quelle ; ne devinez jamais un substitut ou un score.
  5. Ne collez pas de JSON brut. Synthétisez. L'utilisateur lit de la prose, le fichier du paquet et la fiche de score — pas les charges utiles.
  6. Discipline de réessai. Un réessai par appel échoué. Si un paramètre est rejeté, relisez la description de l'outil au lieu de deviner à nouveau.
  7. N'inventez jamais de médias. Une chronologie ne peut référencer que des fichiers qui existent sur le disque. Si des clips manquent, dites lesquels et arrêtez-vous au paquet.

Flux A — « fais-moi une vidéo courte sur SUJET » / « 이거로 쇼츠 만들어줘 »

  1. search_trend_genealogy avec le sujet. Les demandes limitées dans le temps passent moved_within_days (7 pour « cette semaine », 30 pour « ces jours-ci »).
  2. Choisissez la correspondance la plus forte (indiquez votre choix et pourquoi en une phrase — ne demandez pas sauf si vraiment ambigu).
  3. get_trend_genealogy_card exactement une fois sur cette correspondance — c'est la formule d'emprunt : garder / changer / ne_jamais_toucher, lignée, preuve du public.
  4. get_clone_kit_capsule pour le clip sélectionné — le 콘티 plan par plan.
  5. Compilez le paquet (ci-dessous), puis continuez dans le Flux F si l'utilisateur a des images ou souhaite un rendu.

Flux B — « fais une vidéo courte pour MON PRODUIT »

  1. suggest_trends_for_product — product_description= fonctionne sans aucune inscription ; utilisez les propres mots de l'utilisateur pour le produit.
  2. Ensuite, Flux A étapes 2–5. Si l'utilisateur a un compte Shorti avec des produits enregistrés, list_my_products + get_my_product_truth affinent la correspondance.

Flux C — l'utilisateur a collé une URL de vidéo courte

Une URL collée n'est jamais une recherche. Appelez preview_pasted_url D'ABORD, puis continuez avec le Flux A étapes 3–5 sur ce qu'elle résout.

Flux D — coaching en cours de tournage

  • Prochaine coupe : get_next_shot_cue — un signal par appel, tournez, répétez.
  • « Comment je m'en suis sorti ? » : get_shot_coaching_rubric, puis vous notez le clip que l'utilisateur vous montre par rapport à cette rubrique. L'appel de la rubrique ne comporte aucun paramètre de fichier ou d'URL par conception — la compréhension du clip est la vôtre, sur les médias que vous voyez déjà. N'envoyez jamais les images de l'utilisateur ailleurs. Pour un deuxième avis structurel sur un fichier terminé, exécutez le Flux G en parallèle.

Flux E — « quoi de neuf cette semaine ? »

get_lifecycle_briefing une fois ; get_started est l'orientation de premier contact lorsque l'utilisateur demande ce que Shorti peut faire en général.

Le paquet — votre premier livrable

Écrivez un fichier local shorti-packet-<slug>.md dans le répertoire de travail :

# <titre de travail>

## Formule (empruntée de <réf lignée>)
garder / changer / ne_jamais_toucher — textuellement de la carte de généalogie, avec reçus.

## Liste de plans
Plans numérotés du kit de clonage : battement, durée, cadrage, action, signal audio.

## Signaux par plan
Les signaux que vous donneriez un par un sur le plateau (ordre Flux D).

## Rubrique de notation
La rubrique selon laquelle vous noterez les rushes.

## Preuves
Références de lignée et observed_metrics — faits uniquement, pas de prévisions.

Terminez cette étape avec exactement une ligne lisible par machine :

PACKET_FILE=<chemin absolu>

Flux F — paquet → chronologie → mp4 (boucler la boucle)

Le paquet est un plan ; cela le transforme en fichier. Ne commencez pas sans médias.

  1. Localisez les médias. Demandez une fois à l'utilisateur le répertoire des clips, ou utilisez les sorties du fournisseur déjà sur le disque. Chaque src que vous écrivez doit être résolu.

  2. Rédigez vous-même la chronologie. Traduisez la liste de plans du paquet en un fichier JSON — vous l'écrivez, aucun outil ne le génère. Champs, et seulement ceux-ci :

    {
      "version" : "0.1",
      "canvas" : {"aspect" : "9:16", "resolution" : [1080, 1920], "fps" : 30},
      "audio" : {"music" : {"src" : "assets/music.mp3", "gain_db" : -18}},
      "beats" : [
        {
          "id" : "hook",
          "role" : "hook",
          "t" : [0.0, 1.2],
          "shot" : {"src" : "clips/01.mp4", "in" : 3.4, "framing" : "close"},
          "text" : {"content" : "wait for it", "pos" : "center"},
          "cue" : "cold open on the reveal, no logo"
        }
      ],
      "subtitles" : {"mode" : "none"},
      "provenance" : {"packet" : "shorti-packet-<slug>.md"}
    }
    

    beats[].t sont des secondes absolues, triées, sans chevauchement. role est l'un de hook | development | payoff | cta | other. Obligatoire : version, canvas, beats, et par beat t + shot. Tout le reste est facultatif — omettez ce que vous ne savez pas au lieu de l'inventer. Portez le nom du fichier du paquet dans provenance. Exemples fonctionnels : examples/*.json.

  3. viralprinter validate <timeline.json> — corrigez chaque erreur dans la chronologie. Ne contournez jamais une erreur de validation ; elle vous dit que le plan n'est pas rendable.

  4. viralprinter compose <timeline.json> -o out.mp4 — utilisez --dry-run d'abord si le rendu est long ou si les médias sont inconnus.

  5. Rapportez ce que vous avez construit en prose, puis exactement une ligne lisible par machine :

    VIDEO_FILE=<chemin absolu>
    
  6. Proposez la note, ou exécutez-la directement si l'utilisateur a demandé une vidéo courte terminée : viralprinter grade out.mp4 --markdown, puis les règles de rapport du Flux G.

Flux G — « note cette vidéo courte » (aucun compte Shorti nécessaire)

Fonctionne sur n'importe quel fichier que l'utilisateur désigne, y compris la sortie brute de n'importe quel générateur vidéo IA, et sur une chronologie JSON avant le rendu d'une seule image.

  1. viralprinter grade <file.mp4 | timeline.json> --markdown (--json lorsqu'une machine le consomme).
  2. Rapportez la carte. Il n'y a pas de score global — la carte est le résultat. Ne faites pas la moyenne, n'inventez pas de note, ne classez pas la vidéo.
  3. Lisez à haute voix les lignes not_measured avec leur raison. Une vidéo ne peut pas exposer ses propres rôles de battement, donc certaines catégories ne sont mesurables qu'en mode chronologie ; cet écart est la réponse honnête, pas un échec.
  4. Dites ce que sont les bandes : grossières, distillées, provenance : provisional. Elles décrivent une structure qui s'est répétée dans les clips analysés. Elles ne promettent pas de performance, et une ligne out_of_band est une question à laquelle il faut répondre, pas un défaut.
  5. Soyez ensuite utile — nommez le seul changement structurel ayant le plus grand effet et, si l'utilisateur souhaite l'appliquer, passez au Flux F.

Protocole d'échec

  • OAuth non terminé → une phrase disant à l'utilisateur de terminer le flux du navigateur, puis réessayez une fois.
  • Un outil prenant une référence appelé à froid (trend_ref manquant, etc.) → vous avez sauté une étape ; reculez d'un appel dans le flux au lieu de réessayer à l'aveugle.
  • Erreurs de transport persistantes → rapportez la dernière erreur textuellement et arrêtez-vous.
  • viralprinter ou ffmpeg introuvable → rapportez le binaire manquant et la ligne d'installation. Ne simulez jamais un rendu.
  • Échec de composition → l'erreur porte la fin du stderr de ffmpeg. Citez-la, puis corrigez la chronologie. N'exécutez pas ffmpeg manuellement pour contourner le compilateur.
  • Erreurs de validation → corrigez la chronologie et revalidez. Ne passez jamais une chronologie invalide à compose.

Skills associés