Claude-Code-Subagenten laden keine Fähigkeiten in Multi-Agenten-Systemen

Problem beim Laden von Multi-Agent-Fähigkeiten in Claude Code

Ein Entwickler, der ein Multi-Agent-System in Claude Code v2.1.91 aufbaut, hat eine kritische Einschränkung festgestellt: Subagenten können nicht auf Fähigkeiten zugreifen, die im .claude/skills/-Verzeichnis definiert sind, während die Hauptsitzung Fähigkeiten perfekt mit Trigger-Keywords, vollständigem Fähigkeitsinhalt im Kontext und befolgten Qualitätskontrollen lädt.

Problemdetails

Wenn ein Subagent über das Agent-Tool mit subagent_type erstellt wird, hat der Agent keinen Zugriff auf Fähigkeiten. Der Entwickler testete sechs Ansätze:

• skills: in der Agent-Frontmatter – dokumentiert als „vollständiger Fähigkeitsinhalt wird beim Start eingespielt“, hat aber keine Wirkung
• Skill in der tools:-Liste – wird nicht erkannt, das Skill-Tool steht Subagenten nicht zur Verfügung
• --agent myagent CLI-Flag – gleiches Ergebnis, Fähigkeiten werden nicht geladen
• Agent Teams (TeamCreate) – gleiches Ergebnis
• Fähigkeit nativ in der Elternsitzung laden, dann Agent erstellen – Agent erbt den Elternkontext nicht
• Sogar native Claude-Fähigkeiten (frontend-design, claude-api) stehen Subagenten nicht zur Verfügung

Konfigurationsbeispiel

Die Agent-Dateistruktur:

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

Fähigkeiten existieren unter .claude/skills/outreach/SKILL.md mit korrekter Frontmatter und funktionieren in der Hauptsitzung einwandfrei.

Auswirkungen

Diese Einschränkung macht die Multi-Agent-Architektur laut dem Entwickler „unbrauchbar für alles, was Domänenwissen erfordert“. Agenten liefern deutlich schlechtere Ergebnisse, weil sie die Fähigkeitsdateien nur Readen können (was sie als Chat-Inhalt lädt, nicht als Systemanweisungen). Der Qualitätsunterschied zwischen Hauptsitzung (Fähigkeiten nativ geladen) und Subagent (Fähigkeiten als Markdown gelesen) wird als „massiv“ beschrieben.

Der Entwickler verwendet Claude Code 2.1.91 auf macOS und fragt, ob jemand erfolgreich skills: in der benutzerdefinierten Agent-Frontmatter verwendet hat oder ob dies eine bekannte Einschränkung, ein Fehler oder ein Konfigurationsfehler ist.