hyperframes-registry

Überblick über die hyperframes-registry-Skill

Was hyperframes-registry macht

Die hyperframes-registry-Skill hilft dir dabei, wiederverwendbare HyperFrames-Registry-Elemente mit deutlich weniger Rätselraten zu installieren und sauber einzubinden als mit einem allgemeinen Prompt. Sie ist für die praktische Aufgabe gebaut, die Ausgabe von hyperframes add <name> in eine funktionierende Komposition zu überführen — egal, ob du einen Block hinzufügst, eine Komponente einfügst oder zuerst prüfst, was in der Registry überhaupt verfügbar ist.

Ideale Anwendungsfälle

Nutze die hyperframes-registry-Skill, wenn du einen praxisnahen hyperframes-registry guide brauchst für:

• das Installieren eines Registry-Elements in ein bestehendes Projekt
• die Entscheidung, ob ein Element ein Block oder eine Komponente ist
• das Einbinden installierter Dateien in index.html
• das Lesen von Pfadzuordnungen in hyperframes.json
• das Entdecken von Registry-Elementen, bevor du dich festlegst

Was sie anders macht

Die Skill ist besonders stark, wenn Installationspfad, Dateityp und Integrationsschritte entscheidend sind. Blocks verhalten sich wie eigenständige Sub-Kompositionen mit eigenen Abmessungen und eigener Timeline; Komponenten sind Snippets, die in die Host-Komposition übernommen werden. Genau diese Unterscheidung ist der zentrale Entscheidungspunkt, den die hyperframes-registry-Skill vor dem Bearbeiten der Dateien klärt.

So verwendest du die hyperframes-registry-Skill

Die richtigen Dateien installieren und prüfen

Für hyperframes-registry install solltest du die Skill zusammen mit dem Repository-Layout verwenden, nicht anstelle davon. Starte mit dem Element, das du installieren willst, und lies dann:

• SKILL.md für den Workflow
• references/discovery.md für Registry-Suche und Manifest-Felder
• references/install-locations.md für Standardpfade und hyperframes.json-Umleitungen
• references/wiring-blocks.md oder references/wiring-components.md je nach Elementtyp
• examples/add-block.md und examples/add-component.md für End-to-End-Muster

Eine grobe Anfrage in einen guten Prompt verwandeln

Die beste hyperframes-registry usage beginnt mit einem konkreten Ziel, nicht nur mit einem Namen. Starke Eingaben enthalten:

• den Namen des Elements
• ob du einen Block oder eine Komponente willst
• wo es im Projekt liegen soll
• ob du in eine bestehende Komposition einbindest oder ganz neu startest
• eventuelle Pfadumleitungen in hyperframes.json

Beispiel für die Prompt-Struktur:
Install data-chart into my HyperFrames project, wire it into index.html, and tell me which files and attributes need updating.

Workflow, der typische Fehler vermeidet

Ein verlässlicher hyperframes-registry guide sieht so aus:

1. hyperframes add <name> im Projekt ausführen.
2. Die geschriebenen Dateien und das vom CLI ausgegebene Snippet prüfen.
3. Verifizieren, ob das Element ein Block oder eine Komponente ist.
4. Blocks mit data-composition-src, data-start, data-duration und data-track-index anbinden.
5. Komponenten dort in HTML, CSS und JS zusammenführen, wo das Snippet es vorgibt.
6. Pfade anpassen, falls dein Projekt hyperframes.json#paths überschreibt.

Praktische Qualitätstipps

Für bessere Ergebnisse solltest du der Skill sagen, was in deiner Komposition bereits vorhanden ist. Nenne zum Beispiel die bestehende Canvas-Größe, die Timeline-Länge und ob schon eine Host-data-composition-id existiert. Das ist wichtig für hyperframes-registry for Design Implementation, weil Blocks zum Host-Layout passen müssen und Komponenten in die aktuelle Timeline und die vorhandenen Styles eingebettet werden müssen.

Häufige Fragen zur hyperframes-registry-Skill

Ist das nur für Installationsaufgaben gedacht?

Meistens ja. Die hyperframes-registry-Skill ist auf Installations-, Entdeckungs- und Wiring-Entscheidungen ausgelegt. Wenn du nur eine konzeptionelle Erklärung von HyperFrames willst, reicht ein normaler Prompt. Wenn du konkrete Dateipfade und Integrationsschritte brauchst, passt die Skill deutlich besser.

Worin unterscheidet sich ein Block von einer Komponente?

Ein Block ist eine vollständige Komposition mit eigenen Abmessungen und eigener Dauer, die mit data-composition-src eingebettet wird. Eine Komponente ist ein Snippet, das du in eine bestehende Komposition einfügst. Wenn du unabhängiges Timing oder eine separate Canvas brauchst, nimm einen Block. Wenn du einen Effekt brauchst, der sich in die aktuelle Szene einfügt, nimm eine Komponente.

Müssen Einsteiger das Repo schon kennen?

Nein. Die Skill ist auch für Einsteiger gut geeignet, wenn du das Ziel benennen kannst: „Dieses Element installieren und korrekt einbinden.“ Das größte Einsteiger-Risiko ist, nach hyperframes add den Wiring-Schritt zu überspringen. Die Repo-Referenzen verringern dieses Risiko, weil sie genau zeigen, wo du als Nächstes nachsehen musst.

Wann sollte ich die Skill nicht verwenden?

Verwende hyperframes-registry nicht, wenn du gar nicht mit der HyperFrames-Registry arbeitest, nichts installieren willst oder die exakten Dateianpassungen bereits kennst und nur eine kleine Prompt-Umformulierung brauchst. Am nützlichsten ist sie, wenn Installationsentscheidung und Integrationsdetails noch offen sind.

So verbesserst du die hyperframes-registry-Skill

Gib der Skill die fehlenden Rahmenbedingungen

Der größte Qualitätssprung entsteht, wenn du hyperframes-registry sagst, was die Zielkomposition erwartet. Nenne Canvas-Größe, Timeline-Dauer, Präferenzen für das Installationsverzeichnis und ob das Host-Projekt Standardpfade wie compositions/ verwendet oder umgeleitete Pfade. So vermeidest du unpassende Pfade und falsche Wiring-Annahmen.

Zeig die konkrete Integrationsfläche

Für eine bessere hyperframes-registry usage solltest du den relevanten Teil deiner Host-Komposition einfügen oder präzise beschreiben:

• den index.html-Container
• eine vorhandene data-composition-id
• den aktuellen GSAP-Timeline-Startzeitpunkt
• eventuell schon verwendete Wrapper-Elemente oder Layer

Das ist besonders wichtig beim Wiring von Blocks, weil Positionierung und Layer-Reihenfolge beeinflussen, ob das hinzugefügte Element korrekt funktioniert.

Vom ersten Ergebnis aus weiter verfeinern

Wenn das erste Ergebnis fast passt, aber noch nicht fertig ist, verfeinere mit einer dieser Anfragen:

• ein korrigierter Installationspfad auf Basis von hyperframes.json
• nur ein minimales Wiring-Snippet
• eine Block-vs.-Component-Empfehlung für dasselbe visuelle Ziel
• ein Merge-Plan, der HTML-, CSS- und JS-Schritte trennt

Dieser Feedback-Loop ist der schnellste Weg, die Ergebnisse von hyperframes-registry zu verbessern, ohne den ersten Prompt zu überladen.