Awesome Claude Code agents: o que tem na seção de agentes da lista?

Fala aí, beleza? Tu abre o awesome-claude-code atrás de agente pronto pra colar no projeto e trava na primeira dúvida: o que exatamente tem naquela seção de agentes?

O awesome-claude-code é uma coleção curada ("hand-picked") de recursos pro Claude Code, mantida pelo hesreallyhim junto com a comunidade open source

O repo já passou de 50 mil estrelas no GitHub, então não é experimento de fim de semana, é ponto de encontro mesmo

Bora entender o que a área de agentes entrega, e o que ela NÃO é 🙂

O que é o awesome-claude-code e como ele está organizado

O endereço é github.com/hesreallyhim/awesome-claude-code

A descrição do próprio repositório já serve o cardápio: "A delectable showcase of top tier skills, ambidextrous agents, scintillating status lines, top notch developer tooling, and also we have plugins"

Formação Recomendada

Formação Claude Code

Domine Claude Code do absoluto zero até o avançado

• 120 aulas
• 4 projetos
• 9h 45min

Conhecer formação

Ou seja, em português direto: skills, agentes, status lines, ferramentas de desenvolvedor e plugins

O README principal é dividido em seções por tipo de recurso, e existe um bloco próprio dedicado a agentes, ao lado das áreas de Agent Skills, Status Lines, Plugins e Developer Tooling

Fora o README, tem duas coisas que ajudam MUITO a navegar

A primeira é o índice de recursos em THE_RESOURCES_TABLE.csv, na raiz do repositório: é a coleção em formato de tabela, boa pra dar um Ctrl+F sem ficar rolando página gigante

A segunda é a pasta README_ALTERNATIVES/, com versões alternativas do README (README_CLASSIC.md, README_AWESOME.md e README_EXTRA.md)

"Por que várias versões do mesmo README?" Porque lista grande vira parede de texto, e cada versão apresenta o mesmo acervo de um jeito diferente

O que tem na seção de agentes da lista

A seção de agentes é o bloco dedicado a subagents dentro do README, vizinha das seções de skills, status lines, plugins e tooling

Existe uma área própria pra agentes, e os recursos da coleção também aparecem indexados naquele CSV da raiz

Como a lista recebe contribuição da comunidade o tempo todo, o jeito de saber o que está lá hoje é abrir o README (ou o CSV) e olhar na fonte

Agora, o que interessa de verdade é não errar de porta, porque as categorias parecem primas mas entregam coisas diferentes

• Agente (subagent): tu leva pra casa um arquivo Markdown com prompt e configuração, e ele roda como um assistente separado dentro do Claude Code
• Skill: outro tipo de recurso, com seção própria na coleção, então não confunde com agente na hora de copiar o arquivo
• Plugin: empacota e distribui recursos, e agentes que chegam por plugin aceitam campos extras de configuração (já já eu mostro quais)

Se tu chegou procurando "awesome claude code agents" esperando um catálogo oficial da Anthropic, é bom ajustar a expectativa: é curadoria de comunidade, com vitrine organizada

O que é um subagent do Claude Code na prática

Aqui é onde a ficha cai pra quem nunca abriu um desses arquivos

Um subagent do Claude Code é, na prática, um arquivo Markdown com frontmatter YAML

O frontmatter traz os metadados (name, description e tools), e o corpo do arquivo vira o system prompt do subagent

Se tu já mexeu com front matter de post estático, é exatamente a mesma ideia: cabeçalho de metadados em cima, conteúdo embaixo

---
name: revisor-de-diff
description: Revisa o diff atual e aponta problemas de correção
tools: Read, Grep, Glob
---

Você é um revisor de código focado em bugs de correção.
Leia o diff, aponte o que quebra e justifique cada achado.

O corpo ali embaixo é o system prompt, é ele que define a personalidade e o método do agente

E tem o detalhe que mais importa pra quem vai puxar um agente da lista: subagents mantêm contexto separado do agente principal

Traduzindo: a tarefa longa roda no canto dela e não polui a sua conversa principal

Outro ponto que pouca gente sabe: a janela de contexto do subagent é dimensionada pelo modelo DELE, não pelo modelo do agente pai

Se quiser o panorama de quando usar subagentes no projeto, tem post dedicado só pra isso aqui no blog

E quando o agente é distribuído via plugin, o frontmatter aceita campos além de name, description e tools: model, effort, maxTurns, disallowedTools, skills, memory, background e isolation

Dá pra controlar modelo, teto de turnos e até isolamento, o que é bem massa pra agente que roda tarefa pesada

Como usar um agente da lista no seu projeto

Passo a passo curto, sem invenção de comando de instalação:

1. Localize o bloco de agentes no README do awesome-claude-code e abra o recurso que te interessou

2. Copie o conteúdo do arquivo .md do subagent (frontmatter YAML no topo, prompt no corpo)

3. Salve em .claude/agents/nome-do-agente.md dentro do projeto: assim ele vale só ali, e o arquivo entra no versionamento junto com o código

4. Gostou do resultado e quer ele em todos os projetos? Aí sim salva em ~/.claude/agents/nome-do-agente.md, no nível de usuário

5. Pra ajustar o agente, peça ao Claude para criar ou atualizar o subagent, ou edite o arquivo em .claude/agents/ direto

O erro comum deste último passo: contar com o assistente de criação do comando /agents

Ele foi removido na versão 2.1.198 do Claude Code, e a orientação passou a ser justamente essa: pedir ao Claude pra criar/gerenciar, ou editar .claude/agents/ na mão

6. Se o subagent está num diretório que tu adicionou via --add-dir ou /add-dir, reinicie depois de criar ou editar

O erro comum deste passo é achar que salvou e já vale: o Claude Code não observa mudanças em .claude/agents/ dentro de diretórios adicionados desse jeito

Tome cuidado com isso, é o clássico "mas eu criei o agente e ele não aparece" 😀

awesome-claude-code, a-list-of-claude-code-agents e outras coleções: qual é qual

Esse é o ponto que mais confunde, porque tem repo com nome parecido rolando por aí

O caso do a-list-of-claude-code-agents é honesto e vale a leitura

Ele nasceu como awesome-claude-code-agents e foi renomeado, porque o mantenedor explica que manter curadoria de agentes se mostrou inviável, e que não queria ficar como "repo-name-squatter" segurando o nome

A descrição de hoje é direta: uma lista de Claude Code Sub-Agents enviados pela comunidade

Ou seja: se tu quer VOLUME de agentes, o endereço é esse. Se tu quer o mapa geral do ecossistema do Claude Code, o endereço é o awesome-claude-code

Quando vale pegar um subagent pronto da lista

Tem cenário em que garimpar a lista compensa muito, e tem cenário em que é perda de tempo

Compensa quando tu quer uma base de system prompt em vez de escrever do zero: pegar um arquivo que já tem estrutura, tom e escopo definidos e adaptar pro teu contexto economiza um bom tempo

Compensa quando tu precisa isolar tarefa longa: revisão de diff grande, varredura de repositório, pesquisa chata. Como o subagent tem contexto separado, a conversa principal não vira sopa de log

E compensa quando tu quer padronizar o time: o arquivo mora em .claude/agents/ do projeto, entra no git, e todo mundo passa a usar o mesmo agente com o mesmo prompt

Agora o caso oposto, que ninguém fala: às vezes é mais rápido pedir pro Claude escrever o subagent do que caçar um pronto

O arquivo é só Markdown com frontmatter, não é binário nem configuração exótica

Se tu já sabe o que quer que o agente faça, descreve pra ele e revisa o resultado, beleza?

Conclusão

A seção de agentes do awesome-claude-code é porta de entrada, não catálogo oficial

Ela te mostra que existe um bloco dedicado a subagents no meio das outras categorias (skills, status lines, plugins e tooling), e te dá o índice em THE_RESOURCES_TABLE.csv pra vasculhar sem sofrer

Quando a busca é por quantidade de agentes da comunidade, o lugar é o repositório separado, o a-list-of-claude-code-agents, que assume não ser curado

Próximo passo prático: abre o github.com/hesreallyhim/awesome-claude-code, acha o bloco de agentes, escolhe um e salva o .md em .claude/agents/ do teu projeto

Roda ali por uns dias, e só promove pra ~/.claude/agents/ quando ele provar que merece 😀

até o próximo post!