Communitygithub.com

halo-design

Skill de design. Halo, um sistema de design calmo, brilhante e orientado a números para qualquer web app, dashboard, ferramenta, landing page ou PDF vetorial, bilíngue por design (Inglês + Curdo Sorâni ou qualquer script RTL). Use quando o usuário pedir o estilo Halo, desejar uma interface escura/clara polida que pareça viva (cards com bordas iluminadas, movimento sutil, som opcional calmo), precisar de Curdo, Árabe ou Persa junto com Inglês, ou quiser PDFs vetoriais prontos para impressão. O agente escreve um breve resumo de design e inventa uma assinatura visual específica para o produto.

O que é halo-design?

O Halo é um sistema de design focado em números, calmo e bilíngue, ideal para web apps, dashboards, ferramentas e landing pages. Ele não é um tema para copiar, mas sim uma 'gramática' de design que fornece tokens, tipografia, movimento, acessibilidade, layout bilíngue e QA, deixando a personalidade do produto para o usuário (assinatura visual, significados de acentos, ilustrações, texto e som). O skill é compatível com Claude Code, Cursor e Codex (e qualquer plataforma que suporte skills de agente). O fluxo de trabalho começa com um brief, seguido pela composição de seções usando componentes pré-definidos como rings, sparklines e meters, sempre respeitando as regras de números primeiro e movimento sutil. O skill suporta temas claro/escuro, direções LTR e RTL, e inclui QA automatizado via scripts Python que testam 9 larguras de tela, 2 temas e 2 idiomas.

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

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

Skill de design Halo

Halo é uma forma de projetar, não um tema para copiar. Ele corrige a gramática (tokens, tipo, movimento, acessibilidade, layout bilíngue, QA) e deixa o caráter do produto para você: sua assinatura visual, significados dos acentos, ilustrações, texto e som. O plano de treino em examples/ e os dois modelos são demonstrações da mecânica, não conteúdo para reutilizar.

Regras básicas

  1. Projete por produto. Escreva o brief primeiro (templates/brief.md) e escolha uma assinatura visual que se ajuste a este produto (docs/00-creative-direction.md). Anéis, pictogramas de exercício e texto de treino estão errados a menos que o produto seja sobre fechar metas diárias.
  2. Plataforma → Halo → biblioteca comprovada. Nunca invente mecanismos (docs/16-libraries.md).
  3. Tokens são a única fonte de cor, curva e raio. Sem literais de cor fora de tokens/tokens.css; scripts/check_skill.py aplica isso para o CSS do Halo.
  4. Ambos os temas, ambas as direções, todos os breakpoints são projetados e testados.
  5. Números primeiro: rótulo cinza → valor grande com acento → frase simples. Visuais repetem o número, nunca o substituem.
  6. Movimento é leve: uma curva, revelar uma vez, nada em loop, seguro para movimento reduzido. Atualizações de dados ao vivo ocorrem no lugar e nunca re-animam.
  7. Sem logotipos. O espaço da marca é o nome do produto em texto. Use uma marca apenas se o usuário fornecer uma.
  8. Pronto significa QA aprovado (docs/13-qa.md).

Leia apenas o que a tarefa precisa

Os documentos são curtos (menos de 1.500 tokens cada). Não leia tudo; roteie por tarefa:

TarefaLeiaComece de
Qualquer novo produto ou páginadocs/00, docs/02, docs/03, docs/05templates/starter.html (app pessoal) ou templates/dashboard.html (dados / operações)
Tela com muitos dadosdocs/10, docs/04templates/dashboard.html
Curdo / Árabe / Persadocs/08, docs/03qualquer modelo com lang=ckb
Polimento para celulardocs/07—
Movimento, luz de borda, rolagemdocs/06—
Somdocs/14js/halo-sound.js
Ícones ou ilustraçõesicons/README.md, docs/09icons/
Documento impresso ou PDFdocs/11templates/print-a4.html
React / Next / Tailwind / Vuedocs/17—
Escolha de bibliotecadocs/16—
Figma ou tokens de design para outras ferramentasdocs/15, tokens/*.tokens.json—
Acessibilidadedocs/12—
Testesdocs/13qa/

Nunca leia examples/workout-plan/index.html inteiro (cerca de 42k tokens). Pesquise um padrão específico nele (grep -n "restTimer" …).

Fluxo de trabalho

  1. Brief. Preencha templates/brief.md: para quem é, o que eles voltam para conferir, os 1–3 números heróis, a assinatura visual, significados dos acentos, linguagem de ilustração, intensidade de movimento e som, superfícies, idiomas e seções. Se a solicitação for ambígua, mostre o brief e faça uma pergunta; caso contrário, declare-o em um parágrafo curto e construa.
  2. Fundação. Vincule tokens/tokens.css, css/halo.css, js/halo.js (mais js/halo-sound.js apenas se o brief tiver som) e chame Halo.init({dict}). Fontes: Google Sans + IBM Plex Sans Arabic (docs/03).
  3. Componha seções a partir dos componentes em docs/05:
    • Construa a assinatura visual com peças existentes: Halo.rings, Halo.spark, .meter com um marcador .target, .bars, .timeline, a grade de status, ou um herói tipográfico. Ou invente um que siga as regras em docs/00.
    • Substitua todo o conteúdo do modelo. Se sua página disser "Feche os anéis" ou "GPUs saudáveis" e o produto não for sobre isso, você copiou.
  4. Equilibre o celular e o laptop separadamente (docs/04, docs/07).
  5. Bilíngue: toda string vai no dicionário, com regras RTL de docs/08. Se você mesmo escrever curdo, avise o usuário e recomende uma revisão nativa.
  6. Movimento e som na intensidade que o brief escolheu (docs/06, docs/14).
  7. QA, servido via http:
    python3 qa/qa_layout.py http://localhost:8000/page.html    # 9 larguras × 2 temas × 2 idiomas
    python3 qa/qa_touch.py  http://localhost:8000/page.html    # suíte de toque para celular
    
    Adicione as próprias verificações de interação do produto e axe-core. Revise capturas de tela em 390 e 1440 em ambos os temas.
  8. Impressão se necessário: HTML → scripts/print_pdf.py → qpdf merge → scripts/verify_pdf.sh (0 imagens). Incorpore fontes .ttf.

Lista de verificação pré-entrega

  • Um brief existe, e a assinatura visual se ajusta ao produto (não anéis por padrão, não conteúdo copiado).
  • No máximo três significados de acentos, usados consistentemente; acentos de texto usam --XT.
  • Sem literais de cor fora dos tokens; sem logotipo que o usuário não forneceu.
  • Laptop: colunas equilibradas, rodapés alinhados, gráficos preenchem seus cards. Celular: ≤ 4 controles de navegação, alvos de 44 px, sem rolagem lateral em 320.
  • RTL: dir/lang, chevrons invertidos, gráficos espelhados, <bdi> ao redor de termos latinos e unidades latinas.
  • Movimento reduzido respeitado; som (se houver) tem um alternador e nunca é o único sinal.
  • Fontes vinculadas para afirmações factuais; Desfazer para ações destrutivas.
  • qa_layout.py e qa_touch.py passam; sem erros no console; PDFs verificados como vetoriais.

Reprodutibilidade

  • make setup instala dependências fixadas (requirements.txt) e Chromium.
  • make check valida o próprio skill: links, tokens em sincronia, sem cores soltas, sem logotipos, sintaxe JS, frontmatter.
  • make qa testa todos os modelos e o exemplo; make assets re-renderiza as imagens do README; make tokens reconstrói o JSON DTCG.
  • CI executa o mesmo em .github/workflows/qa.yml.

Mapa de arquivos

CaminhoO que é
docs/00-creative-direction.mdLeia primeiro. Brief, catálogo de assinatura visual, significados de acentos, linguagem de ilustração, anti-padrões
templates/brief.mdO brief a ser preenchido
templates/starter.htmlMecânica de app pessoal: herói dividido, anéis, tarefas, temporizador, planilha, som
templates/dashboard.htmlMecânica de dados/operações: grade de status, sparklines, medidores com alvos, atualizações ao vivo, movimento parado
templates/print-a4.htmlPágina de impressão vetorial
tokens/tokens.css (fonte da verdade) + JSON DTCG 2025.10
css/halo.css · js/halo.js · js/halo-sound.jsComponentes · runtime · som calmo
icons/Ícones de UI (grade Lucide), glifos, gramática de pictograma + galeria
docs/01–17Princípios, cor, tipo, layout, componentes, movimento, celular, RTL, ícones, visualização de dados, impressão, a11y, QA, som, Figma, bibliotecas, frameworks
qa/ · scripts/Suítes de teste · impressão, verificação, tokens, assets, auto-checagem
fonts/IBM Plex Sans Arabic + Inter (TTF, OFL) para offline, CI e impressão
examples/workout-plan/Um produto completo feito com Halo (site + 4 PDFs vetoriais). Apenas referência.

Habilidades Relacionadas