brand-kit

name	brand-kit
description	Seleccionar y aplicar un tema de identidad visual (colores, tipografía, tono, paleta de charts, tamaños) que cada writer skill (docx-writer, pptx-writer, pdf-writer, web-craft, canvas-craft, xlsx-writer) consume para producir entregables con branding coherente. Incluye diez temas curados y es extensible mediante nuevos ficheros markdown de tema. Usar siempre que el usuario pida una marca o tema específicos, mencione colores/identidad/tono corporativos, solicite un informe/deck/poster con branding, o antes de generar cualquier entregable visual para fijar los tokens de marca. No renderiza el fichero final — delega en las writer skills.
argument-hint	[nombre del tema | 'personalizado' | 'scaffold']

Skill: brand-kit

El branding vive en un solo sitio. Esta skill proporciona un catálogo curado de temas de identidad visual — cada uno un paquete completo y coherente de colores, tipografía, paleta de charts, tamaños y tono — que cualquier skill de output sabe consumir. Elige un tema una vez y todos los artefactos derivados (DOCX, PPTX, PDF, XLSX, web, visual de una sola página) lo heredan de forma consistente.

La skill no genera artefactos por sí misma. Proporciona tokens.

Available themes

Theme	Tone family	Best for
editorial-serious	editorial-serious	informes analíticos largos, legal, policy
technical-minimal	technical-minimal	dashboards, docs de ingeniería, runbooks
warm-magazine	warm-magazine	comunicaciones, marketing, storytelling
forensic-audit	forensic-audit	auditoría, compliance, informes de seguridad
academic-sober	editorial-serious	papers de investigación, whitepapers, policy
modern-product	technical-minimal	decks de producto, lanzamientos, pitch
brutalist-raw	brutalist-raw	volcados de datos, informes dev, exploratorios
luxury-refined	luxury-refined	decks de consejo, resúmenes ejecutivos
industrial-utilitarian	industrial-utilitarian	informes de operaciones, logística, SRE
corporate-formal	editorial-serious	steering committees, reporting regulado

El catálogo vive aquí inline para que el agente lo vea en el momento en que carga la skill, sin lectura adicional.

Flujo (invoca este flujo ANTES de cualquier skill de output con dimensión visual)

Siempre que el agente vaya a generar un entregable que tenga cualquier expresión visual (informe DOCX, deck PPTX, documento PDF, libro XLSX, landing HTML, PDF / PNG de una sola página), ejecuta este flujo primero para fijar los tokens de marca. Saltarse este paso produce artefactos inconsistentes — fuentes distintas, acentos distintos, sin paleta compartida de charts entre piezas del mismo proyecto.

1. Presenta el catálogo al usuario

Muestra al usuario la tabla "Available themes" de arriba. Manténlo breve — una línea por tema con Theme · Tone · Best for es suficiente.

2. Pregunta qué fuente quiere el usuario

Siguiendo la convención de preguntas del agente, ofrece tres vías:

• Tema predefinido — elige uno del catálogo por nombre.
• Personalizado ad-hoc — el usuario proporciona colores (hex) y fuentes directamente en la conversación. Mapea las entradas al contrato canónico de tokens (ver §Contrato de tokens).
• Scaffold externo — el usuario apunta a un fichero (guía de marca en PDF, documento de branding del cliente, memo de diseño). Lee el fichero y deriva tokens — normalizando al contrato canónico.

3. Carga el tema elegido

Si el usuario eligió un tema predefinido, lee themes/<nombre>.md — ese fichero contiene el set completo de tokens. Si aportó entradas ad-hoc o un scaffold, construye la misma estructura en memoria desde esas entradas.

4. Pasa los tokens a la skill de output

Cuando invoques la skill de output (docx-writer, pptx-writer, pdf-writer, web-craft, canvas-craft, xlsx-writer), proporciónale los tokens cargados. Cada skill de output sabe mapear los tokens canónicos a su formato nativo (dict Python para python-docx / python-pptx, HexColor para reportlab, CSS custom properties para web).

Contrato de tokens

Cada fichero de tema sigue el mismo contrato para que las skills de output puedan consumir cualquier tema indistintamente. El contrato tiene un core (obligatorio) y extensiones opcionales.

Core (todo tema debe proveerlo)

Colores (10 tokens hex):

Token	Rol
primary	títulos, reglas superiores, acentos de portada
ink	texto cuerpo (rara vez negro puro — un slate medio suele ser más amable)
muted	captions, notas al pie, texto secundario
rule	divisores finos, bordes sutiles
bg	página / superficie principal
bg_alt	bandas de tabla, callouts, superficies alternas
accent	CTAs, highlights, pops intencionales (5–15 % de superficie)
state_ok	indicadores positivos
state_warn	alertas
state_danger	errores críticos

Tipografía (3 familias + 4 tamaños):

Token	Rol
display	h1/h2/portada — normalmente la más expresiva
body	texto corrido
mono	código, cifras en tablas, strings técnicos
size_h1, size_h2, size_body, size_caption	tamaños en pt

Cada entrada de fuente incluye una pila de fallbacks para que el tema degrade dignamente cuando la primera familia no esté disponible.

Chart categorical: lista ordenada de 5–8 colores hex, curada para que los primeros N se vean equilibrados con cualquier número N de series. Las dos primeras entradas suelen coincidir con primary y accent para mantener los charts en diálogo con el resto del artefacto.

Extensiones opcionales (los temas pueden proveerlas; las skills de output las consumen si están)

• motion_budget — "minimal" / "restrained" / "expressive". Usado por web-craft para transiciones y por pptx para animaciones.
• radius — border-radius en píxeles. Usado por web-craft.
• dark_mode — subset con primary / ink / bg / accent de modo oscuro. Usado por web-craft cuando se pide variante dark. Si el tema omite dark_mode y hace falta una variante oscura, deriva invirtiendo bg ↔ ink manteniendo primary / accent.
• chart_sequential — color base para escalas secuenciales / heatmaps.
• print — subset de tokens afinados para PDF impreso (paper, ink, rule, opcionalmente accent). Usado por pdf-writer. Decláralo cuando los tokens de pantalla se degradarían en papel (bg blanco puro o ink negro puro). Si está ausente, pdf-writer aplica sensibilidades genéricas de impresión.

Temas personalizados y externos (cuando ninguno de los 10 encaja)

Si el usuario aporta su propia marca (hex + fuentes ad-hoc, o un fichero externo de marca como scaffold), incorpórala al mismo contrato antes de pasarla a la skill de output. Respeta los valores explícitos del usuario y rellena los huecos con defaults coordinados:

• ink, muted, rule: neutrales derivados de o afinados contra primary (slate oscuro más suave, gris medio de baja croma, un tinte pálido).
• bg / bg_alt: casi blanco y un tinte al 2–4 % de este.
• Colores de estado: semánticos (verde / ámbar / rojo), afinados a la calidez del tema.
• Chart categorical: empieza con primary y accent, extiende a 5–8 matices con amplia separación perceptual.

Muestra el set derivado al usuario para confirmación antes de pasar a la skill de output.

Extensibilidad

El contrato de tokens es estable: los clientes pueden añadir sus propios ficheros de tema en themes/ (misma estructura que los incluidos) o mantener su branding en una skill local separada. Las skills de output referencian "skill de theming centralizada" de forma genérica — la regla local skill wins del monorepo hace que un <agent>/skills/<marca>/ local sobreescriba la compartida cuando ambas existan.

Cuándo NO usar esta skill

• No hay artefacto visual (respuesta de chat pura, consulta SQL, refactor de código). Sáltate la skill.
• El AGENTS.md del agente fija un único tema. Cárgalo directamente y sáltate la pregunta.