Kontext: intern/capabilities/skills/
Zweck
Pro Skill ein Ordner. SKILL.md ist die Skill-Definition (analog zu _context.md fuer den Skill-Ordner — Anthropic-Standard). Optional scripts/ (ausfuehrbarer Code), references/ (on-demand-Docs), assets/ (Templates, Logos).
Wichtig — Verhaeltnis zum Plugin-System: Die Skills laufen aktuell aus dem Plugin agentic-ventures (Claude-Code-Marketplace, eigenes Git-Repo marvinkuehlmann/agentic-ventures-plugin). Die SKILL.md-Files hier sind archived/reference-Kopien — Source of Truth liegt im Plugin-Repo. Synchronisations-Pflege erfolgt manuell, Plugin gewinnt bei Konflikt.
Inventarliste der aktiven Skills: _index.
Was gehoert hier rein / NICHT rein
Hier rein:
<skill-slug>/SKILL.mdmit Frontmatter Schema 5.17 (siehe 517-skill-skillmd-siehe-9)- Pro Skill: optional
scripts/,references/,assets/ _index.mdals Dashboard
NICHT hier rein:
- Run-Logs (was der Skill tatsaechlich tat) →
intern/runs/<datum>-<skill>/ - Plugin-Source-Code → eigenes Repo
marvinkuehlmann/agentic-ventures-plugin
Fuer Agents
- SKILL.md ist eine erweiterte _context.md des Skill-Ordners — sagt was der Skill tut, welche Inputs, welche MCPs/Tools, welche Outputs
- Description-Feld im Frontmatter ist Trigger-Mechanismus — leicht pushy formulieren, Anthropic „undertriggert” eher
- Bei aktiver Plugin-Quelle: vor SKILL.md-Aenderung im Plugin-Repo aendern, hier nur synchronisieren
Lokale Konventionen
- Body unter 500 Zeilen. Wenn laenger: in
references/auslagern und von SKILL.md aus verweisen - Imperativ schreiben („Lies die Datei X”, nicht „Der Skill liest die Datei X”)
- Warum erklaeren. LLMs haben Theory of Mind — wenn der Grund klar ist, haelt sich der Agent auch in Edge-Cases dran
- Progressive Disclosure. Drei Ladestufen: Metadata (immer) → Body (bei Trigger) → Referenz-Files (on demand)