Claude Code subagents fail 2.8x more often than skills

Описание и применение

Подагенты Claude Code срабатывают 2,8‑раз чаще, чем навыки, из‑за отсутствия обязательных полей name и description. Добавление этих полей устраняет 15 669 из 21,9 % неудач.

Задача

Subagents in Claude Code repositories fail to register 21.9% of the time, 2.8 times higher than skills’ 7.9% failure rate, due to missing required name and description fields.

Результат

Adding required frontmatter fields to subagents eliminates 15,669 of 21.9% failures, aligning subagent reliability with skills.

Рабочий процесс

• 1. Scan repository for subagent markdown files.
• 2. Verify frontmatter contains both "name" and "description" keys.
• 3. If missing, add a descriptive name and a one‑sentence description.
• 4. Commit changes and push to repository.
• 5. Re‑run the Claude Code indexer to confirm registration.

Доказательства

Subagents fail at 21.9 percent, skills at 7.9 percent, and the gap is 2.8 times.

Источник

Only name and description are required for subagents.

Источник