Wie Agent Skills tatsächlich funktionieren: Das 30-50 Token Progressive Disclosure System

Perspektive

Dies ist die offizielle Anthropic-Erklärung, wie Agent Skills mechanisch funktionieren - kurz und praktisch.

Das Progressive Disclosure System. Beim Start werden nur Name und Beschreibung jedes installierten Skills in den System-Prompt geladen - etwa 30-50 Token pro Skill. Dadurch wird Claude auf Skills aufmerksam, ohne Context zu verbrauchen. Wenn ein User-Prompt zur Beschreibung eines Skills passt, lädt Claude dynamisch die vollständige skill.md. Falls dieser Skill auf andere Dateien oder Skripte verweist, werden diese progressiv bei Bedarf geladen. Ergebnis: Man kann viele Skills für komplexe Aufgaben installieren, ohne den Context aufzublähen.

Wie Skills mit anderen Claude-Features zusammenpassen:

• Claude.md = projektspezifischer Context (Tech Stack, Coding-Konventionen, Repo-Struktur). Liegt neben dem Code. “Wir nutzen Next.js und Tailwind.”
• Skills = portierbare Expertise, die über alle Projekte hinweg funktioniert. Ein Frontend-Design-Skill, der Typografie-Standards lehrt, aktiviert sich automatisch beim UI-Bau.
• MCP Server = universelles Integrations-Protokoll, das Claude mit externen Quellen verbindet (GitHub, Linear, Postgres). “MCP verbindet mit Daten. Skills lehren Claude, was damit zu tun ist.”
• Sub-Agents = spezialisierte KI-Assistenten mit festen Rollen, eigenen Context-Windows, benutzerdefinierten Prompts. Skills bieten portierbare Expertise, die jeder Agent nutzen kann.

Die Synergie: Claude.md legt Fundament → MCP Server verbinden Daten → Sub-Agents spezialisieren → Skills bringen Expertise.

Key Takeaways

• 30-50 Token pro Skill - Nur Name/Beschreibung beim Start geladen; voller Inhalt wird bei Match geladen
• Progressive Loading - skill.md wird bei Match geladen; referenzierte Dateien/Skripte werden bei Bedarf geladen
• Portierbar über Oberflächen - Funktioniert in Claude Code, API und claude.ai
• Claude.md = Projekt, Skills = Expertise - Claude.md ist repo-spezifisch; Skills sind wiederverwendbar über Projekte hinweg
• MCP = Daten, Skills = was zu tun - MCP gibt Zugriff; Skills lehren Patterns (Query-Optimierung, etc.)
• Sub-Agents können Skills teilen - Frontend-Agent und Reviewer können beide Accessibility-Skill nutzen
• Anwendungsfälle - Onboarding neuer Mitarbeiter, PR-Security-Praktiken, Datenanalyse-Methodik

Big Picture

Skills nutzen Progressive Disclosure, um Hunderte von Fähigkeiten in jeweils 30-50 Token zu packen - wobei der volle Inhalt nur bei Bedarf geladen wird. Kombiniert mit MCP für Daten und Claude.md für Projekt-Context bilden Skills die Expertise-Schicht, die aus allgemeinen Agents spezialisierte macht.