Verificando acesso...

MÓDULO 2.2

đŸ› ïž Skills compartilhadas vs agents divergentes

SKILL.md funciona nos dois. Agents divergem em formato. Onde aproveitar, onde adaptar.

1

📩 SKILL.md: o formato universal

SKILL.md tem YAML frontmatter + corpo markdown. Esse formato Ă© o Agent Skills standard — funciona em Claude Code, Codex CLI, Cursor, Gemini CLI.

Campos do frontmatter

  • name — identificador Ășnico
  • description — quando a skill deve ser invocada
  • allowed-tools — quais ferramentas a skill usa
  • disable-model-invocation — true se sĂł invocação manual

Lição: uma skill bem escrita vira ativo. VocĂȘ investe uma vez, qualquer agente lĂȘ. Maior alavancagem do curso.

2

🔀 Migrando skills: copiar de pasta

Comando Ășnico:

cp -r .claude/skills/ .agents/skills/
# ou, melhor ainda:
ln -s "$(pwd)/.claude/skills" .agents/skills

Se a skill usa só name, description, allowed-tools e disable-model-invocation, funciona sem alteração. Campos Claude-only (path-scoped, hooks) ignorados pelo Codex sem quebrar.

3

đŸ€– Agents: markdown vs TOML

Aqui mora a divergĂȘncia principal. Diferente filosofia de design, mesma funcionalidade.

Claude (.md)

  • YAML frontmatter
  • Corpo markdown = system prompt
  • Mais legĂ­vel como doc
  • Comando /agents cria interativo

Codex (.toml)

  • Campo developer_instructions explĂ­cito
  • Mais campos opcionais: model, sandbox_mode, mcp_servers
  • Mais controle granular
  • Spawn explĂ­cito
4

⚡ Spawn explícito (Codex) vs automático (Claude)

Diferença que muda workflow: Claude DECIDE quando invocar baseado na description. Codex SÓ invoca quando vocĂȘ escreve spawn.

Claude: description Ă© trigger

Escreva descriptions especĂ­ficas com "Use when..." pra disparar correto.

description: Use when reviewing PRs to find regressions and missing test coverage

Codex: spawn Ă© comando

VocĂȘ escreve literalmente. Mais controle, menos surpresa.

spawn pr-reviewer pra revisar o branch atual
5

🔧 Mantendo skills em sincronia

Sem estratĂ©gia explĂ­cita, vocĂȘ atualiza skill num lado, esquece do outro, agente B fica com versĂŁo velha → bug silencioso.

A

Symlink (recomendado)

ln -s ../.claude/skills .agents/skills — uma fonte só, atualiza em qualquer lado e ambos enxergam.

B

Sync script

Hook PostToolUse no Claude que copia .claude/skills/ → .agents/skills/ quando algo muda.

C

Skills sĂł em .agents/skills/ (limpo)

Coloca tudo em .agents/skills/, faz .claude/skills/ ser symlink. PadrĂŁo moderno em 2026.

6

📐 Padrão narrow agents

Os melhores subagents são narrow: um trabalho claro, surface de tools que combina, instruçÔes que evitam drift.

✓ Narrow (bom)

  • ✓pr-reviewer: revisa PR, retorna crĂ­ticos/sugestĂ”es/nits
  • ✓dead-code-audit: varre imports e funçÔes sem caller
  • ✓test-runner: roda testes especĂ­ficos e resume

✗ Broad (ruim)

  • ✗helper: faz qualquer coisa
  • ✗developer: pode editar tudo
  • ✗everything-bot: sem foco

Regra: se vocĂȘ nĂŁo consegue descrever o trabalho do agent em 1 frase, ele Ă© broad demais. Quebre em 2 ou 3 narrow.

📚 Resumo

✓
SKILL.md Ă© universal — investimento amortizado
✓
Migrar skills Ă© literalmente cp — ou symlink
✓
Agents divergem em formato (md vs toml)
✓
Spawn explĂ­cito (Codex) vs auto (Claude)
✓
Symlink ou sync script evita drift
✓
Narrow > broad agents

PrĂłximo:

2.3 — Session handoff entre agentes

← AnteriorPróximo: Session Handoff →