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/installDepois, /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ê chamaRevisa 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 chamaO 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.
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 chamaComo 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
text-wrap: wrap · proportional-nums
O título quebra deixando uma palavra sozinha e o preço treme quando muda/color
o agente chamaO 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.
Gera a rampa da marca #0ea5e9 em OKLCH e os tokens pros dois temas/a11y
o agente chamaTeclado 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 chamaAgrupamento, 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.
As configurações estão com cara de lista de compras. Agrupa sem encher de divisor/microcopy
o agente chamaO 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.
Reescreve o diálogo de excluir site e o estado vazio de projetos/variant
você chamaTrê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.
/variant o card de plano, variando a densidade/teardown
você chamaExplica 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.
/teardown como é feita a animação do botão de copiar do interfaces.dev?/break
você chamaRenderiza 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.
/break o card de problema/states
você chamaUma 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.
/states a lista de problemas/handoff
o agente chamaConstró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.
Implementa este frame: figma.com/design/…?node-id=12-345Engenharia
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ê chamaUma 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 chamaProjeto 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 chamaVermelho, 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 chamaBug 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 chamaO 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ê chamaAuditoria 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ê chamaCinco 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ê chamaAuditoria 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ê chamaTrava 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ê chamaO 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çarMais
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.