Communitygithub.com

majiayu000/claude-skill-registry

Pensamento de design e tomada de decisão para IU 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 do Claude oferece um sistema completo de design frontend focado em princípios, não em receitas prontas. Ela orienta o agente de IA a pensar criticamente sobre cada decisão de design, desde análise de restrições até psicologia do usuário, layout, cor, tipografia e efeitos visuais. A skill força o agente a evitar tendências genéricas (como grids Bento, glassmorphism e gradientes mesh) e a perguntar ao usuário sobre preferências de cor, estilo e layout antes de assumir padrões. Inclui uma regra de leitura seletiva que exige a leitura do arquivo `ux-psychology.md` sempre, e demais arquivos apenas quando relevante. Também fornece um script de auditoria (`scripts/ux_audit.py`) para avaliar acessibilidade e psicologia UX. É ideal para uso com Claude Code ou agentes similares que precisam criar interfaces web estéticas e centradas no usuário, evitando o 'porto seguro' do design SaaS moderno.

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

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. Moderação é luxo. A psicologia do usuário impulsiona as decisões. Princípio Central: PENSE, não memorize. PERGUNTE, não suponha.


🎯 Regra de Leitura Seletiva (OBRIGATÓRIA)

Leia os arquivos OBRIGATÓRIOS sempre, os OPCIONAIS apenas quando necessário:

ArquivoStatusQuando Ler
ux-psychology.md🔴 OBRIGATÓRIOLeia sempre primeiro!
color-system.md⚪ OpcionalDecisões de cor/paleta
typography-system.md⚪ OpcionalSeleção/emparelhamento 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 em Tempo de Execução

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

ScriptFinalidadeUso
scripts/ux_audit.pyAuditoria de Psicologia UX e Acessibilidadepython scripts/ux_audit.py <caminho_do_projeto>

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

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

Quando a Solicitação do Usuário é Vaga, 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 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" preguiçosoQual é uma combinação radical de cores?
GlassmorphismA ideia de IA de "premium"Que tal flat sólido e de alto contraste?
Ciano Escuro / Azul FintechPorto seguro da proibição de roxoPor que não Vermelho, Preto ou Verde Neon?
"Orquestrar / Capacitar"Cópia gerada por IAComo um humano diria isso?
Fundo escuro + brilho neonExagerado, "estilo IA"O que a MARCA realmente precisa?
Tudo arredondadoGenérico/SeguroOnde posso usar arestas vivas e brutalistas?

🔴 "Cada estrutura 'segura' que você escolhe 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 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?Direciona todas as decisões visuais

Público → Abordagem de Design

PúblicoPense em
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 comedida, espaço em branco

2. Princípios de Psicologia UX

Leis Fundamentais (Internalize Estas)

LeiPrincípioAplicação
Lei de HickMais opções = decisões mais lentasLimite opções, use divulgaçã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 são mais lembradosInformaçõ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 Grid de 8 Pontos

Todo espaçamento e tamanho 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 entradaAltura do botão correspondente 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 e neutra)
30% → Secundário (áreas de suporte)
10% → Destaque (CTAs, realces, atenção)

Psicologia das Cores (Para Tomada de Decisão)

Se Você Precisar de...Considere MatizesEvite
Confiança, calmaFamília azulVermelhos agressivos
Crescimento, naturezaFamília verdeCinzas industriais
Energia, urgênciaLaranja, vermelhoAzuis passivos
Luxo, criatividadeVerde Musgo Escuro, Dourado, EsmeraldaTons vivos que parecem baratos
Limpo, minimalistaNeutrosCor opressora

Processo de Seleção

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

Para teoria de cores detalhada: color-system.md


5. Princípios de Tipografia

Seleção de Escala

Tipo de ConteúdoProporção de 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 Emparelhamento

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

Regras de Legibilidade

  • Comprimento da linha: 45-75 caracteres ideal
  • Altura da linha: 1.4-1.6 para corpo de 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 nem use.

Hierarquia de Sombras

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

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** (bolhas flutuantes)
└── VARIE radicalmente de projeto para projeto

Para guia completo de efeitos: visual-effects.md


7. Princípios de Animação

Conceito de Timing

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 Easings

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

Performance

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

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


8. Checklist "Fator Uau"

Indicadores Premium

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

Construtores de Confiança

  • Sinais 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 encantamento

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 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 (EVITAR!)

  • 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 Vercel
  • Não perguntar preferências do usuário

❌ Padrões Escuros (Antiéticos)

  • Custos ocultos
  • Urgência falsa
  • Ações forçadas
  • IU 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 estiver 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 estiver claro → PERGUNTE (não use o padrão!)

4. EXECUÇÃO
   └── Aplique os princípios acima
   └── Verifique 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-guidelinesApós codificar - Audite acessibilidade, performance 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 a revisão de web-design-guidelines
4. CORREÇÃO → Aborde os resultados 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 performance.


Lembre-se: Design é PENSAR, não copiar. Cada projeto merece uma consideração fresca 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