As skills que eu uso todos os dias

Matheus Cardosoatualizado em

Skills de agente que eu uso todo dia no Claude Code. Metade é interface, metade é engenharia, cada uma com o número exato e o critério de pronto que um prompt de memória não traz.


Instalação

Duas portas. O plugin instala o conjunto como pacote gerenciado que atualiza quando eu publico. O clone coloca os arquivos onde você pode editar. Escolha uma: instalar as duas te deixa com cada skill duas vezes.

# plugin: atualiza junto com o repositório
/plugin marketplace add matheuscarddoso/skills
/plugin install mcardoso-skills@mcardoso

# ou clone, se você quer editar as skills
git clone https://github.com/matheuscarddoso/skills.git ~/Projects/skills
~/Projects/skills/scripts/install

Depois, /ask e uma frase descrevendo sua situação. Ele decide qual skill resolve e chama.

Se você só for adotar três, adote /grill, /review e /designer. Uma evita construir errado, a outra evita entregar errado, e a terceira evita entregar feio.


Interface

Seis especialistas, uma por disciplina, que o agente consulta enquanto constrói. Uma revisão que passa por todas. Cinco ferramentas que produzem em vez de julgar.

/designer

você chama

Revisa uma tela, um fluxo, uma branch ou um PR passando por todas as skills de interface, e devolve um veredito só, ranqueado, com arquivo e linha em cada achado.

Parece bom! Algumas sugestões:

- melhorar o contraste

- ajustar alguns espaçamentos

- talvez revisar os textos

/designer revisa o checkout, inclusive o estado vazio e o de erro

/polish

o agente chama

O acabamento com valores exatos: raio concêntrico, sombra no lugar de borda, contorno de imagem, alinhamento óptico, pressão em 0.96, troca de ícone, entrada, saída e gesto.

Relatório de março

raio 12 por fora e por dentro · borda sólida · imagem sem contorno

Deixa esse card com acabamento: raio, sombra e a pressão do botão

/typography

o agente chama

Como o texto renderiza: escolha e carregamento de fonte, escala, altura de linha, quebra com balance e pretty, números tabulares, truncamento e pontuação.

Os detalhes que fazem uma interface parecer certa

R$ 1.111,11R$ 8.888,88

text-wrap: wrap · proportional-nums

O título quebra deixando uma palavra sozinha e o preço treme quando muda

/color

o agente chama

O sistema de cor: rampas em OKLCH, tokens por papel, conversão de formato, gamut, contraste medido no par que de fato renderiza e tema escuro.

hsl 30 50%hsl 150 50%hsl 250 50%hsl 320 50%
Gera a rampa da marca #0ea5e9 em OKLCH e os tokens pros dois temas

/a11y

o agente chama

Teclado e foco, nome acessível, semântica, formulário, leitor de tela, área de toque e movimento reduzido, contra a WCAG 2.2.

Esse formulário de cadastro funciona só com teclado e leitor de tela?

/layout

o agente chama

Agrupamento, alinhamento, ordem de leitura, breakpoint que vem do conteúdo e espaço pro texto traduzido, pra o layout aguentar ser redimensionado, traduzido ou espelhado.

Nome:Ana Souza
E-mail:ana@acme.com
Plano:Pro
Cobrança:Mensal
As configurações estão com cara de lista de compras. Agrupa sem encher de divisor

/microcopy

o agente chama

O texto da interface: rótulo que diz a ação, erro que diz o que fazer, estado vazio que ensina e confirmação que nomeia a consequência.

Tem certeza?Essa ação não pode ser desfeita. Confirme para continuar.
NãoOK
Reescreve o diálogo de excluir site e o estado vazio de projetos

/variant

você chama

Três versões genuinamente diferentes de um componente, num eixo que você nomeia, atrás de um seletor na página real. Você alterna e promove a que ganhar.

ProR$ 49Projetos ilimitadosAssinar
/variant o card de plano, variando a densidade

/teardown

você chama

Explica como uma interface, um efeito ou uma animação de outro site foi feita, separando o que mediu do que deduziu, e fecha com a receita que transfere pro seu projeto.

Copiar página
/teardown como é feita a animação do botão de copiar do interfaces.dev?

/break

você chama

Renderiza um componente sob todo cenário que alcança ele em produção, texto enorme, zero item, 320px, RTL, numa página temporária, e marca o que quebrou.

PRB-128Checkout falha128
/break o card de problema

/states

você chama

Uma bancada com cada estado de um componente, carregando, vazio, erro, plano e permissão, com dado de mentira e um seletor por teclado, pra trabalhar um de cada vez.

Checkout falha com descontoBusca devolve dado velhoUpload de avatar expira
/states a lista de problemas

/handoff

o agente chama

Constrói a partir de um link do Figma ou de um print, com os tokens e componentes do projeto, e compara lado a lado antes de dizer que terminou.

Figma · node 12:345
Implementa este frame: figma.com/design/…?node-id=12-345

Engenharia

Alinhar antes de construir, construir com teste, diagnosticar, auditar e subir. Nenhuma assume linguagem: o específico de cada stack mora em referências.

/grill

você chama

Uma entrevista dura antes de construir, uma pergunta por vez, até não sobrar decisão em aberto.

1. Quem pode cancelar: a pessoa, o suporte, ou os dois?
   Recomendo os dois, com motivo obrigatório pro suporte.
/grill quero adicionar assinatura com cobrança recorrente

/kickoff

o agente chama

Projeto novo: stack com justificativa escrita, segurança no dia um, infraestrutura reprodutível e o loop de feedback antes do primeiro commit.

Stack       Next.js + Postgres, porque…
Segurança   headers, secrets fora do repo, CI com auditoria
Loop        lint + tipos + teste rodando antes do 1º commit
Começa um painel de cobrança do zero

/tdd

o agente chama

Vermelho, verde, refatora, uma fatia vertical por vez.

✗ prorates a mid-cycle upgrade      vermelho, pelo motivo certo
✓ prorates a mid-cycle upgrade      verde, o mínimo
↺ extrai daysLeft()                 refatora, ainda verde
Faz o cálculo de proração com TDD

/investigate

o agente chama

Bug difícil e regressão de performance, em seis fases com trava entre elas: reproduzir, isolar, minimizar, explicar, corrigir, travar.

Fase 1  Reproduzido: 2 entregas com 40ms de intervalo
Fase 3  Mínimo: sem lock na chave de idempotência
Trava   teste vermelho antes do fix, verde depois
O webhook de pagamento às vezes processa duas vezes

/review

o agente chama

O diff em dois eixos que não se contaminam, padrão e spec, em subagentes paralelos.

Padrão  2 achados   catch genérico em billing.ts:88
Spec    1 achado    o reembolso parcial da issue não foi feito
Revisa o diff antes do PR

/engineer

você chama

Auditoria em todas as camadas, segurança primeiro, a partir de um mínimo inegociável de dez itens, com o fix específico em cada achado.

[CRÍTICO] query sem limite em payouts.ts:41
[ALTO]    retry sem backoff no gateway
Veredito  corrige antes
/engineer o módulo de repasse

/qa

você chama

Cinco checks obrigatórios, fluxos de verdade de ponta a ponta, edge cases, e o que deveria estar testado e não está.

✓ build, tipos, lint, testes, fluxo feliz
✗ cupom expirado no meio do checkout: 500
Gap: nenhum teste cobre troca de moeda
/qa o fluxo de checkout

/security

você chama

Auditoria em três níveis, e o terceiro encadeia achados médios até virarem críticos.

Cadeia: ID sequencial + rota sem dono checado + resposta com e-mail
        = qualquer pessoa lista todos os clientes [CRÍTICO]
/security antes de abrir a API pública

/deploy

você chama

Trava de segurança, reprodutibilidade a partir de um clone limpo, e os checks de cada modelo de distribuição.

✓ clone limpo builda e sobe
✗ .env.example sem STRIPE_WEBHOOK_SECRET
✓ migrations reversíveis, healthcheck real
/deploy a primeira versão em produção

/ask

você chama

O roteador sobre todas as outras. Descreva a situação e ele diz qual skill resolve, e por quê.

/break: renderiza o card com o pior conteúdo numa página só
e diz qual skill é dona de cada quebra.
/ask o card quebra com nome grande e não sei por onde começar

Mais

Tudo isso, com as referências de cada skill e o orçamento de tokens, está em matheuscarddoso/skills. A suíte de interface parte das skills de Jakub Krehel e dos princípios de Emil Kowalski, ambos sob licença MIT.

Cada regra destas skills é uma aula, com demo e exercício, no craft.ocardoso.com.