Communitygithub.com

dsonders/claude-skills

Produit une vidéo de formation ou d'initiation commentée (accompagnée de diapositives annotées et d'un PDF) montrant la véritable application TenthGear. Commence par un storyboard sur un canevas de design (images clés, légendes, piste vocale) que Dave modifie sur place, puis capture des images et des séquences de l'application en direct, narre avec la synthèse vocale OpenAI, et assemble la vidéo. À utiliser lorsqu'on vous demande une vidéo de formation, un guide de démarrage, une vidéo pas à pas, des captures d'écran annotées pour techniciens ou conseillers, ou pour réviser une vidéo de formation existante.

Qu'est-ce que claude-skills ?

Ce skill permet de produire des vidéos de formation professionnelles à partir de l'application réelle TenthGear, en suivant un processus rigoureux de storyboard puis de production. Il est conçu pour Dave, qui édite un storyboard interactif sur un canevas de design ; le skill capture ensuite des images et des séquences de l'application en direct, génère une narration via l'API OpenAI (voix 'ash', modèle `gpt-audio-1.5`), et assemble la vidéo finale. Le format de sortie comprend une vidéo, des diapositives annotées et un PDF, tous générés à partir d'un unique fichier source `storyboard.json`. Le skill met l'accent sur l'utilisation de l'application réelle (pas de maquettes), la vérification de la transcription audio, la restauration de l'environnement de test (magasin, modes), et l'itération contrôlée via le canevas. Il est adapté aux développeurs ou intégrateurs qui doivent automatiser la création de contenu de formation pour des applications mobiles ou web, en respectant des règles de style précises et en évitant les modifications non approuvées.

Compatible avec✓Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/dsonders/claude-skills/tree/HEAD/video-training

Demander à votre IA préférée

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

Documentation

Formation vidéo : storyboard d'abord, puis l'application réelle à l'écran

Une vidéo de formation se compose d'un ensemble de cartes en forme de téléphone. Chaque carte comporte un titre, une ligne d'aide, une image clé de l'application réelle avec des légendes, et une ligne de narration. Certaines cartes diffusent un court clip de l'application au lieu d'une image fixe. Les mêmes cartes sont livrées sous forme de diapositives et d'un PDF.

Un seul fichier pilote tout : storyboard.json. Dave le modifie via un canevas de conception ; chaque script de construction le lit.

Quand l'utiliser

À utiliser pour :

  • Une vidéo de formation, de démarrage, de démarrage rapide ou un didacticiel montrant l'application
  • Des captures d'écran annotées ou un guide de diapositives pour les techniciens, conseillers ou personnel des pièces détachées
  • Une révision d'une vidéo réalisée avec ce skill (nouveau texte, nouvelle carte, nouveau clip)

Ne pas utiliser pour :

  • Une vidéo marketing ou promotionnelle (ton différent, règles différentes ; demander à Dave)
  • Des vidéos d'inspection client enregistrées dans le produit
  • Une maquette d'un écran qui n'existe pas encore (utiliser /visual)

Principes

  1. Storyboard avant production. Rien n'est narré ou assemblé avant que Dave ait modifié le canevas du storyboard et dit qu'il a terminé.
  2. Montrer la vraie application, faisant la vraie chose. Vrai scan, vraie dictée, vraie histoire générée. Jamais d'écran simulé, jamais de résultats saisis.
  3. Dave décide sur le canevas, pas dans le chat. Relire le canevas et le différencier. Ne pas reconstruire ses instructions à partir de la conversation.
  4. Une prise approuvée est conservée. La narration n'est régénérée que pour les lignes dont les mots ont changé. Ne jamais écraser une version que Dave a révisée ; livrer -v2, -v3.
  5. Claude ne peut ni entendre ni regarder. Le dire à chaque retour. Prouver les mots par la transcription et les images par des exemples de frames, et nommer ce qui n'a pas été vérifié.
  6. Laisser le magasin tel qu'on l'a trouvé. Mode restauré et confirmé, bons de réparation de reprise fermés.

À lire d'abord

  • /Users/davidsonders/ro-bot/shared/product-facts.md et shared/brand.md : noms, compteurs, mots interdits. Pas de tirets cadratins, pas d'émojis, « TenthGear » en un mot. Ne jamais dire « single player » ou « multi-player » dans tout ce que le spectateur voit ou entend.
  • reference.md dans ce dossier : les pièges techniques, chacun déjà payé une fois.
  • Notes mémoire sur le canevas de conception : reference_design_canvas_mechanics, reference_design_canvas_roundtrip, reference_design_canvas_entity_crash.

Où se trouvent les éléments

QuoiOù
Dossier du projet vidéo/Users/davidsonders/ro-bot/training-videos/<slug>/ (jamais le scratchpad de session, qui meurt avec la session)
La seule source de vérité<project>/storyboard.json
Images clés, clips, narration<project>/frames/, footage/, narration/
Constructions<project>/out/
Ce que reçoit Dave~/Desktop/<Titre>/
Exemple pratiquetraining-videos/story-writer-getting-started/ et examples/story-writer/ ici

Les scripts se trouvent dans scripts/ ici. Ils prennent le dossier du projet comme premier argument.

Flux de travail

Faire une liste de tâches pour ces étapes et les parcourir dans l'ordre.

Étape 0 : Définir le brief

Trouver ces éléments dans la demande. Ne demander que ce qui manque, une question, recommandation d'abord.

DéciderPar défaut
Qui regarde, et dans quel rôleTechnicien
Téléphone ou bureauTéléphone, 390 x 844
Quel flux, du début à la finLe plan de Dave
Magasin et mode de flux de travailDemander à Dave. Voir Étape 2.
Images fixes uniquement, ou images plus clipsDes clips partout où l'écran bouge : enregistrement, chargement, ouverture et fermeture
DuréeMoins de 2:30

Étape 1 : Storyboard sur un canevas de conception

C'est la première chose que voit Dave et l'endroit où il modifie le script et les légendes.

  1. Créer le dossier du projet et générer les accessoires (props/render-paper.mjs produit l'exemple de bon de réparation papier).

  2. Explorer le flux pour les images clés. Les images clés proviennent de l'application réelle, donc cette étape nécessite une session de capture (Étapes 2 et 3, images fixes uniquement). Copier examples/story-writer/capture-stills.mjs dans le projet et réécrire le flux. Regarder chaque image avant de continuer.

  3. Rédiger storyboard.json. Une carte par action que le spectateur effectue. Format :

    { "id": "write-story", "part": 2, "img": "10-write-story",
      "title": "Appuyer sur [[Écrire l'histoire]]",
      "body": "Le rédacteur IA examine vos notes et rédige les 3C pour vous.",
      "boxes": [[183, 400, 191, 44]], "arrow": [162, 768],
      "footage": { "clip": "C-write", "runs": [[15, 336]], "note": "Ce que montre le clip" },
      "narration": "Lorsque vous êtes prêt, appuyez sur Écrire l'histoire." }
    

    boxes et arrow sont en pixels téléphone ; la capture écrit la zone de chaque contrôle à côté de son image. [[Étiquette]] dessine un bouton. Suivre les règles de style ci-dessous dès le premier brouillon.

  4. Créer le canevas. Outil d'artefact : quickstart avec intention design, puis publier avec l'type_url qu'il renvoie et un titre. Enregistrer l'url dans <project>/storyboard/artifact.json.

  5. Télécharger les images clés sur le canevas en tant que ressources (JPEG, 1688 px de hauteur, mis en scène dans le scratchpad pour qu'elles soient envoyées en un seul appel). Enregistrer chaque url /_blob/... retournée sous assets dans artifact.json, indexée par nom d'image.

  6. Générer et publier. node scripts/storyboard-canvas.mjs <project> écrit storyboard/project/. Copier ce dossier dans le scratchpad et le publier : canvas.json comme file_path, chaque .dc.html dans files.

  7. Donner le lien à Dave et s'arrêter. Lui dire : retaper les mots d'une carte, la note bleue sous chaque carte est la piste vocale, faire glisser les légendes jaunes, écrire toute autre chose sur une note. Ne pas commencer la production.

  8. Récupérer ses modifications. Artefact read avec paths (l'index et chaque planche) et un out_dir, puis node scripts/storyboard-harvest.mjs <project> <out_dir>. Lire le rapport en termes simples, agir sur les notes qu'il a ajoutées, puis relancer avec --write.

  9. Un autre tour ? Relire project/canvas.json, régénérer avec --live <ce fichier>, republier. Une publication qui ne part pas de l'index en direct est refusée.

Étape 2 : Emprunter un magasin

L'application doit être dans le mode que la vidéo montre. Seuls les magasins de test peuvent être utilisés.

MagasinIdMode normalNotes
Summit Auto Group (démo)demo-dealershipflux de travail en équipeDémo de prospection de Dave. Identifiants [email protected] (tech), marcus@ (conseiller), priya@ (pièces). Utilisé pour la première vidéo.
Concessionnaire de test 1mlTaPo12wbpUtJB9GXJMflux de travail en équipePartagé avec les sessions de construction. Souvent occupé.
  1. ListAgents, puis SendMessage à chaque pair : utilise-t-il le magasin, et a-t-il besoin du mode ? Attendre la réponse. Si un pair en a besoin, utiliser l'autre magasin ou demander à Dave.
  2. Lire d'abord le mode : NODE_OPTIONS='-r dotenv/config' npm run --silent manage-org -- info <id> depuis le dossier de l'application.
  3. Le modifier uniquement pour les minutes d'une session de capture, dans la même chaîne de commandes que la capture et la restauration. Puis le relire et confirmer.
  4. Ne jamais toucher à un magasin client. Ne jamais modifier les préférences d'un compte de test.

Étape 3 : Capture

  • Images fixes : dpr: 3. Une image par carte, prise après que l'écran se soit stabilisé.
  • Clips : dpr: 2 avec vt.recorder. Ouvrir chaque clip avec un temps d'arrêt, montrer le marqueur de doigt, puis agir. Lire marks.json pour choisir footage.runs.
  • La dictée est réelle. vt.dictation joue un clip parlé dans un faux micro ; l'application l'enregistre et le transcrit. Imprimer chaque transcription et la lire : le transcripteur réécrit les nombres et les noms de marque.
  • Une reprise nécessite un nouveau bon de réparation. Les numéroter vers le haut et lister chaque identifiant dans created-ros.txt.

Étape 4 : Diapositives

node scripts/build-slides.mjs <project> écrit out/slides/*.png, le PDF, et les couches nécessaires à la vidéo. Regarder une planche contact de chaque carte. Vérifier qu'aucune légende ne couvre l'élément qu'elle pointe.

Étape 5 : Narration

cd /Users/davidsonders/ro-bot/app
NODE_OPTIONS='-r dotenv/config' node ~/.claude/skills/video-training/scripts/narrate.mjs <project>

Voix ash, modèle gpt-audio-1.5 (remplacé gpt-4o-mini-tts, qu'OpenAI désactive le 2027-01-06). Une prise dont la transcription ne correspond pas aux mots de la carte est réessayée, puis refusée. Dave a approuvé cette voix et rejeté les voix intégrées du Mac comme robotiques. Elle utilise la clé OpenAI de l'application et coûte quelques centimes par construction : le dire dans le brief pour chaque nouvelle vidéo, pour que la dépense ne soit jamais une surprise. DRY=1 liste ce qui serait régénéré.

Écrire la narration pour l'oreille : « R O », « trois C », « tenthgear point A I ». Annoncer chaque partie sur sa première carte.

Étape 6 : Vidéo

node scripts/build-video.mjs <project>. La vitesse est de 1,25 (le « Rapide » de QuickTime), le rythme approuvé par Dave. Une carte avec un clip dure aussi longtemps que le plus long de sa narration et de son clip.

Étape 7 : Vérifier, et dire ce qui n'a pas été vérifié

  1. check-audio.mjs transcrit la vidéo et note chaque carte. Lire chaque ligne LOOK.
  2. Extraire une image de chaque carte qui a un clip ou une flèche et la regarder.
  3. Dans le retour, dire clairement : pas écouté, pas regardé en entier.

Étape 8 : Livrer

Copier la vidéo, le PDF et out/slides/ vers ~/Desktop/<Titre>/. Conserver les versions précédentes. Donner la durée, ce qui a changé, et tout ce que Dave pourrait remarquer (un numéro de bon de réparation différent dans un clip, une légende déposée sur une séquence).

Étape 9 : Nettoyer

  • Mode du magasin restauré, puis relu et confirmé.
  • node scripts/close-ros.mjs <project> <email> <org-id> ferme les reprises. La suppression des bons de réparation est la décision de Dave.
  • Dire à tout pair à qui vous avez envoyé un message que le magasin est libre.

Règles de style (Dave, 2026-09-29)

RègleExemple
Un bouton que le spectateur tape est dessiné comme un boutonAppuyer sur [[Nouveau BR]]
Les en-têtes de partie sont courts, sans « of 3 »PARTIE 2 : HISTOIRE DE GARANTIE
La couverture n'a pas de nombre d'étapes
Une carte par étape. Fusionner les cartes qui montrent une seule décision.Réviser et enregistrer sont une seule carte
Supprimer une carte dont le point est évidentLire Cause et Correction
Dire qui agit et avec quoi« Ajouter une note vocale », pas « Ajouter une note »
Lorsque deux choses à l'écran pourraient être visées, pointer sur l'uneFlèche sur le bouton vert
Tout ce qui bouge dans l'application doit bouger dans la vidéoForme d'onde, spinner, ouverture de carte
Mots d'atelierBR, ligne, histoire, 3C, CP

Dave donne les modifications de diapositives par numéro de page PDF. La page 1 est la couverture, donc « pg 7 » correspond à l'étape 6. Reformuler chaque modification par nom d'étape avant de l'appliquer.

Critères de succès

  • Dave a modifié le canevas du storyboard et ses modifications ont été récupérées, pas devinées
  • Chaque image et clip provient de l'application réelle, dans le mode de la vidéo concernée
  • Diapositives, PDF et vidéo proviennent tous du même storyboard.json
  • Narration vérifiée par transcription ; lignes peu claires nommées
  • Le retour indique ce qui n'a pas été écouté ou regardé
  • Mode du magasin restauré et confirmé ; bons de réparation de reprise fermés
  • Dossier du projet conservé en dehors du scratchpad

Compétences associées

  • /visual pour les maquettes d'écrans qui n'existent pas encore
  • /app-testing pour les comptes de test et le harnais de test en direct que cela emprunte
  • /compound ensuite, si une capture a révélé un bug produit ou un nouveau piège

Skills associés