Communitygithub.com

majiayu000/claude-skill-registry

Pensamento de design e tomada de decisão para UI web. Use ao projetar componentes, layouts, esquemas de cores, tipografia ou criar interfaces estéticas. Ensina princípios, não valores fixos.

O que é claude-skill-registry?

Esta skill capacita agentes de IA com princípios fundamentais de design de frontend, indo além de templates prontos para incentivar decisões criativas e centradas no usuário. Ela cobre psicologia do usuário, teoria das cores, sistemas tipográficos, layouts baseados na proporção áurea e grade de 8 pontos, efeitos visuais e animações. A skill é obrigatoriamente acompanhada pelo arquivo `ux-psychology.md` (sempre lido primeiro) e opcionalmente por outros arquivos de referência detalhada. Ela enfatiza que o agente deve **perguntar** ao usuário antes de assumir preferências (como paleta de cores, estilo ou layout) para evitar os chamados "padrões preguiçosos" de IA, como grids Bento, glassmorphism ou gradientes mesh. Além disso, fornece scripts de auditoria (como `ux_audit`) e um fluxo pós-design que recomenda o uso da skill `web-design-guidelines` para revisar a implementação final quanto a acessibilidade e boas práticas. **Plataformas suportadas:** Claude Code, Cursor, Codex e outras ferramentas de agente de IA que suportam skills baseadas em arquivos SKILL.md.

Funciona com✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/majiayu000/claude-skill-registry/tree/HEAD/skills/design/frontend-design-dgkngk-super-kit

Perguntar na sua IA favorita

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

Documentação

Sistema de Design Frontend

Filosofia: Cada pixel tem um propósito. Restrição é luxo. A psicologia do usuário orienta as decisões. Princípio Central: PENSE, não memorize. PERGUNTE, não presuma.


🎯 Regra de Leitura Seletiva (OBRIGATÓRIA)

Leia os arquivos REQUERIDOS sempre, OPCIONAIS apenas quando necessário:

ArquivoStatusQuando Ler
ux-psychology.md🔴 REQUERIDOLeia sempre primeiro!
color-system.md⚪ OpcionalDecisões de cor/paleta
typography-system.md⚪ OpcionalSeleção/combinação de fontes
visual-effects.md⚪ OpcionalGlassmorphism, sombras, gradientes
animation-guide.md⚪ OpcionalAnimação necessária
motion-graphics.md⚪ OpcionalLottie, GSAP, 3D
decision-trees.md⚪ OpcionalModelos de contexto

🔴 ux-psychology.md = LEIA SEMPRE. Outros = apenas se relevante.


🔧 Scripts de Execução

Execute estes para auditorias (não leia, apenas execute):

ScriptPropósitoUso
Validador ux_auditAuditoria de Psicologia UX e Acessibilidadecall_tool_checklist

⚠️ CRÍTICO: PERGUNTE ANTES DE PRESUMIR (OBRIGATÓRIO)

PARE! Se a solicitação do usuário for aberta, NÃO recorra aos seus favoritos.

Quando o Prompt do Usuário for Vago, PERGUNTE:

Cor não especificada? Pergunte:

"Qual paleta de cores você prefere? (azul/verde/laranja/neutro/outro?)"

Estilo não especificado? Pergunte:

"Qual estilo você está buscando? (minimalista/ousado/retrô/futurista/orgânico?)"

Layout não especificado? Pergunte:

"Você tem uma preferência de layout? (coluna única/grid/assimétrico/largura total?)"

⛔ TENDÊNCIAS PADRÃO A EVITAR (ANTI-PORTO SEGURO):

Tendência Padrão de IAPor Que é RuimPense em Vez Disso
Grids Bento (Clichê Moderno)Usado em todo design de IAPor que este conteúdo PRECISA de um grid?
Hero Split (Esquerda/Direita)Previsível e EntedianteQue tal Tipografia Massiva ou Narrativa Vertical?
Gradientes Mesh/AuroraO fundo "novo" e preguiçosoQual é uma combinação radical de cores?
GlassmorphismA ideia de IA de "premium"Que tal um design plano, sólido e de alto contraste?
Ciano Profundo / Azul FintechPorto seguro da proibição de roxoPor que não Vermelho, Preto ou Verde Neon?
"Orquestrar / Capacitar"Texto gerado por IAComo um humano diria isso?
Fundo escuro + brilho neonExagerado, "visual de IA"O que a MARCA realmente precisa?
Tudo arredondadoGenérico/SeguroOnde posso usar bordas nítidas e brutalistas?

🔴 "Cada estrutura 'segura' que você escolher te aproxima um passo de um template genérico. ASSUMA RISCOS."


1. Análise de Restrições (SEMPRE PRIMEIRO)

Antes de qualquer trabalho de design, RESPONDA A ESTAS ou PERGUNTE AO USUÁRIO:

RestriçãoPerguntaPor Que é Importante
PrazoQuanto tempo?Determina a complexidade
ConteúdoPronto ou placeholder?Afeta a flexibilidade do layout
MarcaDiretrizes existentes?Pode ditar cores/fontes
TecnologiaQual stack?Afeta as capacidades
PúblicoQuem exatamente?Orienta todas as decisões visuais

Público → Abordagem de Design

PúblicoPense Sobre
Geração ZOusado, rápido, mobile-first, autêntico
MillennialsLimpo, minimalista, orientado a valor
Geração XFamiliar, confiável, claro
BoomersLegível, alto contraste, simples
B2BProfissional, focado em dados, confiança
LuxoElegância contida, espaços em branco

2. Princípios de Psicologia UX

Leis Fundamentais (Internalize Estas)

LeiPrincípioAplicação
Lei de HickMais escolhas = decisões mais lentasLimite opções, use revelação progressiva
Lei de FittsMaior + mais próximo = mais fácil de clicarDimensione CTAs adequadamente
Lei de Miller~7 itens na memória de trabalhoAgrupe conteúdo em blocos
Von RestorffDiferente = memorávelTorne CTAs visualmente distintos
Posição SerialPrimeiro/último é mais lembradoInformações chave no início/fim

Níveis de Design Emocional

VISCERAL (instantâneo) → Primeira impressão: cores, imagens, sensação geral
COMPORTAMENTAL (uso)   → Usando: velocidade, feedback, eficiência
REFLEXIVO (memória)    → Depois: "Gosto do que isso diz sobre mim"

Construção de Confiança

  • Indicadores de segurança em ações sensíveis
  • Prova social onde relevante
  • Acesso claro a contato/suporte
  • Design consistente e profissional
  • Políticas transparentes

3. Princípios de Layout

Proporção Áurea (φ = 1.618)

Use para harmonia proporcional:
├── Conteúdo : Barra lateral = aproximadamente 62% : 38%
├── Cada tamanho de título = anterior × 1.618 (para escala dramática)
├── Espaçamento pode seguir: sm → md → lg (cada × 1.618)

Conceito de Grade de 8 Pontos

Todo espaçamento e dimensionamento em múltiplos de 8:
├── Apertado: 4px (meio passo para micro)
├── Pequeno: 8px
├── Médio: 16px
├── Grande: 24px, 32px
├── Extra Grande: 48px, 64px, 80px
└── Ajuste com base na densidade do conteúdo

Princípios Chave de Dimensionamento

ElementoConsideração
Alvos de toqueTamanho mínimo confortável para toque
BotõesAltura baseada na hierarquia de importância
Campos de entradaCombine altura do botão para alinhamento
CartõesPadding consistente, respirável
Largura de leitura45-75 caracteres ideal

4. Princípios de Cor

Regra 60-30-10

60% → Primário/Fundo (base calma, neutra)
30% → Secundário (áreas de suporte)
10% → Destaque (CTAs, destaques, atenção)

Psicologia das Cores (Para Tomada de Decisão)

Se Você Precisa de...Considere MatizesEvite
Confiança, calmaFamília azulVermelhos agressivos
Crescimento, naturezaFamília verdeCinzas industriais
Energia, urgênciaLaranja, vermelhoAzuis passivos
Luxo, criatividadeVerde-marinho profundo, Ouro, EsmeraldaCores vivas de baixo custo
Limpo, minimalistaNeutrosCor avassaladora

Processo de Seleção

  1. Qual é o setor? (restringe opções)
  2. Qual é a emoção? (escolhe o primário)
  3. Modo claro ou escuro? (define a base)
  4. PERGUNTE AO USUÁRIO se não especificado

Para teoria detalhada de cores: color-system.md


5. Princípios de Tipografia

Seleção de Escala

Tipo de ConteúdoProporção da EscalaSensação
UI densa1.125-1.2Compacto, eficiente
Web geral1.25Equilibrado (mais comum)
Editorial1.333Legível, espaçoso
Hero/display1.5-1.618Impacto dramático

Conceito de Combinação

Contraste + Harmonia:
├── DIFERENTE o suficiente para hierarquia
├── SEMELHANTE o suficiente para coesão
└── Geralmente: display + neutro, ou serifada + sem serifa

Regras de Legibilidade

  • Comprimento da linha: 45-75 caracteres ideal
  • Altura da linha: 1.4-1.6 para corpo do texto
  • Contraste: Verifique requisitos WCAG
  • Tamanho: 16px+ para corpo na web

Para tipografia detalhada: typography-system.md


6. Princípios de Efeitos Visuais

Glassmorphism (Quando Apropriado)

Propriedades chave:
├── Fundo semitransparente
├── Desfoque de fundo
├── Borda sutil para definição
└── ⚠️ **AVISO:** Glassmorphism azul/branco padrão é um clichê moderno. Use radicalmente ou não use.

Hierarquia de Sombras

Conceito de elevação:
├── Elementos mais altos = sombras maiores
├── Deslocamento Y > Deslocamento X (luz vinda de cima)
├── Múltiplas camadas = mais realista
└── Modo escuro: pode precisar de brilho em vez de sombra

Uso de Gradientes

Gradientes harmoniosos:
├── Cores adjacentes no círculo cromático (análogas)
├── OU mesmo matiz, luminosidade diferente
├── Evite pares complementares agressivos
├── 🚫 **NENHUM Gradiente Mesh/Aurora** (manchas flutuantes)
└── VARIE radicalmente de projeto para projeto

Para guia completo de efeitos: visual-effects.md


7. Princípios de Animação

Conceito de Temporização

Duração baseada em:
├── Distância (mais longe = mais longo)
├── Tamanho (maior = mais lento)
├── Importância (crítico = claro)
└── Contexto (urgente = rápido, luxo = lento)

Seleção de Suavização

AçãoSuavizaçãoPor Quê
EntrandoEase-outDesacelera, estabiliza
SaindoEase-inAcelera, sai
ÊnfaseEase-in-outSuave, deliberado
LúdicoBounceDivertido, energético

Desempenho

  • Anime apenas transform e opacity
  • Respeite a preferência de movimento reduzido
  • Teste em dispositivos de baixo custo

Para padrões de animação: animation-guide.md, para avançado: motion-graphics.md


8. Checklist de "Fator Uau"

Indicadores Premium

  • Espaços em branco generosos (luxo = espaço para respirar)
  • Profundidade e dimensão sutis
  • Animações suaves e propositais
  • Atenção aos detalhes (alinhamento, consistência)
  • Ritmo visual coeso
  • Elementos personalizados (nem todos padrões)

Construtores de Confiança

  • Pistas de segurança onde apropriado
  • Prova social / depoimentos
  • Proposta de valor clara
  • Imagens profissionais
  • Linguagem de design consistente

Gatilhos Emocionais

  • Hero que evoca a emoção pretendida
  • Elementos humanos (rostos, histórias)
  • Indicadores de progresso/realização
  • Momentos de prazer

9. Anti-Padrões (O que NÃO Fazer)

❌ Indicadores de Design Preguiçoso

  • Fontes padrão do sistema sem consideração
  • Imagens de banco de imagens que não combinam
  • Espaçamento inconsistente
  • Muitas cores concorrentes
  • Paredes de texto sem hierarquia
  • Contraste inacessível

❌ Padrões de Tendência de IA (EVITE!)

  • Mesmas cores em todo projeto
  • Escuro + neon como padrão
  • Roxo/violeta em tudo (PROIBIÇÃO DE ROXO ✅)
  • Grids Bento para landing pages simples
  • Gradientes Mesh e Efeitos de Brilho
  • Mesma estrutura de layout / clone do Vercel
  • Não perguntar as preferências do usuário

❌ Padrões Escuros (Antiéticos)

  • Custos ocultos
  • Urgência falsa
  • Ações forçadas
  • UI enganosa
  • Confirmshaming

10. Resumo do Processo de Decisão

Para CADA tarefa de design:

1. RESTRIÇÕES
   └── Qual é o prazo, marca, tecnologia, público?
   └── Se não claro → PERGUNTE

2. CONTEÚDO
   └── Que conteúdo existe?
   └── Qual é a hierarquia?

3. DIREÇÃO DE ESTILO
   └── O que é apropriado para o contexto?
   └── Se não claro → PERGUNTE (não recorra ao padrão!)

4. EXECUÇÃO
   └── Aplique os princípios acima
   └── Verifique contra anti-padrões

5. REVISÃO
   └── "Isso serve ao usuário?"
   └── "Isso é diferente dos meus padrões?"
   └── "Eu me orgulharia disso?"

Arquivos de Referência

Para orientação mais aprofundada em áreas específicas:


Skills Relacionadas

SkillQuando Usar
frontend-design (esta)Antes de codificar - Aprenda princípios de design (cor, tipografia, psicologia UX)
web-design-guidelinesDepois de codificar - Audite acessibilidade, desempenho e melhores práticas

Fluxo de Trabalho Pós-Design

Após implementar seu design, execute a auditoria:

1. DESIGN   → Leia princípios de frontend-design ← VOCÊ ESTÁ AQUI
2. CÓDIGO   → Implemente o design
3. AUDITORIA → Execute revisão web-design-guidelines
4. CORRIJA  → Trate as descobertas da auditoria

Próximo Passo: Após codificar, use a skill web-design-guidelines para auditar sua implementação quanto a acessibilidade, estados de foco, animações e problemas de desempenho.


Lembre-se: Design é PENSAR, não copiar. Cada projeto merece uma consideração nova baseada em seu contexto e usuários únicos. Evite o Porto Seguro Moderno de SaaS!

Individual skills in this repo

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

majiayu000/claude-skill-registry

Builds, edit or validate Agent Skill through conversational discovery. Use when the user requests to "Create an Agent", "Optimize an Agent" or "Edit an Agent".

majiayu000/claude-skill-registry

Edit existing BMAD agents while maintaining compliance

majiayu000/claude-skill-registry

Edit existing BMAD agents while maintaining compliance

majiayu000/claude-skill-registry

Edit existing BMAD modules while maintaining coherence

majiayu000/claude-skill-registry

Edit existing BMAD modules while maintaining coherence

majiayu000/claude-skill-registry

Analyzes current state and user query to answer BMad questions or recommend the next workflow or agent. Use when user says what should I do next, what do I do now, or asks a question about BMad

majiayu000/claude-skill-registry

Build AI agents with Google ADK Python (Agent Development Kit). Use for multi-agent systems, workflow agents (sequential/parallel/loop), Vertex AI deployment, tool integration, human-in-the-loop.

majiayu000/claude-skill-registry

Build AI agents with Google ADK Python (Agent Development Kit). Use for multi-agent systems, workflow agents (sequential/parallel/loop), Vertex AI deployment, tool integration, human-in-the-loop.

majiayu000/claude-skill-registry

Portfolio allocation and rebalancing optimizer. Manages asset allocation across stocks/cash/bonds, performs periodic rebalancing, and ensures diversification according to market regime and risk tolerance.

majiayu000/claude-skill-registry

Create a hilarious and ultra-realistic video of an anthropomorphic animal acting like a human vlogger in a real-world setting.

majiayu000/claude-skill-registry

Speech-to-text transcription and translation via OpenAI Audio API -- models, response formats, timestamps, prompting, streaming, chunking, and diarization

majiayu000/claude-skill-registry

BlockRun works with Claude Code and Google Antigravity.

majiayu000/claude-skill-registry

This skill should be used when the user asks about libraries, frameworks, API references, or needs code examples. Activates for setup questions, code generation involving libraries, or mentions of specific frameworks like React, Vue, Next.js, Prisma, Supabase, etc.

majiayu000/claude-skill-registry

小省导购员数字人带货版即梦视频提示词生成系统,基于四大智能体协同(提示词生成师、质量管控师、知识库运维师、跨环节适配师),按照"主体+运动+场景+(镜头语言+光影+氛围)"公式输出中英文双版提示词,适配5s短视频。确保人物一致性、视觉连贯性、情绪连贯性,支持知识库智能复用和跨工具适配(Suno音乐、AI绘画),为数字人带货视频提供高质量提示词生成服务。

majiayu000/claude-skill-registry

Upload and manage files using Google Gemini File API via scripts/. Use for uploading images, audio, video, PDFs, and other files for use with Gemini models. Supports file upload, status checking, and file management. Triggers on "upload file", "file API", "upload image", "upload PDF", "upload video", "file management".

majiayu000/claude-skill-registry

CRITICAL: Use for MolyKit AI chat toolkit. Triggers on: BotClient, OpenAI, SSE streaming, AI chat, molykit, PlatformSend, spawn(), ThreadToken, cross-platform async, Chat widget, Messages, PromptInput, Avatar, LLM

majiayu000/claude-skill-registry

AI and machine learning workflow covering LLM application development, RAG implementation, agent architecture, ML pipelines, and AI-powered features.

majiayu000/claude-skill-registry

Analyze images/audio/video with Gemini API (better vision than Claude). Generate images (Imagen 4), videos (Veo 3). Use for vision analysis, transcription, OCR, design extraction, multimodal AI.

majiayu000/claude-skill-registry

Analyze images/audio/video with Gemini API (better vision than Claude). Generate images (Imagen 4), videos (Veo 3). Use for vision analysis, transcription, OCR, design extraction, multimodal AI.

majiayu000/claude-skill-registry

Skill for discovering and researching autonomous AI agents, tools, and ecosystems using the AgentFolio directory.

Habilidades Relacionadas