Communitygithub.com

halo-design

Habilidad de diseño. Halo, un sistema de diseño calmado, brilloso y centrado en números para cualquier aplicación web, panel, herramienta, página de aterrizaje o PDF vectorial, bilingüe por diseño (inglés + kurdo sorani o cualquier escritura RTL). Úsalo cuando el usuario solicite el estilo Halo, quiera una interfaz oscura/clara pulida que se sienta viva (tarjetas con borde iluminado, movimiento sutil, sonido calmado opcional), necesite kurdo, árabe o persa junto con inglés, o desee PDFs vectoriales listos para imprimir. El agente escribe un breve resumen de diseño e inventa un elemento visual distintivo específico del producto.

¿Qué es halo-design?

Halo es un sistema de diseño completo y metodología para construir interfaces de usuario modernas, bilingües y centradas en números. A diferencia de un tema estático, Halo proporciona la 'gramática' del diseño: tokens de diseño, tipografía, animaciones, accesibilidad, maquetación bilingüe y QA automatizado, dejando que el producto defina su propia personalidad visual (colores, ilustraciones, sonido). Está diseñado para agentes de IA como Claude Code, Coder o Codex, y se integra con HTML, CSS, JavaScript, React, Next.js, Tailwind, Vue y Figma. El agente comienza creando un breve resumen de diseño que captura el público objetivo, las métricas clave y un 'elemento visual distintivo' único para el producto, luego construye la interfaz utilizando los componentes y reglas de Halo. El sistema soporta completamente escritura de derecha a izquierda (RTL) para kurdo, árabe y persa, e incluye herramientas para generar PDFs vectoriales. Con un fuerte énfasis en la calidad, Halo incluye scripts de QA que prueban la página en 9 anchos, 2 temas y 2 idiomas, además de una suite de pruebas táctiles para dispositivos móviles.

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

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

Habilidad de diseño Halo

Halo es una forma de diseñar, no un tema para copiar. Arregla la gramática (tokens, tipografía, movimiento, accesibilidad, maquetación bilingüe, QA) y deja el carácter del producto para ti: su elemento visual distintivo, significados de acentos, ilustraciones, texto y sonido. El plan de trabajo en examples/ y las dos plantillas son demostraciones de la mecánica, no contenido para reutilizar.

Reglas básicas

  1. Diseña por producto. Escribe el breve primero (templates/brief.md) y elige un elemento visual distintivo que se adapte a este producto (docs/00-creative-direction.md). Los anillos, pictogramas de ejercicio y texto de entrenamiento son incorrectos a menos que el producto trate sobre cerrar metas diarias.
  2. Plataforma → Halo → biblioteca probada. Nunca inventes mecanismos (docs/16-libraries.md).
  3. Los tokens son la única fuente de color, curva y radio. Sin literales de color fuera de tokens/tokens.css; scripts/check_skill.py lo aplica para el CSS de Halo.
  4. Ambos temas, ambas direcciones, cada punto de interrupción están diseñados y probados.
  5. Primero los números: etiqueta gris → valor de acento grande → frase simple. Los elementos visuales repiten el número, nunca lo reemplazan.
  6. El movimiento es ligero: una curva, revelar una vez, nada en bucle, seguro para movimiento reducido. Las actualizaciones de datos en vivo ocurren en su lugar y nunca se reaniman.
  7. Sin logotipos. El espacio de marca es el nombre del producto en texto. Usa una marca solo si el usuario la proporciona.
  8. Terminado significa QA aprobado (docs/13-qa.md).

Lee solo lo que la tarea necesita

Los documentos son cortos (menos de 1500 tokens cada uno). No leas todo; enruta según la tarea:

TareaLeerComenzar desde
Cualquier producto o página nuevadocs/00, docs/02, docs/03, docs/05templates/starter.html (aplicación personal) o templates/dashboard.html (datos / operaciones)
Pantalla con muchos datosdocs/10, docs/04templates/dashboard.html
Kurdo / Árabe / Persadocs/08, docs/03cualquiera de las plantillas con lang=ckb
Pulido para teléfonodocs/07—
Movimiento, luz de borde, desplazamientodocs/06—
Sonidodocs/14js/halo-sound.js
Iconos o ilustracionesicons/README.md, docs/09icons/
Documento impreso o PDFdocs/11templates/print-a4.html
React / Next / Tailwind / Vuedocs/17—
Elegir una bibliotecadocs/16—
Figma o tokens de diseño para otras herramientasdocs/15, tokens/*.tokens.json—
Accesibilidaddocs/12—
Pruebasdocs/13qa/

Nunca leas examples/workout-plan/index.html completo (aproximadamente 42k tokens). Búscalo con un patrón específico en su lugar (grep -n "restTimer" ...).

Flujo de trabajo

  1. Breve. Completa templates/brief.md: para quién es, qué vuelven a verificar, los 1 a 3 números principales, el elemento visual distintivo, significados de acentos, lenguaje de ilustración, intensidad de movimiento y sonido, superficies, idiomas y secciones. Si la solicitud es ambigua, muestra el breve y haz una pregunta; de lo contrario, redáctalo en un párrafo corto y construye.
  2. Fundación. Enlaza tokens/tokens.css, css/halo.css, js/halo.js (más js/halo-sound.js solo si el breve incluye sonido), y llama a Halo.init({dict}). Fuentes: Google Sans + IBM Plex Sans Arabic (docs/03).
  3. Compone secciones a partir de los componentes en docs/05:
    • Construye el elemento visual distintivo con piezas existentes: Halo.rings, Halo.spark, .meter con un marcador .target, .bars, .timeline, la cuadrícula de estado, o un héroe tipográfico. O inventa uno que siga las reglas en docs/00.
    • Reemplaza todo el contenido de la plantilla. Si tu página dice "Cierra los anillos" o "GPUs saludables" y el producto no trata de eso, copiaste.
  4. Equilibra teléfono y computadora portátil por separado (docs/04, docs/07).
  5. Bilingüe: cada cadena va en el diccionario, con reglas RTL de docs/08. Si escribes kurdo tú mismo, dile al usuario y recomienda una revisión nativa.
  6. Movimiento y sonido a la intensidad que eligió el breve (docs/06, docs/14).
  7. QA, servido sobre http:
    python3 qa/qa_layout.py http://localhost:8000/page.html    # 9 anchos × 2 temas × 2 idiomas
    python3 qa/qa_touch.py  http://localhost:8000/page.html    # suite táctil para teléfono
    
    Agrega las propias verificaciones de interacción del producto y axe-core. Revisa capturas de pantalla a 390 y 1440 en ambos temas.
  8. Impresión si es necesario: HTML → scripts/print_pdf.py → fusión con qpdf → scripts/verify_pdf.sh (0 imágenes). Incrusta fuentes .ttf.

Lista de verificación previa a la entrega

  • Existe un breve, y el elemento visual distintivo se adapta al producto (no anillos por defecto, ni contenido copiado).
  • Como máximo tres significados de acentos, usados de manera consistente; los acentos de texto usan --XT.
  • Sin literales de color fuera de tokens; sin logotipo que el usuario no haya proporcionado.
  • Computadora portátil: columnas equilibradas, pies de página alineados, gráficos llenan sus tarjetas. Teléfono: ≤ 4 controles de navegación, objetivos de 44 px, sin desplazamiento lateral a 320.
  • RTL: dir/lang, chevrones invertidos, gráficos reflejados, <bdi> alrededor de términos latinos y unidades latinas.
  • Movimiento reducido respetado; sonido (si lo hay) tiene un interruptor y nunca es la única señal.
  • Fuentes enlazadas para afirmaciones fácticas; Deshacer para acciones destructivas.
  • qa_layout.py y qa_touch.py pasan; sin errores de consola; PDFs verificados vectoriales.

Reproducibilidad

  • make setup instala dependencias fijas (requirements.txt) y Chromium.
  • make check valida la habilidad misma: enlaces, tokens sincronizados, sin colores sueltos, sin logotipos, sintaxis JS, frontmatter.
  • make qa prueba cada plantilla y el ejemplo; make assets vuelve a renderizar las imágenes del README; make tokens reconstruye el JSON DTCG.
  • CI ejecuta lo mismo en .github/workflows/qa.yml.

Mapa de archivos

RutaQué es
docs/00-creative-direction.mdLeer primero. Breve, catálogo de elementos visuales distintivos, significados de acentos, lenguaje de ilustración, anti-patrones
templates/brief.mdEl breve a completar
templates/starter.htmlMecánica de aplicación personal: héroe dividido, anillos, tareas, temporizador, hoja, sonido
templates/dashboard.htmlMecánica de datos/operaciones: cuadrícula de estado, sparklines, medidores con objetivos, actualizaciones en vivo, movimiento estático
templates/print-a4.htmlPágina de impresión vectorial
tokens/tokens.css (fuente de verdad) + DTCG 2025.10 JSON
css/halo.css · js/halo.js · js/halo-sound.jsComponentes · tiempo de ejecución · sonido calmado
icons/Iconos de interfaz (cuadrícula Lucide), glifos, gramática de pictogramas + galería
docs/01–17Principios, color, tipo, maquetación, componentes, movimiento, teléfono, RTL, iconos, visualización de datos, impresión, a11y, QA, sonido, Figma, bibliotecas, marcos de trabajo
qa/ · scripts/Suites de prueba · impresión, verificación, tokens, activos, autoverificación
fonts/IBM Plex Sans Arabic + Inter (TTF, OFL) para fuera de línea, CI e impresión
examples/workout-plan/Un producto completo hecho con Halo (sitio + 4 PDFs vectoriales). Solo referencia.

Skills relacionados