goromal/agent-skills

Verwendung beim Bearbeiten, Erstellen oder Löschen eines Agent-Skills. Gemeinsame Skills stammen aus dem agent-skills-Repository; nachgelagerte lokale Skills verbleiben in ihrem eigenen Repository.

Was ist agent-skills?

Dieses Skill ist für Entwickler und Administratoren gedacht, die mit dem `agent-skills`-Repository und seinen abhängigen Projekten arbeiten. Es beschreibt den vollständigen Lebenszyklus von Agent-Skills: wo sie installiert werden, wie gemeinsame Skills im zentralen Repository editiert und erstellt werden und wie nachgelagerte lokale Skills in ihren eigenen Repositories verwaltet werden. Der Skill erklärt die Struktur des Nix-Katalogs `catalog.nix`, der definiert, welche Skills für Claude, Codex und andere Frameworks verfügbar sind, und wie Overlays in nachgelagerten Projekten zusätzliche lokale Skill-Pfade hinzufügen können. Er behandelt auch die Arbeit mit Feature-Branches, das Testen von Anixpkgs-Integrationen, das Sperren von Flake-Inputs und das Löschen oder Ersetzen gemeinsamer Skills, inklusive der Verwendung von `excludedSkills` für maschinenspezifische Überschreibungen. Die Anleitung ist besonders nützlich für Teams, die eine geteilte Skill-Bibliothek pflegen und gleichzeitig lokale Anpassungen in einzelnen Projekten erlauben möchten.

Funktioniert mit✓Claude Code✓Codex CLI~Cursor

npx skills add https://github.com/goromal/agent-skills/tree/HEAD/skills/editing-skills

Dokumentation

Wo installierte Skills herkommen

Agent-Skills werden von home-manager unter ~/.claude/skills/, ~/.agents/skills/ und ~/.codex/skills/ installiert. Diese verwalteten Pfade verweisen auf das Quell-Skill-Verzeichnis. Bearbeite das besitzende Repository, nicht einen installierten Link.

Gemeinsame Skill-Quellen und Ressourcen befinden sich im Verzeichnis agent-skills/skills/<name>/ des Workspace. Der Nix-Katalog unter agent-skills/catalog.nix wählt gemeinsame Skills für die Verbraucher aus. Nachgelagerte Overlays können über ihre eigene Konfiguration machines.claude.skills und machines.codex.skills lokale Skill-Pfade hinzufügen; diese Dateien sollten im nachgelagerten Repository bleiben.

Bearbeiten eines gemeinsamen Skills

Bearbeite das Verzeichnis im Workspace-Checkout des agent-skills-Repositorys.
Wenn die Änderung auch einen Verbraucher aktualisiert, verwende in beiden Repositorys denselben Feature-Branch. Füge agent-skills mit addsrc agent-skills [email protected]:goromal/agent-skills.git zum Workspace hinzu, falls es nicht vorhanden ist.
Teste eine Anixpkgs-Integration bei Bedarf mit einem temporären lokalen Flake-Input. Stelle vor dem Pushen die Remote-Feature-Branch-URL wieder her und sperre sie mit nix flake update agent-skills.
Erstelle den PR im agent-skills-Repository und verlinke ihn aus dem Verbraucher-PR. Führe zuerst den Skill-Quell-PR zusammen, dann verpinne die Verbraucher auf die gemergte main-Revision.

Erstellen eines gemeinsamen Skills

Füge skills/<skill-name>/SKILL.md im agent-skills-Repository hinzu; halte Referenzen, Beispiele, Skripte und Assets daneben.
Füge { name = "<skill-name>"; file = ./skills/<skill-name>/SKILL.md; } zu catalog.nix hinzu. Einträge gelten standardmäßig für Claude und Codex; setze frameworks bei Bedarf.
Verlinke unterstützende Ressourcen relativ zum Skill-Ordner und aktualisiere die Locks der nachgelagerten Projekte.

Bearbeiten eines nachgelagerten lokalen Skills

Ändere ihn in dem Repository, das das Overlay oder Modul besitzt, das den Skill-Pfad beisteuert. Halte das Verzeichnis in sich geschlossen, einschließlich der Referenzen. Seine Konfiguration kann einen { name, file }-Eintrag zur Skills-Option des Frameworks hinzufügen.

Löschen oder Ersetzen eines gemeinsamen Skills

Entferne seinen Eintrag aus catalog.nix und lösche seinen Quellordner, dann aktualisiere die Locks der nachgelagerten Projekte. Um einen gemeinsamen Skill auf einer Maschine zu ersetzen, liste seinen Namen in machines.agents.excludedSkills auf und füge den lokalen Skill-Pfad mit diesem Namen im nachgelagerten Modul hinzu.