Skill für Halo-Design
Halo ist eine Art zu gestalten, kein zu kopierendes Theme. Es legt die Grammatik fest (Tokens, Typografie, Bewegung, Barrierefreiheit, zweisprachiges Layout, Qualitätssicherung) und überlässt den Charakter des Produkts dir: seiner eigenen visuellen Signatur, den Akzentbedeutungen, Illustrationen, Texten und Klängen. Der Trainingsplan in examples/ und die beiden Vorlagen sind Demonstrationen der Mechanik, keine wiederzuverwendenden Inhalte.
Grundregeln
- Pro Produkt gestalten. Schreibe zuerst den Brief (
templates/brief.md) und wähle eine visuelle Signatur, die zu diesem Produkt passt (docs/00-creative-direction.md). Ringe, Übungspiktogramme und Trainingsinhalte sind nur dann richtig, wenn das Produkt sich um das Schließen täglicher Ziele dreht. - Plattform → Halo → bewährte Bibliothek. Niemals eigene Mechanismen erfinden (
docs/16-libraries.md). - Tokens sind die einzige Quelle für Farbe, Kurve und Radius. Keine Farb-Literale außerhalb von
tokens/tokens.css;scripts/check_skill.pyerzwingt dies für Halo-CSS. - Beide Themes, beide Richtungen, jeder Breakpoint werden entworfen und getestet.
- Zahlen zuerst: graues Label → großer Akzentwert → einfacher Satz. Visualisierungen wiederholen die Zahl, ersetzen sie nie.
- Bewegung ist leicht: eine Kurve, einmal aufdecken, nichts wiederholt sich, reduzierter Bewegung sicher. Live-Daten aktualisieren sich an Ort und Stelle und animieren nie neu.
- Keine Logos. Der Markenplatz ist der Name des Produkts in Text. Verwende ein Zeichen nur, wenn der Benutzer eines bereitstellt.
- Fertig bedeutet Qualitätssicherung bestanden (
docs/13-qa.md).
Nur lesen, was die Aufgabe benötigt
Die Dokumente sind kurz (jeweils unter 1.500 Tokens). Lies nicht alles; navigiere nach Aufgabe:
| Aufgabe | Lesen | Start von |
|---|---|---|
| Neues Produkt oder neue Seite | docs/00, docs/02, docs/03, docs/05 | templates/starter.html (persönliche App) oder templates/dashboard.html (Daten / Betrieb) |
| Datenintensiver Bildschirm | docs/10, docs/04 | templates/dashboard.html |
| Kurdisch / Arabisch / Persisch | docs/08, docs/03 | beide Vorlagen mit lang=ckb |
| Optimierung für Mobilgeräte | docs/07 | — |
| Bewegung, Randlicht, Scrollen | docs/06 | — |
| Klang | docs/14 | js/halo-sound.js |
| Symbole oder Illustrationen | icons/README.md, docs/09 | icons/ |
| Gedrucktes Dokument oder PDF | docs/11 | templates/print-a4.html |
| React / Next / Tailwind / Vue | docs/17 | — |
| Auswahl einer Bibliothek | docs/16 | — |
| Figma oder Design-Tokens für andere Werkzeuge | docs/15, tokens/*.tokens.json | — |
| Barrierefreiheit | docs/12 | — |
| Testen | docs/13 | qa/ |
Lies niemals examples/workout-plan/index.html vollständig (ca. 42.000 Tokens). Durchsuche es stattdessen nach einem bestimmten Muster (grep -n "restTimer" …).
Arbeitsablauf
- Brief. Fülle
templates/brief.mdaus: für wen es ist, was sie immer wieder überprüfen, die 1–3 Heldenzahlen, die visuelle Signatur, Akzentbedeutungen, Illustrationssprache, Bewegungs- und Klangintensität, Oberflächen, Sprachen und Abschnitte. Wenn die Anfrage unklar ist, zeige den Brief und stelle eine Frage; andernfalls fasse ihn in einem kurzen Absatz zusammen und baue. - Grundlage. Verlinke
tokens/tokens.css,css/halo.css,js/halo.js(plusjs/halo-sound.jsnur wenn der Brief Klang vorsieht) und rufeHalo.init({dict})auf. Schriftarten: Google Sans + IBM Plex Sans Arabic (docs/03). - Abschnitte komponieren aus den Komponenten in
docs/05:- Baue die visuelle Signatur mit vorhandenen Elementen:
Halo.rings,Halo.spark,.metermit einer.targetMarkierung,.bars,.timeline, dem Status-Raster oder einem typografischen Helden. Oder erfinde eine, die den Regeln indocs/00folgt. - Ersetze alle Vorlageninhalte. Wenn deine Seite „Schließe die Ringe“ oder „GPUs gesund“ sagt und das Produkt nicht davon handelt, hast du kopiert.
- Baue die visuelle Signatur mit vorhandenen Elementen:
- Ausbalancieren von Mobilgerät und Laptop separat (
docs/04,docs/07). - Zweisprachig: Jeder String kommt ins Wörterbuch, mit RTL-Regeln aus
docs/08. Wenn du selbst Kurdisch schreibst, teile dem Benutzer dies mit und empfehle eine muttersprachliche Überprüfung. - Bewegung und Klang in der im Brief gewählten Intensität (
docs/06,docs/14). - Qualitätssicherung, über http bereitgestellt:
Füge die eigenen Interaktionsprüfungen des Produkts und axe-core hinzu. Überprüfe Screenshots bei 390 und 1440 in beiden Themes.python3 qa/qa_layout.py http://localhost:8000/page.html # 9 Breiten × 2 Themes × 2 Sprachen python3 qa/qa_touch.py http://localhost:8000/page.html # Tests für Touch-Geräte - Drucken falls erforderlich: HTML →
scripts/print_pdf.py→qpdfzusammenführen →scripts/verify_pdf.sh(0 Bilder)..ttf-Schriftarten einbetten.
Checkliste vor der Auslieferung
- Ein Brief existiert und die visuelle Signatur passt zum Produkt (nicht standardmäßig Ringe, keine kopierten Inhalte).
- Höchstens drei Akzentbedeutungen, konsistent verwendet; Textakzente verwenden
--XT. - Keine Farb-Literale außerhalb der Tokens; kein Logo, das der Benutzer nicht bereitgestellt hat.
- Laptop: ausgewogene Spalten, ausgerichtete Fußzeilen, Diagramme füllen ihre Karten. Mobilgerät: ≤ 4 Navigationssteuerungen, 44 px Ziele, kein horizontales Scrollen bei 320.
- RTL:
dir/lang, umgekehrte Chevrons, gespiegelte Diagramme,<bdi>um lateinische Begriffe und lateinische Einheiten. - Reduzierte Bewegung respektiert; Klang (falls vorhanden) hat einen Umschalter und ist nie das einzige Signal.
- Quellen für Tatsachenbehauptungen verlinkt; Rückgängig für destruktive Aktionen.
-
qa_layout.pyundqa_touch.pybestehen; keine Konsolenfehler; PDFs als Vektoren verifiziert.
Reproduzierbarkeit
make setupinstalliert festgelegte Abhängigkeiten (requirements.txt) und Chromium.make checkvalidiert das Skill selbst: Links, Tokens synchron, keine verstreuten Farben, keine Logos, JS-Syntax, Frontmatter.make qatestet jede Vorlage und das Beispiel;make assetsrendert die README-Bilder neu;make tokensbaut das DTCG-JSON neu.- CI führt das Gleiche in
.github/workflows/qa.ymlaus.
Dateizuordnung
| Pfad | Was |
|---|---|
docs/00-creative-direction.md | Zuerst lesen. Brief, Katalog der visuellen Signaturen, Akzentbedeutungen, Illustrationssprache, Anti-Patterns |
templates/brief.md | Der auszufüllende Brief |
templates/starter.html | Mechanik für persönliche Apps: geteilter Held, Ringe, Aufgaben, Timer, Tabelle, Klang |
templates/dashboard.html | Mechanik für Daten/Betrieb: Status-Raster, Sparklines, Messgeräte mit Zielen, Live-Updates, ruhige Bewegung |
templates/print-a4.html | Vektordruckseite |
tokens/ | tokens.css (Quelle der Wahrheit) + DTCG 2025.10 JSON |
css/halo.css · js/halo.js · js/halo-sound.js | Komponenten · Laufzeit · ruhiger Klang |
icons/ | UI-Symbole (Lucide-Raster), Glyphen, Piktogramm-Grammatik + Galerie |
docs/01–17 | Prinzipien, Farbe, Typografie, Layout, Komponenten, Bewegung, Mobilgerät, RTL, Symbole, Datenvisualisierung, Druck, Barrierefreiheit, QA, Klang, Figma, Bibliotheken, Frameworks |
qa/ · scripts/ | Testsuiten · Druck, Verifikation, Tokens, Assets, Selbstprüfung |
fonts/ | IBM Plex Sans Arabic + Inter (TTF, OFL) für Offline, CI und Druck |
examples/workout-plan/ | Ein vollständiges Produkt mit Halo (Website + 4 Vektor-PDFs). Nur als Referenz. |