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.md mit Frontmatter Schema 5.17 (siehe 517-skill-skillmd-siehe-9)
  • Pro Skill: optional scripts/, references/, assets/
  • _index.md als 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)