hyperframes-registry

Vue d’ensemble du skill hyperframes-registry

Ce que fait hyperframes-registry

Le skill hyperframes-registry vous aide à installer et à raccorder des éléments réutilisables du registre HyperFrames avec moins d’hésitation qu’avec un prompt générique. Il est conçu pour la vraie tâche qui consiste à transformer la sortie de hyperframes add <name> en composition fonctionnelle, que vous ajoutiez un block, fusionniez un component ou vérifiiez ce qui existe déjà dans le registry.

Cas d’usage les plus adaptés

Utilisez le skill hyperframes-registry quand vous avez besoin d’un hyperframes-registry guide pratique pour :

• installer un élément du registry dans un projet existant
• décider si un élément est un block ou un component
• raccorder les fichiers installés dans index.html
• lire les correspondances de chemins dans hyperframes.json
• découvrir des éléments du registry avant de vous engager

Ce qui le distingue

Ce skill est particulièrement utile quand le chemin d’installation, le type de fichier et les étapes d’intégration comptent vraiment. Les blocks fonctionnent comme des sous-compositions autonomes, avec leurs propres dimensions et leur propre timeline ; les components sont des extraits qui se fondent dans la composition hôte. C’est ce point de décision central que le skill hyperframes-registry clarifie avant que vous ne modifiiez les fichiers.

Comment utiliser le skill hyperframes-registry

Installer et examiner les bons fichiers

Pour hyperframes-registry install, utilisez le skill avec l’arborescence du dépôt, pas à la place de celle-ci. Commencez par l’élément que vous installez, puis lisez :

• SKILL.md pour le workflow
• references/discovery.md pour la recherche dans le registry et les champs du manifest
• references/install-locations.md pour les chemins par défaut et le remapping via hyperframes.json
• references/wiring-blocks.md ou references/wiring-components.md selon le type d’élément
• examples/add-block.md et examples/add-component.md pour des patterns de bout en bout

Transformer une demande vague en bon prompt

Le meilleur hyperframes-registry usage commence par un objectif précis, pas seulement par un nom. Une bonne demande inclut :

• le nom de l’élément
• si vous voulez un block ou un component
• l’endroit où il doit se trouver dans le projet
• si vous l’intégrez dans une composition existante ou si vous repartez de zéro
• tout remapping de chemins dans hyperframes.json

Exemple de prompt :
Install data-chart into my HyperFrames project, wire it into index.html, and tell me which files and attributes need updating.

Workflow qui évite les erreurs courantes

Un hyperframes-registry guide fiable suit cette logique :

1. Exécutez hyperframes add <name> dans le projet.
2. Vérifiez les fichiers écrits et l’extrait affiché par la CLI.
3. Confirmez si l’élément est un block ou un component.
4. Raccordez les blocks avec data-composition-src, data-start, data-duration et data-track-index.
5. Fusionnez les components dans le HTML, le CSS et le JS comme l’indique l’extrait.
6. Mettez à jour les chemins si votre projet remappe hyperframes.json#paths.

Conseils pratiques pour améliorer la qualité

Pour obtenir un meilleur résultat, dites au skill ce que contient déjà votre composition. Par exemple, précisez la taille du canvas, la longueur de la timeline et si vous avez déjà un data-composition-id hôte. C’est important pour hyperframes-registry for Design Implementation, parce que les blocks doivent s’aligner sur la mise en page de l’hôte et que les components doivent s’intégrer à la timeline et aux styles existants.

FAQ du skill hyperframes-registry

Est-ce réservé aux tâches d’installation ?

Dans l’ensemble, oui. Le skill hyperframes-registry est pensé pour les décisions d’installation, de découverte et de raccordement. Si vous voulez seulement une explication conceptuelle de HyperFrames, un prompt simple suffit. Si vous avez besoin de chemins de fichiers réels et d’étapes d’intégration, le skill est plus adapté.

Quelle est la différence entre un block et un component ?

Un block est une composition complète avec ses propres dimensions et sa propre durée, destinée à être intégrée avec data-composition-src. Un component est un extrait que vous insérez dans une composition existante. Si vous avez besoin d’une temporalité indépendante ou d’un canvas séparé, choisissez un block. Si vous voulez un effet qui se fond dans la scène courante, choisissez un component.

Faut-il connaître le dépôt à l’avance quand on débute ?

Non. Le skill reste accessible si vous savez formuler l’objectif : « installer cet élément et le raccorder ». Le principal risque pour les débutants est d’omettre l’étape de wiring après hyperframes add. Les références du repo réduisent ce risque en montrant exactement où regarder ensuite.

Quand ne faut-il pas utiliser ce skill ?

N’utilisez pas hyperframes-registry si vous ne travaillez pas avec le registry HyperFrames, si vous n’installez rien, ou si vous connaissez déjà les modifications exactes à faire et que vous avez seulement besoin d’une reformulation très courte du prompt. Il est surtout utile lorsque la décision d’installation et les détails d’intégration ne sont pas encore tranchés.

Comment améliorer le skill hyperframes-registry

Donner au skill les contraintes manquantes

Le gain de qualité le plus important vient du fait d’indiquer à hyperframes-registry ce qu’attend la composition cible. Précisez la taille du canvas, la durée de la timeline, vos préférences de dossier d’installation et le fait que le projet hôte utilise les chemins par défaut compositions/ ou des chemins remappés. Cela évite les incohérences de chemins et les hypothèses erronées sur le wiring.

Montrer la surface d’intégration exacte

Pour un meilleur hyperframes-registry usage, collez la partie pertinente de votre composition hôte ou décrivez-la précisément :

• le conteneur index.html
• le data-composition-id existant
• le point de départ actuel de la timeline GSAP
• tout élément wrapper ou toute couche déjà en place

C’est particulièrement important pour le wiring des blocks, car l’emplacement et l’ordre des couches déterminent si l’élément ajouté se comporte correctement.

Itérer à partir du premier résultat

Si le premier résultat est proche mais pas encore prêt, affinez la demande en réclamant l’un de ces éléments :

• un chemin d’installation corrigé à partir de hyperframes.json
• uniquement un extrait de wiring minimal
• une recommandation block vs component pour le même objectif visuel
• un plan de fusion qui sépare les étapes HTML, CSS et JS

Cette boucle de retour est la façon la plus rapide d’améliorer les résultats de hyperframes-registry sans surcharger le prompt initial.