Claude Code Subagentes Não Carregam Habilidades em Sistemas Multiagente

Problema de Carregamento de Habilidades em Multi-Agentes no Claude Code

Um desenvolvedor construindo um sistema multi-agente no Claude Code v2.1.91 identificou uma limitação crítica: subagentes não conseguem acessar habilidades definidas no diretório .claude/skills/, enquanto a sessão principal carrega as habilidades perfeitamente com palavras-chave de ativação, conteúdo completo da habilidade no contexto e portões de qualidade seguidos.

Detalhes do Problema

Ao gerar um subagente através da ferramenta Agent usando subagent_type, o agente tem acesso zero às habilidades. O desenvolvedor testou seis abordagens:

• skills: no frontmatter do agente - documentado como "conteúdo completo da habilidade é injetado na inicialização" mas não tem efeito
• Skill na lista tools: - não reconhecido, a ferramenta Skill não está disponível para subagentes
• Flag CLI --agent myagent - mesmo resultado, habilidades não carregadas
• Equipes de Agentes (TeamCreate) - mesmo resultado
• Carregar habilidade nativamente na sessão pai, depois gerar agente - agente não herda o contexto do pai
• Até habilidades nativas do Claude (frontend-design, claude-api) não estão disponíveis para subagentes

Exemplo de Configuração

A estrutura do arquivo do agente:

---
name: Sales
description: "Agente de vendas"
model: opus
skills:
- outreach
- validator
tools:
- Bash
- Read
- Write
- WebSearch
---

As habilidades existem em .claude/skills/outreach/SKILL.md com frontmatter adequado e funcionam perfeitamente na sessão principal.

Impacto

Esta limitação torna a arquitetura multi-agente "inútil para qualquer coisa que exija conhecimento de domínio" de acordo com o desenvolvedor. Os agentes produzem resultados significativamente piores porque só podem Read os arquivos de habilidades (que os carrega como conteúdo de chat, não como instruções do sistema). A diferença de qualidade entre a sessão principal (habilidades carregadas nativamente) e o subagente (habilidades lidas como markdown) é descrita como "enorme".

O desenvolvedor está executando Claude Code 2.1.91 no macOS e está perguntando se alguém usou com sucesso skills: no frontmatter de agente personalizado, ou se esta é uma limitação conhecida, bug ou erro de configuração.