Communitygithub.com

dbillion/hermes-skills-public

Utilisez la boucle de développement CLI HyperFrames : init, add, catalog, capture, lint, check, snapshot, compare, grade-compare, preview, play, present, beats, keyframes, single ou batch render, publish, cloud, cloudrun, feedback, lambda, doctor, browser, info, upgrade, skills, compositions, docs, benchmark, telemetry, transcribe, auth, tts, et remove-background. Également utile pour diagnostiquer les échecs de build ou de rendu. validate, inspect et layout sont des alias obsolètes ; utilisez check. Couvre le rendu local, cloud hébergé par HeyGen, AWS Lambda et Google Cloud Run.

Qu'est-ce que hermes-skills-public ?

Cette compétence fournit l'interface en ligne de commande (CLI) HyperFrames, un outil de développement puissant pour créer, tester et déployer des compositions vidéo et des présentations animées. Elle est conçue pour les développeurs et les agents IA qui souhaitent automatiser le flux de travail de production vidéo, de l'échafaudage initial au rendu final sur différentes plateformes, y compris localement, sur le cloud HeyGen, AWS Lambda et Google Cloud Run. La compétence prend en charge une boucle de développement itérative complète comprenant l'initialisation, la rédaction, le linting, la vérification, la prévisualisation, le rendu et la publication. Elle permet également la capture de sites web, la gestion des sous-compositions, les tests instantanés, les comparaisons de rendu, les présentations en direct, l'édition rythmique, les images clés et la soumission de commentaires. L'agent est invité à lire la documentation de référence appropriée avant d'exécuter des commandes, garantissant une utilisation correcte et efficace de l'outil. Des modes dédiés pour les agents (--json) et l'intégration continue (non-TTY) sont intégrés, tout comme des fonctions de diagnostic qui aident à identifier et à résoudre les problèmes de construction et de rendu.

Compatible avec~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/dbillion/hermes-skills-public/tree/HEAD/skills-external/hyperframes-cli

Demander à votre IA préférée

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

Documentation

CLI HyperFrames

Exécutez les commandes sous la forme npx hyperframes ... sauf si les instructions du projet fournissent un wrapper. Obéissez au wrapper lorsqu'il est présent. La CLI nécessite Node.js 22 ou plus récent et FFmpeg.

Boucle de développement

  1. Échafaudage : npx hyperframes init <projet> ou capturez un site. En mode non-TTY, passez --non-interactive --example=<nom>.
  2. Rédaction : écrivez la composition en utilisant /hyperframes-core.
  3. Obtenez des retours rapides pendant l'édition : exécutez npx hyperframes lint après le premier passage HTML et après les changements structurels.
  4. Exécutez la porte finale : exécutez npx hyperframes check ; il relance lint avant d'ouvrir le navigateur. N'ajoutez pas d'appel lint autonome redondant. Ajoutez --snapshots pour des images d'aperçu annotées et la recherche de recadrages.
  5. Inspectez les sous-compositions : lorsque index.html monte data-composition-src, capturez des instantanés à mi-parcours et inspectez chaque scène montée.
  6. Ouvrez l'aperçu final du Studio : exécutez npx hyperframes preview, remettez l'URL du projet de timeline à l'utilisateur, et demandez s'il faut réviser ou rendre.
  7. Rendu seulement après approbation : utilisez la qualité brouillon pour l'itération et la haute qualité pour la livraison.
  8. Vérifiez la sortie : confirmez que le fichier existe, n'est pas vide et a une durée plausible.
# Vérification rapide d'itération ; répétez au besoin pendant la rédaction.
npx hyperframes lint

# Porte finale obligatoire ; inclut lint.
npx hyperframes check
npx hyperframes preview
npx hyperframes render --quality high --output out.mp4
test -s out.mp4
ffprobe -v error -show_format out.mp4

check exécute d'abord lint, puis utilise une session de navigateur et un passage de recherche pour auditer les erreurs d'exécution, les requêtes échouées, la disposition, les assertions *.motion.json et le contraste WCAG. Les constats persistants conditionnent le code de sortie ; les constats transitoires à l'entrée ou à la sortie sont informatifs. Utilisez --strict pour conditionner les avertissements. validate, inspect, et layout restent des alias pour la compatibilité mais ne doivent pas apparaître dans les nouvelles instructions ou scripts.

Deux surfaces d'aperçu différentes

Ne confondez pas ces états :

SurfaceQuand elle peut s'ouvrirObjectif
Tableau d'histoireAvant les vérifications de composition, seulement si storyboard: yesExaminer les fiches de plan et les croquis de maquette. Ouvrir ?view=storyboard#project/<nom>.
Aperçu final de compositionAprès que check réussisseExaminer la timeline assemblée avant le rendu. Ouvrir #project/<nom>.

Le tableau précoce n'est pas une approbation de la vidéo finale. Le rendu nécessite toujours l'approbation finale définie par hyperframes-core/references/review-loop.md.

Test de fumée des sous-compositions

Les audits statiques ne peuvent pas détecter tous les échecs de montage. Lorsque le projet utilise des sous-compositions, capturez au moins un point médian visible pour chaque emplacement hôte :

npx hyperframes snapshot --at <t1>,<t2>,<t3>

Traitez le contenu minuscule non stylé, les icônes de taille de canevas, les éléments héros manquants ou les délais d'enregistrement de timeline comme des défauts de montage bloquant le rendu. Voir hyperframes-core/references/sub-compositions.md pour les correctifs correspondants.

Conventions pour les agents

  • Préférez --json pour les appels d'agent et d'IC. Les render, preview, et play en mode serveur ne fournissent pas de sortie JSON ordinaire ; preview --selection --json et preview --context --json sont des exceptions en mode requête.

  • doctor --json se termine toujours par zéro. Conditionnez-vous sur sa charge utile :

    npx hyperframes doctor --json | jq -e '.ok' >/dev/null
    
  • Le mode non-TTY est automatique. init nécessite --example là-bas ; utilisez --non-interactive pour forcer un comportement déterministe sur un TTY.

  • Utilisez un HYPERFRAMES_RUN_ID pour toutes les commandes dans la même boucle de vérification.

  • Utilisez --strict, --strict-all, et --strict-variables lorsque les avertissements, variables ou conditions CI correspondants doivent conditionner le rendu.

  • Les chemins JSON masquent le répertoire personnel en tant que $HOME ; n'essayez pas d'inverser le masquage.

  • Ne rendez jamais simplement parce que les vérifications réussissent. Faites une pause à l'aperçu final et attendez l'approbation.

Modifications dirigées par le Studio

Lorsque l'utilisateur fait référence à « cet élément » ou à la sélection en cours, interrogez le Studio au lieu de deviner :

npx hyperframes preview --context --json --context-fields selection

Utilisez selection.target.hfId lorsqu'il est disponible, sinon son sélecteur et son fichier source. Si le résultat rapporte no-selection, demandez à l'utilisateur de cliquer sur l'élément et de réexécuter. Ne demandez que les tranches de contexte dont vous avez besoin ; utilisez --context-detail full uniquement pour les styles calculés ou les métadonnées de texte modifiables. Le comportement complet et les codes d'échec se trouvent dans references/preview-render.md.

Choix de rendu

BesoinCommande
Itération locale rapidenpx hyperframes render --quality draft
Livraison locale finalenpx hyperframes render --quality high --output out.mp4
Rendu conteneur reproductiblenpx hyperframes render --docker --strict --output out.mp4
Rendu par lots local piloté par variablesnpx hyperframes render --batch rows.json --output "renders/{nom}.mp4"
Rendu hébergé HeyGen sans infrastructurenpx hyperframes cloud render
Rendu AWS distribué auto-gérénpx hyperframes lambda render <projet> --width 1920 --height 1080 --wait
Rendu GCP distribué auto-gérénpx hyperframes cloudrun render <projet> --width 1920 --height 1080 --wait

Utilisez le rendu cloud lorsque l'utilisateur souhaite un rendu hébergé sans Chrome local, FFmpeg ou AWS. Utilisez Lambda uniquement lorsque la propriété AWS est une exigence. Utilisez Cloud Run uniquement lorsque la propriété GCP est une exigence. Lisez la référence correspondante avant d'exécuter un chemin cloud.

Après avoir vérifié un rendu réussi, envoyez un rapport de feedback sauf si la télémétrie est désactivée ou que l'utilisateur s'est désisté :

npx hyperframes feedback --rating <0-10> --comment "<résultat ou friction spécifique>"

Gardez les feedbacks pour une exécution propre concis. Pour tout bogue ou friction, capturez un paquet de reproduction avant de soumettre ; n'envoyez pas seulement un résumé des symptômes. Incluez la commande réexécutable et le répertoire de travail, le comportement attendu par rapport au réel, l'erreur exacte, si la sortie est terminée/repliée/échouée, la solution de contournement et l'état du projet de reproduction. Si le problème ne s'est pas reproduit, dites-le et incluez quand même la dernière commande ayant échoué et les logs. Utilisez --file-issue uniquement avec consentement : il publie une reproduction minimale sur une URL publique. Le format requis du paquet et l'avertissement de confidentialité se trouvent dans references/preview-render.md.

Lisez la référence correspondante avant d'exécuter une commande

Les références suivantes et les compétences propriétaires sont des contrats de commande obligatoires, pas une lecture de fond optionnelle. Avant d'exécuter une commande dans le tableau, lisez sa ligne correspondante.

BesoinRéférence
init, capture, skillsreferences/init-and-scaffold.md
lint, check, side-cars de mouvement, snapshotreferences/lint-validate-inspect.md
compare, grade-compare, render --batch piloté par variablesreferences/compare-and-batch.md
beats pour la grille de beats du Studio d'un projet existantreferences/beats.md
preview, play, render, publish, contexte du Studio, feedbackreferences/preview-render.md
doctor, gestion du navigateurreferences/doctor-browser.md
auth, rendu cloud hébergé par HeyGen et variables de modèlereferences/cloud.md
Déploiement et rendu AWS Lambdareferences/lambda.md
Déploiement et rendu Google Cloud Runreferences/cloudrun.md
info, upgrade, compositions, docs, benchmark, télémétrie, prétraitement médiareferences/upgrade-info-misc.md

Pour les variables de composition, lisez aussi /hyperframes-core → references/variables-and-media.md. Pour hyperframes add et hyperframes catalog, utilisez /hyperframes-registry. Avant hyperframes present, lisez /slideshow ; avant hyperframes keyframes, lisez /hyperframes-keyframes. Pour la TTS, la transcription, les sous-titres ou les choix de suppression d'arrière-plan, utilisez /media-use.

Les commandes spécialisées sont délibérément documentées par leurs workflows propriétaires :

npx hyperframes present <répertoire-projet> --port 3004 --no-open
npx hyperframes beats <répertoire-projet> --json
npx hyperframes keyframes <répertoire-projet> --json

present sert un deck navigable avec synchronisation présentateur et audience. beats est l'utilitaire autonome de grille de beats du Studio défini dans references/beats.md. keyframes expose des diagnostics de détection et de chemin de mouvement pour l'animation.

Individual skills in this repo

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

dbillion/hermes-skills-public

Edit an existing image based on a text prompt.

dbillion/hermes-skills-public

Add `flutter_localizations` and `intl` dependencies, enable "generate true" in `pubspec.yaml`, and create an `l10n.yaml` configuration file. Use when initializing localization support for a new Flutter project.

dbillion/hermes-skills-public

Expert in video composition, editing, and format conversion. Use when the user wants to generate high-quality video, overlay images on video, concatenate clips, create GIFs, or sync audio to video using mcp-avtool-go and mcp-veo-go.

dbillion/hermes-skills-public

All animation knowledge for HyperFrames — atomic motion rules, multi-phase scene blueprints, scene transitions, broader motion-design techniques, AND the seven runtime adapters (GSAP default, plus Lottie, Three.js, Anime.js, CSS keyframes, Web Animations API, TypeGPU). Use for any motion or animation task: pick 2-4 rules and compose, or load a blueprint, or look up runtime-specific API (e.g. GSAP eases / Lottie player / Three.js mixer). Also covers auditing an existing composition's choreography (animation map) and 24 named text-animation effects. HyperFrames-native: single paused timeline, seek-safe, deterministic.

dbillion/hermes-skills-public

The HyperFrames composition contract — build one renderable project. Use for composition structure, the `data-*` timing attributes, `class="clip"`, tracks, sub-compositions, variables, framework-owned media playback, deterministic-render rules, and validation. Also covers Tailwind projects and the STORYBOARD.md / SCRIPT.md plan formats. Read before writing composition HTML.

dbillion/hermes-skills-public

Non-animation creative direction for HyperFrames videos. Use for design spec (frame.md / design.md) handling, palettes, typography, narration, beat planning, audio-reactive visuals, composition patterns, and brand / style decisions. For atomic motion patterns and scene blueprints, use `hyperframes-animation`.

Skills associés