Клод Код Сабагенты Не Загружают Навыки в Мультиагентных Системах

Проблема загрузки навыков в мульти-агентной системе Claude Code

Разработчик, создающий мульти-агентную систему в Claude Code v2.1.91, обнаружил критическое ограничение: суб-агенты не могут получить доступ к навыкам, определённым в директории .claude/skills/, в то время как основная сессия идеально загружает навыки с ключевыми словами-триггерами, полным содержимым навыков в контексте и соблюдением контрольных точек качества.

Подробности проблемы

При создании суб-агента через инструмент Agent с использованием subagent_type, агент не имеет доступа к навыкам. Разработчик протестировал шесть подходов:

• skills: во фронтмете агента — задокументировано как «полное содержимое навыка внедряется при запуске», но не имеет эффекта
• Skill в списке tools: — не распознаётся, инструмент Skill недоступен для суб-агентов
• Флаг CLI --agent myagent — тот же результат, навыки не загружаются
• Команды агентов (TeamCreate) — тот же результат
• Загрузка навыка нативно в родительской сессии с последующим созданием агента — агент не наследует контекст родителя
• Даже нативные навыки Claude (frontend-design, claude-api) недоступны для суб-агентов

Пример конфигурации

Структура файла агента:

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

Навыки существуют по пути .claude/skills/outreach/SKILL.md с корректным фронтметом и идеально работают в основной сессии.

Влияние

Согласно разработчику, это ограничение делает мульти-агентную архитектуру «бесполезной для всего, что требует предметных знаний». Агенты выдают значительно худший результат, потому что они могут только Read файлы навыков (что загружает их как содержимое чата, а не системные инструкции). Разница в качестве между основной сессией (навыки загружены нативно) и суб-агентом (навыки прочитаны как markdown) описывается как «огромная».

Разработчик использует Claude Code 2.1.91 на macOS и спрашивает, удалось ли кому-либо успешно использовать skills: во фронтмете пользовательского агента, или это известное ограничение, ошибка или ошибка конфигурации.