Skills Para Engenheiros de Verdade (Fork)

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.

Quickstart

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 | bash

O 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.

Instalacao a partir de um clone

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.sh

Re-deploy das skills

Quando o /orchestrator detectar uma nova revisao, ele executara o re-deploy automaticamente. Para executar manualmente:

curl -fsSL https://raw.githubusercontent.com/alltomatos/skills/main/scripts/setup-alltomatos-skills.sh | bash -s -- --redeploy

Ou, a partir de um clone:

./scripts/setup-alltomatos-skills.sh --redeploy ~/.codex/skills ~/.claude/skills

As instalacoes existentes sao preservadas em backups quando necessario.

Primeiro uso

Depois da instalacao, abra um projeto no agent e execute:

/orchestrator

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 --push

Se o ambiente estiver vazio, sem Git ou sem remote GitHub, o orchestrator deve parar e orientar esse processo antes de implementar qualquer coisa.

Fluxo de trabalho: engenharia de ciclo fechado

1. Atualizacao do framework: o orchestrator 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.
2. Governanca: valida Git, remote GitHub, autenticacao e estado do projeto.
3. Documentacao: cria ou atualiza AGENTS.md/CLAUDE.md, CONTEXT.md, docs/agents/, ADRs e ORCHESTRATOR-ROADMAP.md.
4. Estrategia: usa /roadmap e /grill-with-docs para definir Epics, linguagem de dominio e decisoes.
5. Fragmentacao: usa /to-issues para publicar slices verticais no GitHub com criterios de aceite e dependencias.
6. Execucao: delega tarefas pequenas, usando worktrees para paralelismo seguro.
7. Feedback: usa /tdd, /query-docs, /diagnose e /secure-e2e conforme o risco.
8. QA: invoca /qa-analyst obrigatoriamente antes de qualquer PR, sem excecao de tier.
9. Entrega: somente apos QA aprovado, executa o fluxo de PR disponivel no ambiente com confirmacao humana.

O GitHub e a fonte persistente de Issues, escopo, criterios de aceite, dependencias, revisao e historico. ESTADO_ORQUESTRATOR.md e somente a visao operacional da DAG.

O Orchestrator

O /orchestrator e a Skill Mestra deste fork, um conceito que nao existe no repositorio original. Ele avalia, documenta, delega, fiscaliza e expande o fluxo de engenharia.

Regra de ouro

O orchestrator 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.

Tiers de risco

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

Por que estas skills existem

1. O agent nao fez o que eu queria

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.

2. O agent e muito verboso

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.

3. O codigo nao funciona

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.

4. Construimos uma bola de lama

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.

5. Risco do desenvolvimento autonomo

Roadmap, GitHub Issues, documentacao, worktrees e QA formam um ciclo de governanca que limita deriva de escopo e torna as decisoes auditaveis.

Tabela de delegacao

Problema	Skill
Governanca e orquestracao	/orchestrator
Roadmap e Epics	/roadmap
Setup documental	/setup-skills
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
Criacao, eval e otimizacao de skills	/skill-creator
Gargalo nao mapeado	/write-a-skill
Alinhamento de plano	/grill-me
Handoff	/handoff

Referencia de skills

Engineering

Skills para trabalho diario com codigo: diagnose, grill-with-docs, grill-feature-with-docs, triage, improve-codebase-architecture, setup-skills, tdd, to-issues, to-prd, zoom-out, scaffold-mvp, prototype, roadmap, secure-e2e, qa-analyst, query-docs, expo-expert, mcp-builder e orchestrator.

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.

Productivity

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.

Misc

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.

Governanca documental

O projeto consumidor deve manter AGENTS.md ou CLAUDE.md, CONTEXT.md ou CONTEXT-MAP.md, ORCHESTRATOR-ROADMAP.md, docs/agents/issue-tracker.md, docs/agents/triage-labels.md, docs/agents/domain.md e docs/adr/ quando houver decisoes relevantes.

Creditos e origem

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.