Zum Inhalt springen

Skills, Tools & Quellen

Der Skills-Tab zeigt, was der Agent in diesem Projekt zu tun weiß: die Skills unter .agent/skills/ und die Tools unter .agent/tools/ — dieselben Dateien, die der Agent liest, für dich gerendert.

.agent/skills/ ist die Quelle; agent-spezifische Ordner sind Symlinks dorthin:

.claude/skills → ../.agent/skills

Einen Skill unter .agent/skills/ anlegen oder ändern — und jeder Agent sieht ihn sofort. Die Regel gilt für dich wie für den Agenten: Dort editieren, nie im Dot-Ordner.

Skills und Tools können aus einer Speccify-Quelle kommen — einem Skills-Repo, eingebunden unter Sources im Skills-Tab. Das Importieren eines Skills aus einer Quelle führt den Expand-Schritt aus: normale Skills landen in .agent/skills/, Tool-Verträge in .agent/tools/, und .agent/speccify/expansions.yaml hält fest, woher jeder kam, in welcher Version, und ob die Implementierung jedes Tools auf dieser Plattform verified ist.

Zwei Regeln halten die Buchhaltung gesund:

  • Editiere Skills und Tools, nicht expansions.yaml — den Nachweis pflegt Speccify; Hand-Edits würden ihn lügen lassen.
  • Tools sind absichtlich vorab genehmigt. Für Claude Code erlaubt .claude/settings.json das Ausführen von allem unter .agent/tools/ — Implementierungen sind vertragsgeprüft, also kann der Agent sie ohne Permission-Prompt aufrufen.

Nutzt der Agent einen expandierten Skill während er ein Ticket bearbeitet, loggt er eine agent_run-Zeile in die Ticket-History mit Skill- und Tool-Namen — der Inspektor ist die Spur dessen, was benutzt wurde; eine separate Log-Datei gibt es nicht.