Claude Code Subagentes No Carga Habilidades en Sistemas Multiagente

Problema de Carga de Habilidades Multi-Agente en Claude Code

Un desarrollador que construye un sistema multi-agente en Claude Code v2.1.91 ha identificado una limitación crítica: los subagentes no pueden acceder a las habilidades definidas en el directorio .claude/skills/, mientras que la sesión principal carga las habilidades perfectamente con palabras clave de activación, contenido completo de habilidades en contexto y puertas de calidad seguidas.

Detalles del Problema

Al generar un subagente a través de la herramienta Agent usando subagent_type, el agente tiene acceso cero a las habilidades. El desarrollador probó seis enfoques:

• skills: en el frontmatter del agente - documentado como "el contenido completo de la habilidad se inyecta al inicio" pero no tiene efecto
• Skill en la lista tools: - no reconocido, la herramienta Skill no está disponible para subagentes
• Banderas CLI --agent myagent - mismo resultado, habilidades no cargadas
• Equipos de Agentes (TeamCreate) - mismo resultado
• Cargar la habilidad de forma nativa en la sesión principal, luego generar el agente - el agente no hereda el contexto principal
• Incluso las habilidades nativas de Claude (frontend-design, claude-api) no están disponibles para subagentes

Ejemplo de Configuración

La estructura del archivo del agente:

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

Las habilidades existen en .claude/skills/outreach/SKILL.md con frontmatter adecuado y funcionan perfectamente en la sesión principal.

Impacto

Esta limitación hace que la arquitectura multi-agente sea "inútil para cualquier cosa que requiera conocimiento del dominio" según el desarrollador. Los agentes producen resultados significativamente peores porque solo pueden Read los archivos de habilidades (lo que los carga como contenido de chat, no como instrucciones del sistema). La diferencia de calidad entre la sesión principal (habilidades cargadas de forma nativa) y el subagente (habilidades leídas como markdown) se describe como "masiva".

El desarrollador está ejecutando Claude Code 2.1.91 en macOS y pregunta si alguien ha usado exitosamente skills: en el frontmatter de agentes personalizados, o si esto es una limitación conocida, un error o un error de configuración.