Communitygithub.com

Diseño de Sistema de UI / Auditoría y Documentación

Audita, documenta o amplía tu sistema de diseño. Úsalo para verificar incoherencias de nombres o valores codificados en componentes, escribir documentación de variantes, estados y notas de accesibilidad, o diseñar un nuevo patrón que encaje en el sistema existente.

¿Qué es Auditoría y Documentación?

Este skill está diseñado para ayudar a desarrolladores y diseñadores a gestionar y mantener sistemas de diseño de UI. Permite realizar auditorías completas de consistencia en el sistema (nombres, valores codificados, cobertura de tokens), documentar componentes con todos sus detalles (variantes, estados, accesibilidad, ejemplos de código), y diseñar nuevas partes o patrones que se integren de manera coherente con el sistema existente. Funciona en herramientas de IA como Claude Code y Cursor, y se activa mediante comandos como `/design-system audit`, `/design-system document [componente]` o `/design-system extend [patrón]`. Su utilidad radica en que unifica la gestión del sistema de diseño, facilita la creación de documentación consistente y asegura que los nuevos componentes sigan los principios establecidos, todo dentro del mismo flujo de trabajo de IA.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/tmnhutwork/Landingpage-Photo-Retouch/tree/HEAD/.agents/skills/design-system-management

Preguntar en tu IA favorita

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

Documentación

/sistema-de-diseño

Si ves marcadores de posición desconocidos o necesitas verificar qué herramientas están conectadas, consulta CONNECTORS.md.

Gestiona tu sistema de diseño — audita la consistencia, documenta componentes o diseña nuevos patrones.

Uso

/sistema-de-diseño auditoría                    # Auditoría completa del sistema
/sistema-de-diseño documentar [componente]      # Documentar un componente
/sistema-de-diseño extender [patrón]            # Diseñar un nuevo componente o patrón

Componentes de un Sistema de Diseño

Tokens de Diseño

Valores atómicos que definen el lenguaje visual:

  • Colores (marca, semánticos, neutros)
  • Tipografía (escala, grosores, alturas de línea)
  • Espaciado (escala, padding de componentes)
  • Bordes (radio, ancho)
  • Sombras (niveles de elevación)
  • Movimiento (duraciones, aceleraciones)

Componentes

Elementos de UI reutilizables con definidos:

  • Variantes (primaria, secundaria, fantasma)
  • Estados (predeterminado, hover, activo, deshabilitado, carga, error)
  • Tamaños (sm, md, lg)
  • Comportamiento (interacciones, animaciones)
  • Accesibilidad (ARIA, teclado)

Patrones

Soluciones comunes de UI que combinan componentes:

  • Formularios (grupos de entrada, validación, envío)
  • Navegación (barra lateral, pestañas, migas de pan)
  • Visualización de datos (tablas, tarjetas, listas)
  • Retroalimentación (toasts, modales, mensajes en línea)

Principios

  1. Consistencia sobre creatividad — El sistema existe para que los equipos no reinventen la rueda.
  2. Flexibilidad dentro de restricciones — Los componentes deben ser componibles, no rígidos.
  3. Documentar todo — Si no está documentado, no existe.
  4. Versionar y migrar — Los cambios disruptivos necesitan rutas de migración.

Salida — Auditoría

## Auditoría del Sistema de Diseño

### Resumen
**Componentes revisados:** [X] | **Problemas encontrados:** [X] | **Puntuación:** [X/100]

### Consistencia de Nombres
| Problema | Componentes | Recomendación |
|----------|-------------|---------------|
| [Nombre inconsistente] | [Lista] | [Estándar a adoptar] |

### Cobertura de Tokens
| Categoría | Definidos | Valores Codificados Encontrados |
|-----------|-----------|--------------------------------|
| Colores | [X] | [X] instancias de hex codificado |
| Espaciado | [X] | [X] instancias de valores arbitrarios |
| Tipografía | [X] | [X] instancias de fuentes/tamaños personalizados |

### Completitud de Componentes
| Componente | Estados | Variantes | Documentación | Puntuación |
|------------|---------|-----------|---------------|------------|
| Botón | ✅ | ✅ | ⚠️ | 8/10 |
| Entrada | ✅ | ⚠️ | ❌ | 5/10 |

### Acciones Prioritarias
1. [Mejora de mayor impacto]
2. [Segunda prioridad]
3. [Tercera prioridad]

Salida — Documentar

## Componente: [Nombre]

### Descripción
[Qué es este componente y cuándo usarlo]

### Variantes
| Variante | Usar Cuando |
|----------|-------------|
| [Primaria] | [Acciones principales] |
| [Secundaria] | [Acciones de apoyo] |

### Props / Propiedades
| Propiedad | Tipo | Predeterminado | Descripción |
|-----------|------|----------------|-------------|
| [prop] | [tipo] | [predeterminado] | [descripción] |

### Estados
| Estado | Visual | Comportamiento |
|--------|--------|----------------|
| Predeterminado | [descripción] | — |
| Hover | [descripción] | [interacción] |
| Activo | [descripción] | [interacción] |
| Deshabilitado | [descripción] | No interactivo |
| Carga | [descripción] | [animación] |

### Accesibilidad
- **Rol**: [rol ARIA]
- **Teclado**: [comportamiento Tab, Enter, Escape]
- **Lector de pantalla**: [Se anuncia como...]

### Qué Hacer y Qué No Hacer
| ✅ Hacer | ❌ No Hacer |
|----------|-------------|
| [Mejor práctica] | [Anti-patrón] |

### Ejemplo de Código
[fragmento de código apropiado al framework]

Salida — Extender

## Nuevo Componente: [Nombre]

### Problema
[Qué necesidad del usuario o brecha aborda este componente]

### Patrones Existentes
| Componente Relacionado | Similitud | Por Qué No Es Suficiente |
|------------------------|-----------|--------------------------|
| [Componente] | [Qué comparten] | [Qué falta] |

### Diseño Propuesto

#### API / Props
| Propiedad | Tipo | Predeterminado | Descripción |
|-----------|------|----------------|-------------|
| [prop] | [tipo] | [predeterminado] | [descripción] |

#### Variantes
| Variante | Usar Cuando | Visual |
|----------|-------------|--------|
| [Variante] | [Escenario] | [Descripción] |

#### Estados
| Estado | Comportamiento | Notas |
|--------|----------------|-------|
| Predeterminado | [Descripción] | — |
| Hover | [Descripción] | [Interacción] |
| Deshabilitado | [Descripción] | No interactivo |
| Carga | [Descripción] | [Animación] |

#### Tokens Utilizados
- Colores: [Qué tokens]
- Espaciado: [Qué tokens]
- Tipografía: [Qué tokens]

### Accesibilidad
- **Rol**: [rol ARIA]
- **Teclado**: [Interacciones esperadas]
- **Lector de pantalla**: [Se anuncia como...]

### Preguntas Abiertas
- [Decisión que necesita revisión de diseño]
- [Caso límite por resolver]

Si Hay Conectores Disponibles

Si ~~herramienta de diseño está conectada:

  • Audita componentes directamente en Figma — verifica nombres, variantes y uso de tokens.
  • Extrae propiedades de componentes y estructura de capas para documentación.

Si ~~base de conocimiento está conectada:

  • Busca documentación existente de componentes y pautas de uso.
  • Publica documentación actualizada en tu wiki.

Consejos

  1. Empieza con una auditoría — Conoce dónde estás antes de decidir hacia dónde ir.
  2. Documenta mientras construyes — Es más fácil documentar un componente mientras lo diseñas.
  3. Prioriza la cobertura sobre la perfección — El 80% de los componentes documentados supera al 100% de 10 componentes.

Individual skills in this repo

This repo contains 15 individual skills — each has its own dedicated page.

tmnhutwork/Landingpage-Photo-Retouch

Run a WCAG 2.1 AA accessibility audit on a design or page. Trigger with "audit accessibility", "check a11y", "is this accessible?", or when reviewing a design for color contrast, keyboard navigation, touch target size, or screen reader behavior before handoff.

tmnhutwork/Landingpage-Photo-Retouch

Get structured design feedback on usability, hierarchy, and consistency. Trigger with "review this design", "critique this mockup", "what do you think of this screen?", or when sharing a Figma link or screenshot for feedback at any stage from exploration to final polish.

tmnhutwork/Landingpage-Photo-Retouch

Generate developer handoff specs from a design. Use when a design is ready for engineering and needs a spec sheet covering layout, design tokens, component props, interaction states, responsive breakpoints, edge cases, and animation details.

tmnhutwork/Landingpage-Photo-Retouch

Audit, document, or extend your design system. Use when checking for naming inconsistencies or hardcoded values across components, writing documentation for a component's variants, states, and accessibility notes, or designing a new pattern that fits the existing system.

tmnhutwork/Landingpage-Photo-Retouch

Synthesize user research into themes, insights, and recommendations. Use when you have interview transcripts, survey results, usability test notes, support tickets, or NPS responses that need to be distilled into patterns, user segments, and prioritized next steps.

tmnhutwork/Landingpage-Photo-Retouch

Plan, conduct, and synthesize user research. Trigger with "user research plan", "interview guide", "usability test", "survey design", "research questions", or when the user needs help with any aspect of understanding their users through research.

tmnhutwork/Landingpage-Photo-Retouch

Write or review UX copy — microcopy, error messages, empty states, CTAs. Trigger with "write copy for", "what should this button say?", "review this error message", or when naming a CTA, wording a confirmation dialog, filling an empty state, or writing onboarding text.

tmnhutwork/Landingpage-Photo-Retouch

Design banners for social media, ads, website heroes, creative assets, and print. Multiple art direction options with AI-generated visuals. Actions: design, create, generate banner. Platforms: Facebook, Twitter/X, LinkedIn, YouTube, Instagram, Google Display, website hero, print. Styles: minimalist, gradient, bold typography, photo-based, illustrated, geometric, retro, glassmorphism, 3D, neon, duotone, editorial, collage. Uses ui-ux-pro-max, frontend-design, ai-artist, ai-multimodal skills.

tmnhutwork/Landingpage-Photo-Retouch

Brand voice, visual identity, messaging frameworks, asset management, brand consistency. Activate for branded content, tone of voice, marketing assets, brand compliance, style guides.

tmnhutwork/Landingpage-Photo-Retouch

Comprehensive design skill: brand identity, design tokens, UI styling, logo generation (55 styles, Gemini AI), corporate identity program (50 deliverables, CIP mockups), HTML presentations (Chart.js), banner design (22 styles, social/ads/web/print), icon design (15 styles, SVG, Gemini 3.1 Pro), social photos (HTML→screenshot, multi-platform). Actions: design logo, create CIP, generate mockups, build slides, design banner, generate icon, create social photos, social media images, brand identity, design system. Platforms: Facebook, Twitter, LinkedIn, YouTube, Instagram, Pinterest, TikTok, Threads, Google Ads.

tmnhutwork/Landingpage-Photo-Retouch

Translates Figma designs into production-ready application code with 1:1 visual fidelity. Use when implementing UI code from Figma files, when user mentions "implement design", "generate code", "implement component", provides Figma URLs, or asks to build components matching Figma specs. For Figma canvas writes via `use_figma`, use `figma-use`.

tmnhutwork/Landingpage-Photo-Retouch

Use the Figma MCP server to fetch design context, screenshots, variables, and assets from Figma, and to translate Figma nodes into production code. Trigger when a task involves Figma URLs, node IDs, design-to-code implementation, or Figma MCP setup and troubleshooting.

tmnhutwork/Landingpage-Photo-Retouch

Create strategic HTML presentations with Chart.js, design tokens, responsive layouts, copywriting formulas, and contextual slide strategies.

tmnhutwork/Landingpage-Photo-Retouch

Create beautiful, accessible user interfaces with shadcn/ui components (built on Radix UI + Tailwind), Tailwind CSS utility-first styling, and canvas-based visual designs. Use when building user interfaces, implementing design systems, creating responsive layouts, adding accessible components (dialogs, dropdowns, forms, tables), customizing themes and colors, implementing dark mode, generating visual designs and posters, or establishing consistent styling patterns across applications.

tmnhutwork/Landingpage-Photo-Retouch

UI/UX design intelligence for web, mobile, and desktop. This skill should be used when designing, building, reviewing, or fixing interfaces, including pages, components, design systems, accessibility, interaction, responsive layout, typography, color, charts, and stack-specific UI implementation. Searchable local data: 79 searchable styles (50 active), 192 product palettes and reasoning profiles, 74 font pairings, 119 UX guidelines, 105 icons, 17 GSAP presets, 25 chart types, and 22 stacks.

Skills relacionados