8000 GitHub - alltomatos/skills: Skills for Real Engineers. Straight from my .claude directory. · GitHub
[go: up one dir, main page]

Skip to content
< 8000 /react-partial>
alltomatosPublic
forked from mattpocock/skills

About

Skills for Real Engineers. Straight from my .claude directory.

Resources

Stars

21 stars

Watchers

1 watching

Forks

 
 

Latest commit

 

History

155 Commits

Folders and files

Repository files navigation

Skills

Skills Para Engenheiros de Verdade (Fork)

skills.sh

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 /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 -- --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 (<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.

Primeiro uso

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

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

Fluxo de trabalho: engenharia de ciclo fechado

  1. 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.
  2. Governanca e Escopo: valida Git, remote GitHub, autenticacao e estado do projeto.
  3. 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.
  4. 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).
  5. Orquestracao (/developer): coordena a fila de tarefas e o loop de desenvolvimento por Issue, gerenciando branches/worktrees.
  6. Desenvolvimento Orientado a Testes (/tdd): aplica ciclo estrito Red-Green-Refactor para cada issue (com apoio de /query-docs, /expo-expert, /diagnose).
  7. 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.
  8. 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).
  9. 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

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.

Regra de ouro

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.

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

Referencia de skills

Engineering

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.

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, DEVELOPER-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.

About

Skills for Real Engineers. Straight from my .claude directory.

Resources

Stars

21 stars

Watchers

1 watching

Forks

Releases

Packages

Contributors

Languages

0