Communitygithub.com

Halo-Design

Design-Skill. Halo, ein ruhiges, glänzendes, zahlenzentriertes Designsystem für jedes Web-App, Dashboard, Tool, jede Landingpage oder vektorielle PDF, zweisprachig von Grund auf (Englisch + Kurdisch Sorani oder jede RTL-Schrift). Verwende es, wenn der Benutzer den Halo-Stil wünscht, eine polierte dunkle/helle Oberfläche, die sich lebendig anfühlt (randbeleuchtete Karten, sanfte Bewegung, optionaler ruhiger Klang), Kurdisch, Arabisch oder Persisch neben Englisch benötigt oder druckfertige vektorielle PDFs erwartet.

Was ist Halo-Design?

Dieses Skill implementiert das Halo-Designsystem, eine zahlenzentrierte, zweisprachige (Englisch + RTL) Designsprache für Webanwendungen, Dashboards, Tools und druckbare Vektor-PDFs. Es geht nicht um das Kopieren eines vorgefertigten Themes, sondern um eine durchstrukturierte Gestaltungsmethode mit festen Tokens, Typografie, Bewegungs- und Barrierefreiheitsregeln, die dem Produkt dennoch Raum für eine eigene visuelle Identität lässt. Der Agent beginnt stets mit einem kurzen Designbrief (templates/brief.md) und wählt ein produktspezifisches visuelles Signaturelement aus dem Katalog von Halo. Die Skill-Anleitung beschreibt den Arbeitsablauf von der Grundlage über das Komponieren von Sektionen bis zur QA und liefert klare Vorgaben für Tokens, Layout, RTL-Anpassungen und Barrierefreiheit. Es eignet sich besonders für Teams, die eine konsistente, testbare und zugängliche UI für internationale Nutzer bereitstellen möchten, und unterstützt Plattformen wie React, Next, Tailwind und Vue. Die Reproduzierbarkeit wird durch Makefile-Befehle und CI sichergestellt.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/SawabS/halo-design-skill/tree/HEAD

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

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

  1. 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.
  2. Plattform → Halo → bewährte Bibliothek. Niemals eigene Mechanismen erfinden (docs/16-libraries.md).
  3. Tokens sind die einzige Quelle für Farbe, Kurve und Radius. Keine Farb-Literale außerhalb von tokens/tokens.css; scripts/check_skill.py erzwingt dies für Halo-CSS.
  4. Beide Themes, beide Richtungen, jeder Breakpoint werden entworfen und getestet.
  5. Zahlen zuerst: graues Label → großer Akzentwert → einfacher Satz. Visualisierungen wiederholen die Zahl, ersetzen sie nie.
  6. 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.
  7. Keine Logos. Der Markenplatz ist der Name des Produkts in Text. Verwende ein Zeichen nur, wenn der Benutzer eines bereitstellt.
  8. 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:

AufgabeLesenStart von
Neues Produkt oder neue Seitedocs/00, docs/02, docs/03, docs/05templates/starter.html (persönliche App) oder templates/dashboard.html (Daten / Betrieb)
Datenintensiver Bildschirmdocs/10, docs/04templates/dashboard.html
Kurdisch / Arabisch / Persischdocs/08, docs/03beide Vorlagen mit lang=ckb
Optimierung für Mobilgerätedocs/07—
Bewegung, Randlicht, Scrollendocs/06—
Klangdocs/14js/halo-sound.js
Symbole oder Illustrationenicons/README.md, docs/09icons/
Gedrucktes Dokument oder PDFdocs/11templates/print-a4.html
React / Next / Tailwind / Vuedocs/17—
Auswahl einer Bibliothekdocs/16—
Figma oder Design-Tokens für andere Werkzeugedocs/15, tokens/*.tokens.json—
Barrierefreiheitdocs/12—
Testendocs/13qa/

Lies niemals examples/workout-plan/index.html vollständig (ca. 42.000 Tokens). Durchsuche es stattdessen nach einem bestimmten Muster (grep -n "restTimer" …).

Arbeitsablauf

  1. Brief. Fülle templates/brief.md aus: 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.
  2. Grundlage. Verlinke tokens/tokens.css, css/halo.css, js/halo.js (plus js/halo-sound.js nur wenn der Brief Klang vorsieht) und rufe Halo.init({dict}) auf. Schriftarten: Google Sans + IBM Plex Sans Arabic (docs/03).
  3. Abschnitte komponieren aus den Komponenten in docs/05:
    • Baue die visuelle Signatur mit vorhandenen Elementen: Halo.rings, Halo.spark, .meter mit einer .target Markierung, .bars, .timeline, dem Status-Raster oder einem typografischen Helden. Oder erfinde eine, die den Regeln in docs/00 folgt.
    • Ersetze alle Vorlageninhalte. Wenn deine Seite „Schließe die Ringe“ oder „GPUs gesund“ sagt und das Produkt nicht davon handelt, hast du kopiert.
  4. Ausbalancieren von Mobilgerät und Laptop separat (docs/04, docs/07).
  5. 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.
  6. Bewegung und Klang in der im Brief gewählten Intensität (docs/06, docs/14).
  7. Qualitätssicherung, über http bereitgestellt:
    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
    
    Füge die eigenen Interaktionsprüfungen des Produkts und axe-core hinzu. Überprüfe Screenshots bei 390 und 1440 in beiden Themes.
  8. Drucken falls erforderlich: HTML → scripts/print_pdf.py → qpdf zusammenfü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.py und qa_touch.py bestehen; keine Konsolenfehler; PDFs als Vektoren verifiziert.

Reproduzierbarkeit

  • make setup installiert festgelegte Abhängigkeiten (requirements.txt) und Chromium.
  • make check validiert das Skill selbst: Links, Tokens synchron, keine verstreuten Farben, keine Logos, JS-Syntax, Frontmatter.
  • make qa testet jede Vorlage und das Beispiel; make assets rendert die README-Bilder neu; make tokens baut das DTCG-JSON neu.
  • CI führt das Gleiche in .github/workflows/qa.yml aus.

Dateizuordnung

PfadWas
docs/00-creative-direction.mdZuerst lesen. Brief, Katalog der visuellen Signaturen, Akzentbedeutungen, Illustrationssprache, Anti-Patterns
templates/brief.mdDer auszufüllende Brief
templates/starter.htmlMechanik für persönliche Apps: geteilter Held, Ringe, Aufgaben, Timer, Tabelle, Klang
templates/dashboard.htmlMechanik für Daten/Betrieb: Status-Raster, Sparklines, Messgeräte mit Zielen, Live-Updates, ruhige Bewegung
templates/print-a4.htmlVektordruckseite
tokens/tokens.css (Quelle der Wahrheit) + DTCG 2025.10 JSON
css/halo.css · js/halo.js · js/halo-sound.jsKomponenten · Laufzeit · ruhiger Klang
icons/UI-Symbole (Lucide-Raster), Glyphen, Piktogramm-Grammatik + Galerie
docs/01–17Prinzipien, 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.

Verwandte Skills