Communitygithub.com

halo-design

Compétence de design. Halo, un système de design calme, brillant et axé sur les nombres pour toute application web, tableau de bord, outil, page d'atterrissage ou PDF vectoriel, bilingue par conception (anglais + kurde sorani ou toute écriture RTL). Utilisez-la lorsque l'utilisateur demande le style Halo, souhaite une interface sombre/clair raffinée qui semble vivante (cartes bordées de lumière, mouvement discret, son calme optionnel), a besoin de kurde, arabe ou persan à côté de l'anglais, ou veut des PDF vectoriels prêts à imprimer.

Qu'est-ce que halo-design ?

Halo est un système de design basé sur des tokens et axé sur les nombres, conçu pour créer des interfaces web bilingues, luxueuses et fonctionnelles. Il fournit une grammaire de design complète (tokens de couleurs, typographie, motion, accessibilité, mise en page RTL) tout en laissant la personnalité du produit s'exprimer via des visuels signatures, des illustrations et du contenu. Spécialement conçu pour le kurde sorani, l'arabe et le persan aux côtés de l'anglais, Halo garantit que chaque design est testé sur deux thèmes (clair/sombre), deux directions (LTR/RTL) et plusieurs points de rupture. La compétence guide l'utilisateur de la rédaction d'un brief jusqu'à l'assurance qualité automatisée, en passant par la composition de sections et l'export PDF vectoriel idéal pour l'impression. Elle prend en charge les frameworks modernes (React, Next, Tailwind, Vue) et propose des tokens pour Figma. Idéal pour les tableaux de bord, les opérations, les applications personnelles et les documents imprimés nécessitant une esthétique soignée et réactive.

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

Demander à votre IA préférée

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

Documentation

Compétence de design Halo

Halo est une manière de concevoir, pas un thème à copier. Il fixe la grammaire (tokens, typographie, motion, accessibilité, mise en page bilingue, QA) et vous laisse le caractère du produit : son visuel signature, les significations des accents, les illustrations, le texte et le son. Le plan d'entraînement dans examples/ et les deux modèles sont des démonstrations des mécanismes, pas un contenu à réutiliser.

Règles de base

  1. Concevoir par produit. Rédigez le brief d'abord (templates/brief.md) et choisissez un visuel signature qui correspond à ce produit (docs/00-creative-direction.md). Les anneaux, les pictogrammes d'exercice et le texte d'entraînement sont inappropriés sauf si le produit concerne la fermeture d'objectifs quotidiens.
  2. Plateforme → Halo → bibliothèque éprouvée. N'inventez jamais de mécanismes (docs/16-libraries.md).
  3. Les tokens sont la seule source de couleur, de courbe et de rayon. Pas de littéraux de couleur en dehors de tokens/tokens.css ; scripts/check_skill.py applique cette règle pour le CSS de Halo.
  4. Les deux thèmes, les deux directions, chaque point de rupture sont conçus et testés.
  5. Les nombres d'abord : étiquette grise → grande valeur d'accent → phrase simple. Les visuels répètent le nombre, ne le remplacent jamais.
  6. Le mouvement est léger : une courbe, révéler une fois, rien ne boucle, sûr pour la réduction de mouvement. Les mises à jour de données en direct se font sur place et ne se réaniment jamais.
  7. Pas de logos. L'emplacement de la marque est le nom du produit en texte. Utilisez une marque uniquement si l'utilisateur en fournit une.
  8. Fini signifie QA passé (docs/13-qa.md).

Lisez uniquement ce dont la tâche a besoin

Les documents sont courts (moins de 1 500 tokens chacun). Ne lisez pas tout ; acheminez par tâche :

TâcheLireCommencer par
Tout nouveau produit ou pagedocs/00, docs/02, docs/03, docs/05templates/starter.html (application personnelle) ou templates/dashboard.html (données / opérations)
Écran dense en donnéesdocs/10, docs/04templates/dashboard.html
Kurde / Arabe / Persandocs/08, docs/03l'un ou l'autre modèle avec lang=ckb
Ajustement mobiledocs/07—
Mouvement, lumière de bord, défilementdocs/06—
Sondocs/14js/halo-sound.js
Icônes ou illustrationsicons/README.md, docs/09icons/
Document imprimé ou PDFdocs/11templates/print-a4.html
React / Next / Tailwind / Vuedocs/17—
Choix d'une bibliothèquedocs/16—
Figma ou tokens de design pour d'autres outilsdocs/15, tokens/*.tokens.json—
Accessibilitédocs/12—
Testsdocs/13qa/

Ne lisez jamais examples/workout-plan/index.html en entier (environ 42k tokens). Recherchez-y un motif spécifique à la place (grep -n "restTimer" …).

Flux de travail

  1. Brief. Remplissez templates/brief.md : pour qui c'est, ce qu'ils reviennent vérifier, les 1 à 3 nombres héros, le visuel signature, les significations des accents, le langage d'illustration, l'intensité du mouvement et du son, les surfaces, les langues et les sections. Si la demande est ambiguë, montrez le brief et posez une question ; sinon, énoncez-le dans un court paragraphe et construisez.
  2. Fondation. Liez tokens/tokens.css, css/halo.css, js/halo.js (plus js/halo-sound.js uniquement si le brief inclut du son), et appelez Halo.init({dict}). Polices : Google Sans + IBM Plex Sans Arabic (docs/03).
  3. Composez les sections à partir des composants dans docs/05 :
    • Construisez le visuel signature avec des pièces existantes : Halo.rings, Halo.spark, .meter avec un marqueur .target, .bars, .timeline, la grille de statut, ou un héros typographique. Ou inventez-en un qui suit les règles dans docs/00.
    • Remplacez tout le contenu du modèle. Si votre page dit "Fermez les anneaux" ou "GPUs en bonne santé" et que le produit n'est pas à propos de cela, vous avez copié.
  4. Équilibrez le téléphone et l'ordinateur portable séparément (docs/04, docs/07).
  5. Bilingue : chaque chaîne va dans le dictionnaire, avec les règles RTL de docs/08. Si vous écrivez vous-même du kurde, informez l'utilisateur et recommandez une relecture native.
  6. Mouvement et son à l'intensité choisie par le brief (docs/06, docs/14).
  7. QA, servi via http :
    python3 qa/qa_layout.py http://localhost:8000/page.html    # 9 largeurs × 2 thèmes × 2 langues
    python3 qa/qa_touch.py  http://localhost:8000/page.html    # suite tactile téléphone
    
    Ajoutez les propres vérifications d'interaction du produit et axe-core. Examinez les captures d'écran à 390 et 1440 dans les deux thèmes.
  8. Impression si nécessaire : HTML → scripts/print_pdf.py → fusion qpdf → scripts/verify_pdf.sh (0 images). Incorporez les polices .ttf.

Liste de vérification avant livraison

  • Un brief existe, et le visuel signature correspond au produit (pas des anneaux par défaut, pas de contenu copié).
  • Au plus trois significations d'accent, utilisées de manière cohérente ; les accents de texte utilisent --XT.
  • Pas de littéraux de couleur en dehors des tokens ; pas de logo non fourni par l'utilisateur.
  • Ordinateur portable : colonnes équilibrées, pieds de page alignés, les graphiques remplissent leurs cartes. Téléphone : ≤ 4 contrôles de navigation, cibles de 44 px, pas de défilement latéral à 320.
  • RTL : dir/lang, chevrons inversés, graphiques en miroir, <bdi> autour des termes latins et des unités latines.
  • Mouvement réduit honoré ; son (le cas échéant) a un interrupteur et n'est jamais le seul signal.
  • Sources liées pour les affirmations factuelles ; Annuler pour les actions destructrices.
  • qa_layout.py et qa_touch.py réussissent ; aucune erreur de console ; PDF vérifiés vectoriels.

Reproductibilité

  • make setup installe les dépendances épinglées (requirements.txt) et Chromium.
  • make check valide la compétence elle-même : liens, tokens synchronisés, pas de couleurs parasites, pas de logos, syntaxe JS, en-tête.
  • make qa teste chaque modèle et l'exemple ; make assets regénère les images du README ; make tokens reconstruit le JSON DTCG.
  • CI exécute la même chose dans .github/workflows/qa.yml.

Plan de fichiers

CheminQuoi
docs/00-creative-direction.mdLisez d'abord. Brief, catalogue de visuels signatures, significations des accents, langage d'illustration, anti-patrons
templates/brief.mdLe brief à remplir
templates/starter.htmlMécanismes d'application personnelle : héros divisé, anneaux, tâches, minuteur, feuille, son
templates/dashboard.htmlMécanismes de données/opérations : grille de statut, sparklines, jauges avec cibles, mises à jour en direct, mouvement immobile
templates/print-a4.htmlPage d'impression vectorielle
tokens/tokens.css (source de vérité) + DTCG 2025.10 JSON
css/halo.css · js/halo.js · js/halo-sound.jsComposants · exécution · son calme
icons/Icônes UI (grille Lucide), glyphes, grammaire des pictogrammes + galerie
docs/01–17Principes, couleur, typographie, mise en page, composants, mouvement, téléphone, RTL, icônes, visualisation de données, impression, accessibilité, QA, son, Figma, bibliothèques, frameworks
qa/ · scripts/Suites de tests · impression, vérification, tokens, assets, auto-vérification
fonts/IBM Plex Sans Arabic + Inter (TTF, OFL) pour hors ligne, CI et impression
examples/workout-plan/Un produit complet réalisé avec Halo (site + 4 PDF vectoriels). Référence uniquement.

Skills associés