Agent skills e subagents (Claude Code)

Corpus consultável sobre os dois mecanismos de customização do Claude Code ensinados nos cursos Introduction to agent skills e Introduction to subagents da Anthropic Academy. Recorra a ele para criar, configurar, compartilhar e depurar skills, e para entender quando delegar a um subagent em vez de carregar uma skill.

Conceitos centrais

Uma skill é um arquivo markdown (SKILL.md) que ensina o Claude a fazer algo uma vez; o Claude carrega só o name e a description no startup e lê o conteúdo completo sob demanda, quando o pedido casa semanticamente com a description — sem encher o context window.

Fonte: introduction-to-agent-skills--documento-de-estudo.md › What are skills?

Um subagent é um assistente especializado que roda no seu próprio context window com um system prompt custom; recebe uma task, trabalha isolado e devolve apenas um resumo à thread principal, descartando todo o trabalho intermediário — o mecanismo serve para gerenciar o uso do context.

Fonte: introduction-to-subagents--documento-de-estudo.md › What are subagents?

Skill vs subagent (o contraste-chave): a skill adiciona conhecimento ao contexto atual (suas instruções se juntam à conversa), enquanto o subagent isola o trabalho num contexto separado e só retorna o resultado. Use skill para expertise task-specific aplicada na conversa; use subagent para delegar com tool access próprio e isolamento. Diferem ainda de CLAUDE.md (always-on), hooks (event-driven) e MCP (tools externas).

Fonte: introduction-to-agent-skills--documento-de-estudo.md › How skills compare to other Claude Code features

Configuração: o open standard agentskills.io exige name (kebab-case, ≤64 chars, casa com o diretório) e description (≤1.024 chars, campo de matching), e oferece allowed-tools e model. Skills grandes usam progressive disclosure: SKILL.md < 500 linhas + pastas scripts/, references/, assets/ lidas só quando necessário.

Fonte: introduction-to-agent-skills--documento-de-estudo.md › Configuration and multi-file skills

Importante: subagents não herdam suas skills automaticamente — built-in agents não acessam skills, e subagents custom só as carregam quando você as lista no arquivo do agent.

Fonte: introduction-to-agent-skills--documento-de-estudo.md › Sharing skills

Topic Index

Referências (quando ler cada uma)

• references/agent-skills.md — tudo sobre skills: o que são, como criar, frontmatter e multi-file skills, comparação com outros recursos, compartilhamento e troubleshooting. Leia ao criar/configurar/depurar uma skill.
• references/subagents.md — tudo sobre subagents: o que são e como gerenciam o context window, como criar um com /agents e seus campos; mais a configuração de skills como vista no curso de subagents. Leia ao decidir delegar a um subagent ou ao criar um.

Escopo e limites

• Cobre apenas o que está nos dois cursos introdutórios; não substitui a documentação oficial nem o open standard agentskills.io para campos/flags não mencionados nas aulas.
• Não cobre MCP servers, hooks ou CLAUDE.md em profundidade — eles aparecem só na comparação de recursos.
• As fontes são transcrições de vídeo com legendas automáticas corrigidas de forma conservadora; comandos e nomes exatos de CLI devem ser confirmados na documentação atual antes de automatizar.