Communitygithub.com

Sistema de Design

Audite, documente ou amplie seu sistema de design. Use ao verificar inconsistências de nomenclatura ou valores fixos em componentes, escrever documentação de variantes, estados e notas de acessibilidade, ou projetar um novo padrão que se encaixe no sistema existente.

O que é Sistema de Design?

Esta habilidade, baseada no prompt `/design-system`, capacita agentes de IA (como Claude Code, Cursor ou Codex) a gerenciar sistemas de design de forma estruturada. Ela oferece três comandos principais: `audit` (auditoria de consistência em nomenclatura, cobertura de tokens e completude de componentes), `document` (documentação completa de componentes, incluindo variantes, estados, acessibilidade e exemplos de código) e `extend` (projeto de novos componentes ou padrões que se encaixem no sistema existente). A habilidade é útil para times de UI/UX e desenvolvedores front-end que precisam manter a consistência visual e a documentação viva do design system. Ela suporta integração com ferramentas de design (como Figma) e bases de conhecimento, permitindo auditoria direta no Figma e publicação de documentação. Os princípios-chave são: consistência sobre criatividade, flexibilidade dentro de restrições, documentar tudo e versionar com caminhos de migração.

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

Perguntar na sua IA favorita

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

Documentação

/design-system

Se encontrar placeholders desconhecidos ou precisar verificar quais ferramentas estão conectadas, consulte CONNECTORS.md.

Gerencie seu sistema de design — audite para consistência, documente componentes ou projete novos padrões.

Uso

/design-system audit                    # Auditoria completa do sistema
/design-system document [component]     # Documentar um componente
/design-system extend [pattern]         # Projetar um novo componente ou padrão

Componentes de um Sistema de Design

Design Tokens

Valores atômicos que definem a linguagem visual:

  • Cores (marca, semânticas, neutras)
  • Tipografia (escala, pesos, alturas de linha)
  • Espaçamento (escala, padding de componentes)
  • Bordas (raio, espessura)
  • Sombras (níveis de elevação)
  • Movimento (durações, curvas de easing)

Componentes

Elementos de UI reutilizáveis com variantes definidas:

  • Variantes (primário, secundário, ghost)
  • Estados (padrão, hover, ativo, desabilitado, carregando, erro)
  • Tamanhos (sm, md, lg)
  • Comportamento (interações, animações)
  • Acessibilidade (ARIA, teclado)

Padrões

Soluções comuns de UI que combinam componentes:

  • Formulários (grupos de input, validação, envio)
  • Navegação (sidebar, abas, breadcrumbs)
  • Exibição de dados (tabelas, cards, listas)
  • Feedback (toasts, modais, mensagens inline)

Princípios

  1. Consistência sobre criatividade — O sistema existe para que os times não reinventem a roda
  2. Flexibilidade dentro de restrições — Os componentes devem ser compostíveis, não rígidos
  3. Documente tudo — Se não está documentado, não existe
  4. Versionamento e migração — Mudanças estruturais precisam de caminhos de migração

Saída — Auditoria

## Auditoria do Sistema de Design

### Resumo
**Componentes revisados:** [X] | **Problemas encontrados:** [X] | **Pontuação:** [X/100]

### Consistência de Nomenclatura
| Problema | Componentes | Recomendação |
|----------|-------------|------------|
| [Nomenclatura inconsistente] | [Lista] | [Padrão a adotar] |

### Cobertura de Tokens
| Categoria | Definidos | Valores Fixos Encontrados |
|-----------|-----------|--------------------------|
| Cores | [X] | [X] instâncias de hex fixo |
| Espaçamento | [X] | [X] instâncias de valores arbitrários |
| Tipografia | [X] | [X] instâncias de fontes/tamanhos personalizados |

### Completude dos Componentes
| Componente | Estados | Variantes | Docs | Pontuação |
|------------|---------|-----------|------|-----------|
| Button | ✅ | ✅ | ⚠️ | 8/10 |
| Input | ✅ | ⚠️ | ❌ | 5/10 |

### Ações Prioritárias
1. [Melhoria de maior impacto]
2. [Segunda prioridade]
3. [Terceira prioridade]

Saída — Documentação

## Componente: [Nome]

### Descrição
[Para que serve este componente e quando usá-lo]

### Variantes
| Variante | Use Quando |
|----------|------------|
| [Primário] | [Ações principais] |
| [Secundário] | [Ações de suporte] |

### Props / Propriedades
| Propriedade | Tipo | Padrão | Descrição |
|-------------|------|--------|-------------|
| [prop] | [tipo] | [padrão] | [descrição] |

### Estados
| Estado | Visual | Comportamento |
|--------|--------|--------------|
| Padrão | [descrição] | — |
| Hover | [descrição] | [interação] |
| Ativo | [descrição] | [interação] |
| Desabilitado | [descrição] | Não interativo |
| Carregando | [descrição] | [animação] |

### Acessibilidade
- **Função**: [função ARIA]
- **Teclado**: [comportamento Tab, Enter, Escape]
- **Leitor de tela**: [Anunciado como...]

### O que Fazer e o que Não Fazer
| ✅ Faça | ❌ Não Faça |
|--------|-----------|
| [Melhor prática] | [Anti-padrão] |

### Exemplo de Código
[Trecho de código apropriado ao framework]

Saída — Ampliação

## Novo Componente: [Nome]

### Problema
[Qual necessidade do usuário ou lacuna este componente resolve]

### Padrões Existentes
| Componente Relacionado | Semelhança | Por Que Não é Suficiente |
|------------------------|------------|--------------------------|
| [Componente] | [O que é compartilhado] | [O que está faltando] |

### Proposta de Design

#### API / Props
| Propriedade | Tipo | Padrão | Descrição |
|-------------|------|--------|-------------|
| [prop] | [tipo] | [padrão] | [descrição] |

#### Variantes
| Variante | Use Quando | Visual |
|----------|------------|--------|
| [Variante] | [Cenário] | [Descrição] |

#### Estados
| Estado | Comportamento | Observações |
|--------|--------------|-------------|
| Padrão | [Descrição] | — |
| Hover | [Descrição] | [Interação] |
| Desabilitado | [Descrição] | Não interativo |
| Carregando | [Descrição] | [Animação] |

#### Tokens Usados
- Cores: [Quais tokens]
- Espaçamento: [Quais tokens]
- Tipografia: [Quais tokens]

### Acessibilidade
- **Função**: [função ARIA]
- **Teclado**: [Interações esperadas]
- **Leitor de tela**: [Anunciado como...]

### Perguntas em Aberto
- [Decisão que precisa de revisão de design]
- [Caso de borda a resolver]

Se Conectores Estiverem Disponíveis

Se a ~~ferramenta de design estiver conectada:

  • Audite componentes diretamente no Figma — verifique nomenclatura, variantes e uso de tokens
  • Extraia propriedades dos componentes e estrutura de camadas para documentação

Se a ~~base de conhecimento estiver conectada:

  • Pesquise documentação existente de componentes e diretrizes de uso
  • Publique documentação atualizada na sua wiki

Dicas

  1. Comece com uma auditoria — Saiba onde você está antes de decidir para onde ir.
  2. Documente enquanto projeta — É mais fácil documentar um componente enquanto o projeta.
  3. Priorize cobertura sobre perfeição — 80% dos componentes documentados vence 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.

Habilidades Relacionadas