Este repositorio e um fork de mattpocock/skills. Todo credito pela concepcao e arquitetura original vai para Matt Pocock e para os contribuidores do projeto original.
Este fork adiciona governanca orientada a GitHub, documentacao persistente, planejamento por Issues, verificacao automatica do framework, re-deploy das skills e um portao obrigatorio de QA. A ideia e tornar o desenvolvimento com agents rapido sem perder rastreabilidade, feedback e controle humano.
As skills sao pequenas, compostas e adaptaveis. Funcionam com diferentes modelos e CLIs de agents. Hackeie, adapte e faca delas as suas.
Nao e necessario clonar este repositorio. A instalacao pode ser executada diretamente:
curl -fsSL https://raw.githubusercontent.com/alltomatos/skills/main/scripts/setup-alltomatos-skills.sh | bashO script pergunta em qual ambiente instalar e aceita mais de um destino:
| Opcao | Ambiente | Diretorio padrao |
|---|---|---|
1 |
Codex | ~/.codex/skills |
2 |
Claude | ~/.claude/skills |
3 |
Hermes | ~/.hermes/skills |
4 |
Outro CLI | caminho informado pelo usuario |
Para instalar em Codex e Claude, informe 1 2. O script baixa o framework temporariamente, instala as skills nos ambientes escolhidos e nao cria um clone permanente.
Tambem e possivel usar um clone local:
git clone https://github.com/alltomatos/skills.git
cd skills
chmod +x scripts/setup-alltomatos-skills.sh
./scripts/setup-alltomatos-skills.shQuando o /developer detectar uma nova revisao, ele pergunta se voce deseja atualizar agora ou prosseguir sem atualizar; o re-deploy so ocorre com confirmacao explicita. Para executar manualmente:
curl -fsSL https://raw.githubusercontent.com/alltomatos/skills/main/scripts/setup-alltomatos-skills.sh | bash -s -- --redeployOu, a partir de um clone:
./scripts/setup-alltomatos-skills.sh --redeploy ~/.codex/skills ~/.claude/skillsAs instalacoes existentes sao preservadas em backups quando necessario (<skill>.backup.<timestamp>). A cada redeploy, o script mantem apenas o backup mais recente por skill e remove automaticamente os anteriores — nao ha acumulo indefinido de backups nos ambientes instalados.
Depois da instalacao, abra um projeto no agent e execute o arquiteto para conduzir o alinhamento de escopo, design system e arquitetura tecnica:
/architect
(O comando /architect atua na fase de descoberta, questionamento ativo, geracao de mockups/ADD e preparacao dos artefatos arquiteturais antes de repassar para execucao).
O projeto consumidor precisa estar versionado no Git e possuir um repositorio remoto no GitHub. Em um projeto novo:
git init
git add .
git commit -m "chore: initialize repository"
gh repo create <nome> --source . --remote origin --pushSe o ambiente estiver vazio, sem Git ou sem remote GitHub, o arquiteto/developer deve parar e orientar esse processo antes de implementar qualquer coisa.
- Atualizacao do framework: localiza o clone de origem associado as skills instaladas, consulta o remote GitHub, informa commits novos e faz o re-deploy nos ambientes em uso.
- Governanca e Escopo: valida Git, remote GitHub, autenticacao e estado do projeto.
- Arquitetura e Design (/architect): conduz interrogatorio ativo (/grill), projeta a solucao (ADD/SAD, C4, ADRs, esquemas DER), define tokens de design e mockups de tela (
MASTER.md+ overrides), User Guides e obtém aprovação HITL obrigatória do usuário. - Fragmentacao em Issues (/to-issues): fatiar os Epics e especificações aprovadas em slices verticais no GitHub com critérios de aceite verificáveis e dependências (
Blocked by). - Orquestracao (/developer): coordena a fila de tarefas e o loop de desenvolvimento por Issue, gerenciando branches/worktrees.
- Desenvolvimento Orientado a Testes (/tdd): aplica ciclo estrito Red-Green-Refactor para cada issue (com apoio de
/query-docs,/expo-expert,/diagnose). - Garantia de Qualidade Funcional (/qa-analyst): portão obrigatório pré-segurança; confronta requisitos, casos de borda, testes funcionais e critérios de aceite.
- Auditoria e Seguranca E2E (/secure-e2e): portão obrigatório pré-PR; auditoria de código (OWASP), testes ofensivos/negativos em browser e API (
*.spec.sec.ts). - Entrega (PR): somente apos QA e Seguranca verdes, executa o fluxo de Pull Request com confirmacao humana.
O GitHub e a fonte persistente de Issues, escopo, criterios de aceite, dependencias, revisao e historico. ESTADO_DEVELOPER.md e somente a visao operacional da DAG.
O /developer e a Skill Mestra deste fork (renomeada de orchestrator), um conceito que nao existe no repositorio original. Ele avalia, documenta, delega, fiscaliza e expande o fluxo de engenharia.
/orchestrator continua funcionando como atalho de compatibilidade — chama exatamente a mesma skill, para nao quebrar instalacoes feitas antes do rename.
O developer nao executa trabalho pesado diretamente. Ele identifica o problema e delega para a skill correta. Se nao existe skill para o gargalo, invoca /write-a-skill para cria-la.
| Tier | Uso | Comportamento |
|---|---|---|
| T1 | typo, lint, documentacao simples | execucao atomica e verificacao local |
| T2 | testes, pequenos ADRs, mudancas limitadas | valida roadmap e reporta evidencia |
| T3 | schema, autenticacao, dados ou API publica | pausa e exige aprovacao humana |
O modo de falha mais comum e o desalinhamento. grill-me, grill-with-docs e grill-feature-with-docs conduzem uma sessao de perguntas para transformar intencao em requisitos, linguagem de dominio e decisoes registradas.
Uma linguagem compartilhada reduz ambiguidades, melhora nomes de arquivos e funcoes e torna a base de codigo mais navegavel. O /grill-with-docs registra essa linguagem em CONTEXT.md e ADRs. Consulte tambem o exemplo de CONTEXT.md do repositorio course-video-manager original.
O agent precisa de loops de feedback: tipos, browser, testes automatizados e reproducoes minimas. /tdd aplica red-green-refactor e /diagnose conduz o ciclo reproduzir, minimizar, hipotetizar, instrumentar, corrigir e testar regressao.
Agents aceleram a codificacao e tambem podem acelerar a entropia. /improve-codebase-architecture promove design continuo, limites claros e uma base mais testavel e navegavel.
Roadmap, GitHub Issues, documentacao, worktrees e QA formam um ciclo de governanca que limita deriva de escopo e torna as decisoes auditaveis.
| Problema | Skill |
|---|---|
| Governanca e orquestracao | /developer |
| Arquitetura de sistemas, ADD/SAD, C4, Mockups/UI e ADRs | /architect |
| Roadmap e Epics | /roadmap |
| Triagem e gestao de issues | /triage |
| Linguagem de dominio e ADRs | /grill-with-docs |
| Modulo ou feature especifica | /grill-feature-with-docs |
| Fragmentacao em GitHub Issues | /to-issues |
| PRD | /to-prd |
| Bug dificil ou regressao | /diagnose |
| Codigo sem testes | /tdd |
| APIs de terceiros | /query-docs |
| Apps Expo/React Native (EAS, Router, config plugins, upgrade) | /expo-expert |
| E2E e seguranca | /secure-e2e |
| Analise de qualidade | /qa-analyst |
| Arquitetura degradada | /improve-codebase-architecture |
| Prototipo descartavel | /prototype |
| Bootstrap de MVP | /scaffold-mvp |
| Falta de contexto | /zoom-out |
| Servidores MCP | /mcp-builder |
| Deploy e monitoramento SuperKuma | /superkuma-monitoring |
| Pre-commit hooks com Husky/Prettier | /setup-pre-commit |
| Travas de seguranca Git no agent | /git-guardrails-claude-code |
| Criacao, eval e otimizacao de skills | /skill-creator |
| Comunicacao ultra-comprimida (economia de tokens) | /caveman |
| Gargalo nao mapeado | /write-a-skill |
| Alinhamento de plano | /grill-me |
| Handoff | /handoff |
Skills para trabalho diario com codigo: architect, diagnose, grill-with-docs, grill-feature-with-docs, triage, improve-codebase-architecture, tdd, to-issues, to-prd, zoom-out, scaffold-mvp, prototype, roadmap, secure-e2e, qa-analyst, query-docs, expo-expert, mcp-builder, superkuma-monitoring e developer.
architect atua como Arquiteto de Software, Solucoes e Engenharia senior: projeta sistemas para nivel corporativo (Production-Readiness), conduz alinhamento de escopo via interrogatorio ativo (/grill), define design tokens/mockups de tela (padrao MASTER+Overrides) para orientar os desenvolvedores, garante rigor de engenharia (Clean Arch, DDD, sem N+1, OWASP, regressao zero) e gera artefatos chave (ADD/SAD, C4 Model em Mermaid, ADRs, esquemas DER/MER, contratos OpenAPI/gRPC e topologias de nuvem/infraestrutura).
orchestrator e um atalho de compatibilidade: mesma skill que developer (nome antigo, mantido para nao quebrar instalacoes existentes).
expo-expert e conhecimento especializado de stack (Expo/React Native): CNG e config plugins, Expo Modules API, EAS Build/Submit/Update/Workflows, Expo Router, Nova Arquitetura, animacao (Reanimated/Skia), Native UI, DOM components, data fetching e upgrade de SDK. Ensina o agent a consultar a documentacao viva do Expo (llms.txt + .md) em vez de confiar em conhecimento de treino desatualizado.
mcp-builder e guia para construcao de servidores MCP (Model Context Protocol) de alta qualidade em Python (FastMCP) e Node/TypeScript, com esquemas rigorosos, tratamento de erros orientados ao agente e scripts de avaliacao/benchmark.
superkuma-monitoring cobre o ciclo completo de monitoramento SuperKuma: deploy de uma instancia nova (VM Proxmox, Docker Compose + MariaDB), update/upgrade de instancia existente, e operacao do servidor MCP SuperKuma para descobrir a infraestrutura de um site (AD, Proxmox, VMware, Linux, pfSense, Mikrotik, switches, UniFi, TrueNAS, cameras) e transforma-la em monitors, tags, notificacoes e status pages.
Skills de workflow geral: caveman, grill-me, handoff, write-a-skill e skill-creator.
skill-creator e uma meta-skill para criar, testar, avaliar (qualitativamente e quantitativamente com evals/viewer HTML) e otimizar a acuracia de acionamento das descricoes de novas skills.
Skills mantidas para casos especificos: git-guardrails-claude-code, migrate-to-shoehorn, scaffold-exercises e setup-pre-commit.
Skills em personal/, in-progress/ e deprecated/ nao sao instaladas pelo script.
O projeto consumidor deve manter AGENTS.md ou CLAUDE.md, CONTEXT.md ou CONTEXT-MAP.md, DEVELOPER-ROADMAP.md, docs/agents/issue-tracker.md, docs/agents/triage-labels.md, docs/agents/domain.md e docs/adr/ quando houver decisoes relevantes.
Este projeto e um fork de mattpocock/skills. A arquitetura original, a inspiracao e grande parte das skills vieram de Matt Pocock. Consulte tambem a newsletter de skills para acompanhar o trabalho original.