Mapa da trilha
Conteudo detalhado
🧩 Composicao de skills
Skills viram pipelines quando voce encadeia — saida de uma alimenta a proxima.
Formas tipicas de encadear skills — sequencial, paralelo, condicional — cada uma com gatilho proprio.
Sem padrao, voce reinventa pipeline a cada feature. Padroes nomeados aceleram decisao.
Pipeline, fan-out/fan-in, gate, orquestracao.
Fluxo padrao do Matt — alinhamento vira PRD, vira issues, vira ciclos TDD ate merge.
E o exemplo vivo de composicao. Reproduzir o fluxo da resultados imediatos.
Handoff, contrato de saida, fluxo canonico.
Skill que orquestra outras skills — usada quando o mesmo encadeamento se repete em varios projetos.
Macro cedo demais e premature abstraction. Tarde demais e copy-paste de pipeline.
Regra dos tres, abstracao oportuna, skill compositora.
Skills nao guardam estado — CONTEXT.md e o canal de memoria entre elas dentro do projeto.
Sem estado compartilhado, cada skill reaprende dominio. Com CONTEXT.md, continuidade.
Persistencia, contrato documental, single source of truth.
Encadeamentos longos demais, skills com escopo sobreposto, dependencias ciclicas.
Detectar cedo evita pipeline fragil que ninguem entende.
Overcoupling, escopo difuso, ciclo, prompt explosion.
Caso de refactor: /zoom-out → /improve-codebase-architecture → /to-issues → /tdd → review.
Ver composicao completa em problema real fixa o padrao na cabeca.
Refactor seguro, encadeamento real, gates intermediarios.
✏️ Customizando skills
Pegue a skill, faca sua — sem fork desnecessario, sem perder upstream.
Anatomia do arquivo: frontmatter YAML (nome, descricao, triggers) e corpo Markdown com instrucoes.
Sem entender estrutura, customizacao quebra o carregamento da skill.
Frontmatter, body, secoes obrigatorias, parser.
Campos que decidem quando o agente carrega a skill — frases, contextos, gatilhos explicitos.
Trigger ruim = skill nunca dispara ou dispara sempre. Description fraca = agente ignora.
Trigger phrase, description, scope, false positive.
Skills tem templates (PRD, ADR, issue). Editar templates ajusta saida sem mexer na logica.
Customizacao mais barata e mais segura — voce muda forma, mantem comportamento.
Template, output contract, sections, placeholders.
Fork = copia independente; override = skill local com mesmo nome sobrepoe a global naquele projeto.
Fork perde upstream. Override mantem atualizacoes. Decisao errada custa caro depois.
Scope local/global, precedencia, upstream, drift.
Tratar diretorio de skills como repo — branches, PRs, review e changelog para mudancas.
Sem versionamento, customizacao vira ".skill.bak.final.v2". Time perde rastreabilidade.
Skills-as-code, semver, changelog, review de skill.
Walkthrough adaptando /grill-with-docs a um dominio especifico — termos, perguntas, refs proprias.
Ver customizacao real demove o medo de mexer em skill "oficial".
Domain fit, prompt local, refs especificas, fork minimo.
🤝 Integracao com outros agentes
Claude Code, Codex, Cursor — uma skill em todos, sem reescrever.
Cada agente carrega skills de jeito diferente. Mapear o que e portavel vs o que e especifico.
Manter N versoes da mesma skill e insustentavel. Saber o que e comum reduz copia.
Runtime, portabilidade, capability matrix, surface area.
Skill que empacota uma SKILL.md no formato portavel e emite para Claude Code, Codex e outros.
Build once, run anywhere — sem polyskill, voce mantem N copias divergentes.
Source of truth, transpile, adapter, runtime target.
Slash commands, hooks, MCP, permissoes — cada runtime expoe um subset. Saber quais quebram portabilidade.
Skill que assume hook do Claude Code morre no Codex. Mapear gaps antes evita debug confuso.
Hook, MCP, slash command, permission, sandbox.
Expor skills via servidor MCP — qualquer agente compativel consome sem instalar local.
Time inteiro usa a mesma versao de skill, com atualizacao centralizada.
MCP server, tool, manifest, descoberta dinamica.
Rodar skills em pipelines (GitHub Actions, GitLab CI) — review, lint, doc update automatizados.
Skill no CI vira gate confiavel. Sai do "se lembrar de rodar" para "sempre roda".
Pipeline, gate, headless agent, artefato, idempotencia.
Workflow que dispara /tdd em PRs novos — agente gera teste falhante, implementa, abre commit.
Caso pratico fecha a trilha: tudo aprendido roda sem voce abrir a IDE.
Workflow YAML, secret, agent runner, PR automation.