Communitygithub.com

suntay44/motionable

Pipeline interne motionable (mode planification, approbation, scènes, musique, critique, rendu). Commencez par /motionable:scratch, :website ou :project.

Qu'est-ce que motionable ?

Cette compétence d'agent IA met en œuvre le pipeline complet de production vidéo de motionable pour créer des films promotionnels de produits. Elle guide l'agent à travers six phases structurées : planification dirigée par les preuves, approbation en une seule étape, construction de la scène, composition musicale, auto-critique et livraison. La compétence prend en charge Claude Code (via l'extension motionable) et exige que l'agent lise plusieurs documents de base (PLAN.md, ENGINE.md, rules.md, checklist.md) avant de planifier. Elle met l'accent sur l'originalité en interdisant de copier les exemples existants, applique des vérifications de qualité via des scripts de construction, et gère les retours des utilisateurs avec des révisions limitées. Des fonctionnalités clés incluent l'écriture SVG intégrée pour les illustrations (sans générateur d'images externe), la détection automatique du tempo et du style à partir des preuves du produit, et des commandes d'édition précises via des scripts shell. La compétence évite les boucles de révision infinies en limitant les passes de correction et inclut l'intégration des badges d'App Store/Google Play pour les produits en ligne.

Compatible avec✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/suntay44/motionable/tree/HEAD/skills/make

Demander à votre IA préférée

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

Documentation

motionable : créer

Vous arrivez avec des faits sur un produit (chacun avec une source), les réponses de l'utilisateur, des chemins d'images, des couleurs et des notes sur sa personnalité. Votre travail est un film fini qui ressemble à ce produit, et à aucun autre film du studio.

ROOT est la racine motionable : ${CLAUDE_PLUGIN_ROOT}. Si elle n'est pas développée, utilisez le dossier deux niveaux au-dessus du chemin réel de ce fichier (realpath), qui contient engine/ et scripts/.

Lisez ROOT/PLAN.md (mode planification), ROOT/ENGINE.md (les ingrédients), ROOT/rules.md (règles strictes) et ROOT/checklist.md (critique) avant de planifier. ROOT/exemples/owly/ montre à quoi ressemble un travail terminé. Ne copiez jamais son apparence, son son ou sa structure : ce n'est qu'une direction parmi une infinité.

1. Créer le film

  • Où : les films vivent dans le dossier courant (généralement le studio de l'utilisateur pour les vidéos promotionnelles), sous <slug>/.
    • Si le dossier courant est le dépôt du produit lui-même, utilisez plutôt motionable/<slug>/.
    • N'écrivez jamais dans un dossier produit donné via /motionable:project.
    • Si <slug>/ existe, demandez : créer une nouvelle version (<slug>-2/), ou continuer ce film ?
  • Créez-le : exécutez bash ROOT/scripts/new.sh <film> "<Nom du produit>". Il copie le moteur dans le film et écrit les modèles.
  • Ressources : copiez les images dans <film>/assets/ avec des noms clairs (logo.png, screen-accueil.png…). Un fichier de police de marque, si l'utilisateur en a un, va dans assets/fonts/.

2. Mode planification (interne : pas de commande, pas de menu de style)

Suivez PLAN.md du début à la fin :

  1. Tableau de preuves et personnalité.
  2. Histoire : promesse, moment signature, 3 accroches → 1.
  3. Chaque réglage défini, chacun avec sa raison.
  4. Unicité face au studio : lisez les DIRECTION.md des autres films › Empreinte. Les films créés avant la v0.2 n'en ont pas ; traitez-les comme de la house à 120 BPM en La mineur avec des titres alignés à gauche sur une carte.
  5. Écrivez DIRECTION.md et SCRIPT.md au tempo choisi.

Ne demandez pas à l'utilisateur de choisir un style. La direction vient des preuves.

3. Une approbation

Montrez le traitement en 4 lignes (Sensation · Son · Aspect · Moment signature) et une grille de beats compacte (temps · image · mots · jonction). Puis demandez, avec AskUserQuestion si disponible (sinon dans le chat) :

  1. Le plan : approuvez, ou modifiez quelque chose.
  2. Illustrations : « Dois-je dessiner des illustrations pour ce film ? » Oui, illustrez-le / Quelques accents / Non, captures d'écran et texte seulement. Recommandez-en une avec une raison (PLAN.md §5).
    • Les dessiner est gratuit : Claude écrit des SVGs.
    • Uniquement si la session dispose d'un outil de génération d'images connecté, ajoutez-le comme option, et dites que cela peut coûter de l'argent.

N'écrivez aucun code de scène avant l'approbation. Une modification ici est peu coûteuse.

4. Construire

  1. Illustrations (si oui) : écrivez les SVGs dans assets/drawn/ dans les couleurs de la marque et une épaisseur de trait (ENGINE.md › Illustrations dessinées). Regardez chacune rendue sur une feuille, et redessinez tout ce qui est maladroit.
  2. scenes/Film.swift : remplacez complètement le squelette. Chaque valeur vient de DIRECTION.md et SCRIPT.md :
    • les temps vont dans enum T ;
    • les clips et les jonctions vont dans un Reel ;
    • les écrans passent par les appels de cadrage (jamais coupés dans une boîte fixe) ;
    • le moment signature est redessiné pour animer exactement comme la vraie UI. Mesurez d'abord où il se trouve : bash ROOT/scripts/inspect.sh <capture> find <sa couleur> (ou row, column, pixel) donne les anneaux, barres et bords de texte exacts.
    • Les éléments personnalisés dont la direction a besoin vont dans leurs propres fichiers scenes/*.swift.
  3. Son : la Recette de la direction + Sections via s.compose, plus un s.cue pour chaque événement image, en utilisant les sons signature.
  4. Vérifiez la compilation : bash ROOT/scripts/run.sh <film> sheet (pas de temps : le film entier plus chaque jonction). Corrigez les erreurs de compilation (ENGINE.md › Pièges).

5. Brouillon, correction, puis montrer à l'utilisateur

Travaillez par brouillons, et ne bouclez jamais indéfiniment :

  1. Brouillon 1 est la première construction complète : scènes, musique et chaque cue. Examinez-le à partir du film lui-même (les étapes ci-dessous) ; vous n'avez pas besoin d'un fichier vidéo pour cela. (run.sh <film> draft rend un petit MP4 rapide si l'utilisateur veut un aperçu précoce.)
  2. Auto-examen : un seul passage, et chaque vérification.
    • run.sh <film> check : chaque ✗ est une correction obligatoire. Tenez la ligne plus longtemps, commencez-la plus tôt, coupez des mots, ou abandonnez la ligne. Une ligne tapée a besoin de son temps de frappe plus son temps de lecture. Tenez compte aussi de ses conseils ⚠ (image 1, rythme) sauf si DIRECTION.md explique pourquoi pas.
    • run.sh <film> sheet : notez chaque catégorie dans checklist.md, et corrigez tout ce qui est en dessous de 8. Regardez en taille réelle les stills de l'accroche, du moment signature et de la carte de fin : l'UI est-elle lisible, rien n'entre-t-il en collision, chaque coin du cadre fait-il quelque chose ou est-il délibérément vide ?
    • Ce que les spectateurs pénalisent (RECHERCHE.md › vérification communauté) : UI trop petite à lire, rebond sur les gros éléments, plans de même longueur, musique qui sonne banque de sons, un moment logo lent.
    • run.sh <film> audio, puis bash ROOT/scripts/compare.sh <film> : si un autre film est trop similaire, changez la recette pour une raison.
    • Parcourez tout le film : run.sh <film> sheet $(seq 0.5 1 <durée>) (une image par seconde). Cherchez ce que les stills isolés cachent : une scène qui se vide, un beat sans mouvement, une jonction qui heurte, une ligne qui apparaît juste au moment où la scène quitte.
  3. Brouillon 2. Corrigez tout ce qui a été trouvé en un seul lot, puis relancez check et sheet.
    • Si quelque chose échoue encore, autorisez un passage de correction supplémentaire au maximum.
    • Si cela échoue encore après cela, ne continuez pas : dites à l'utilisateur ce qui reste et pourquoi.
    • Gardez un petit journal de critique dans SCRIPT.md : ce qui a changé et pourquoi.
  4. Rendez le fichier réel : run.sh <film> video, environ 45 s pour 30 s.
  5. Montrez-le et demandez (AskUserQuestion si disponible). Envoyez le MP4, le traitement en 4 lignes et le journal de critique, puis posez 3–4 questions ciblées sur ce montage. Chacune nécessite une option recommandée, et « Autre » laisse l'utilisateur dire n'importe quoi :
    • Rythme : semble bon / plus lent, moins de lignes / plus rapide, plus d'impact.
    • Son : gardez-le / plus d'énergie / plus calme / instruments différents.
    • Accroche : gardez-la, ou la plus forte des deux autres candidates accroche du mode planification, nommée.
    • Fin : gardez-la / une fin sécurisée pour le lancement (par exemple, pas de badge Télécharger avant que l'application soit en ligne) / ajoutez le prix.
  6. Révisez une fois par série de réponses, en relançant check, audio et compare, puis montrez le nouveau montage. Après deux séries utilisateur, proposez d'arrêter ou de continuer ; l'utilisateur décide.

6. Stocker les badges (uniquement si le produit est en ligne)

  • App Store en ligne et l'utilisateur veut un badge : demandez la permission de télécharger le badge officiel d'Apple (environ 11 Ko, noir, SVG anglais ; URL dans rules.md) dans assets/.
    • Dessinez-le avec drawAppStoreBadge, fixe et jamais animé ; l'emphase vient de glowRing.
    • Si l'utilisateur insiste pour l'animer, expliquez la règle d'Apple une fois. S'il le veut toujours, faites-en une variante distincte et clairement nommée.
  • Google Play : son badge uniquement si l'application est en ligne là-bas et que l'utilisateur approuve le téléchargement. Sinon, au plus une ligne en texte brut, et seulement si c'est vrai.

7. Livrer

Avec chaque montage que vous montrez, incluez :

  • le traitement en quelques lignes ;
  • ce que l'auto-examen a corrigé ;
  • le résultat de la comparaison et le verdict de check ;
  • les affirmations à vérifier avant publication ;
  • comment le modifier : éditez SCRIPT.md ou DIRECTION.md, ou dites-le simplement.

Une fois l'utilisateur content, proposez les prochaines choses utiles :

  • un montage de 15 s, ou un autre format (1:1, 16:9) ;
  • des variantes d'accroche pour un test A/B : le même film ouvert avec les deux autres candidates accroche du mode planification ;
  • une fin sécurisée pour le lancement (pas de « Télécharger » avant que l'application soit en ligne) ;
  • une version effets seulement (run.sh <film> video effects), pour publication avec un son de plateforme ou un morceau sous licence.

Individual skills in this repo

This repo contains 3 individual skills — each has its own dedicated page.

Skills associés