Mapa da trilha
Conteudo detalhado
📦 O que é o mp-skill
Skills do Matt Pocock empacotadas pra você.
Fork organizado do conjunto de skills publicado por Matt Pocock — empacotado como plugin Claude Code.
Entender a procedência ajuda a confiar nas convenções e a acompanhar upstream.
Fork curado, upstream, plugin Claude Code, autoria.
Cada skill é pequena, encadeável e adaptável — o oposto de frameworks monolíticos.
Esses 3 valores explicam por que skills vencem agentes-gigantes em projetos reais.
Single responsibility, composição, fork-friendly.
engineering = dia-a-dia de código; productivity = workflow não-código; misc = mantido mas raro.
Saber em qual bucket procurar evita perder tempo cavando o repo.
Categorização, descoberta, intenção de uso.
Comparação direta: GSD/BMAD/Spec-Kit são frameworks fechados; mp-skill é coleção solta de skills.
Escolher a ferramenta certa para cada problema — não tudo é skill.
Framework vs toolkit, lock-in, granularidade.
Devs full-stack TypeScript-heavy, builders solo, times pequenos que rodam Claude Code/Codex todo dia.
Conhecer o público alvo ajuda a calibrar expectativas e contribuir bem.
Persona, casos de uso reais, comunidade.
Licença permissiva + fluxo de contribuição via PR — abertura para skills novas e melhorias.
Saber o que pode redistribuir, adaptar e enviar de volta sem atrito.
Licença, PR, CODEOWNERS, atribuição.
🗂️ Estrutura do repositório
Cada pasta tem um propósito claro.
Bucket com skills de código: grill-me, tdd, diagnose, improve-codebase-architecture, etc.
É onde 80% do uso diário acontece — vale conhecer cada uma.
Core skills, gateway, slash commands.
Bucket com skills de processo: handoff, statusline, audit, planning — fora do editor.
Skills de processo são as que mais economizam tempo e contexto entre sessões.
Workflow, handoff, sessão.
Skills mantidas mas usadas esporadicamente — não merecem destaque, não merecem deletar.
Achar a skill certa em momento certo. Vale revisar misc trimestralmente.
Long tail, manutenção mínima.
personal = setup do dono; in-progress = drafts; deprecated = aposentados — nenhum aparece no README/plugin.json.
Entender por que skills somem do índice evita confusão ao contribuir.
Ciclo de vida, draft, promoção, deprecation.
docs/ guarda referências; scripts/ tem utilitários; CLAUDE.md dá regras de organização do próprio repo.
Sem entender CLAUDE.md você quebra convenções ao adicionar skill nova.
Regras de projeto, automação, documentação.
plugin.json registra skills publicadas; README lista cada skill com link para SKILL.md.
Toda skill nova precisa entrar nos dois — caso contrário fica invisível no plugin.
Manifesto, índice, gates de publicação.
⚙️ Instalação e configuração
30 segundos do zero ao primeiro /grill-me.
Ter Claude Code ou Codex instalado, com plan compatível e shell funcional.
Sem o runtime correto, skills nem aparecem — debugar isso depois é frustrante.
Runtime, plan, shell, plugin host.
Comando único que baixa e registra o plugin no Claude Code/Codex.
É o caminho oficial — outras formas de instalar quebram em update.
npx, registry, marketplace, plugin.
Wizard interativo deixa escolher quais skills habilitar — recomendado começar pelas engineering.
Skills demais pra agente = ruído. Curadoria inicial vale ouro.
Curadoria, escopo, ativação seletiva.
Slash command que cria CONTEXT.md inicial, configura defaults e valida triggers.
Pula muito setup manual e garante que skills disparem nos gatilhos certos.
Bootstrap, defaults, triggers.
GitHub Issues do mp-skill com labels (bug, skill-request, docs) — fila pública de demanda.
Usar a label certa acelera resposta e evita issues duplicadas.
Triage, label, prioridade, comunidade.
Checklist: listar skills no agente, rodar /grill-me em um repo dummy e checar logs.
Validar cedo evita descobrir que a instalação falhou só na hora do uso.
Smoke test, dry-run, logs.