serge-the-hedge/agent-skills

Was macht agent-skills?

~/Dev/agent-skills enthält jeden Skill, den ich projektübergreifend verwende: meine eigenen und die von Drittanbietern, auf denen ich aufbaue. agent-skills link füllt ~/.claude/skills (Claude Code) und ~/.agents/skills (Codex) mit Symlinks darauf, sodass ein Skill, der in einem dieser Ordner bearbeitet wird, im Repo bearbeitet wird.

Wo ein Skill hingehört

• Projekt-Skill (das eigene .agents/skills/ eines Repos, z. B. verify-*): bleibt in diesem Projekt. Der Rest dieser Datei bezieht sich auf die Skills in diesem Repo.
• Meine: skills/<name>/.
• Von Drittanbietern (Upstream): vendor/<upstream>/, bezogen von pstack, Matt Pocock's Skills und good-css durch agent-skills update. upstreams.ts legt fest, welche ihrer Skills verlinkt werden.
• Alles in den Agenten-Ordnern, das kein Symlink in das Repo ist (blabla-*, Claudes synced/, Codex' .system/), gehört zu dem Tool, das es installiert hat und das es auch aktualisiert.

realpath ~/.agents/skills/<name> zeigt dir, um welchen Skill es sich handelt.

Erstellen

Erstelle den Skill unter ~/Dev/agent-skills/skills/<name>/SKILL.md; dieser Pfad hat Vorrang vor den Standardeinstellungen in skill-creator und /automate-me. Führe dann agent-skills link aus. Wenn ein Konflikt gemeldet wird, wähle einen anderen Namen.

Bearbeiten

Richte dich nach der Art der Änderung:

• Eine Präferenz von mir (Stil, Standardeinstellungen, meine Arbeitsweise) gehört in meine eigenen Skills: Erweitere einen in skills/ oder erstelle einen neuen. Meine Dateien geraten nie in Konflikt mit Upstream-Updates.
• Eine Korrektur für etwas, das ein Upstream-Skill bei mir falsch macht, geht direkt in vendor/. Festgeschriebene Upstream-Bearbeitungen überleben agent-skills update, können aber bei jeder Änderung derselben Zeilen durch den Upstream in Konflikt geraten. Halte sie daher klein. Führe nach der Bearbeitung von pstack node ~/Dev/agent-skills/vendor/pstack/scripts/check-t3-native.mjs <name> aus, bis es mit 0 beendet wird.

Entfernen

Lösche skills/<name>/ für einen meiner Skills. Bei einem Upstream-Skill frage mich zuerst: Es bedeutet, upstreams.ts zu ändern.

Abschluss

Abgeschlossen, wenn agent-skills link erfolgreich ist und jede Änderung ein eigener Commit in ~/Dev/agent-skills ist, der gepusht wurde:

• Stage nur die von dir geänderten Dateien (git add <pfade>); andere Agenten könnten dort laufende Arbeiten haben.
• Schreibe die Nachricht, die erklärt, warum der Skill geändert wurde.
• Push direkt nach dem Commit.

Schreiben

• Das Repo ist öffentlich, daher schreibe jeden Skill als öffentlichen Text: generische Beispiele, frei von Namen, Pfaden und Geheimnissen meiner Projekte.
• Verweise auf einen anderen Skill mit seinem vollständigen Pfad, ~/.agents/skills/<name>/SKILL.md. Ein relativer ../<name> funktioniert hier nicht, weil meine Skills und jeder Upstream in unterschiedlichen Ordnern liegen.
• Für das Schreiben selbst folge ~/.agents/skills/writing-for-agents/SKILL.md.

Führe agent-skills ohne Argumente aus, um seine Befehle zu sehen.