Zweck
Hält das Register drift-frei. Das Register besteht aus drei verzahnten Artefakten — niemals ein viertes anlegen, immer diese drei erweitern:
~/.claude/skills/code-skill-index/references/catalog-*.md(Kategorie-Kataloge)- der Skill-Index (Master-Liste)
<USER_HOME>\OneDrive\.USR\SKILL-MAP.md(Family-/Routing-Map)
Drift-Check-Prozedur
- Ist-Stand erheben:
NurPYTHONIOENCODING=utf-8 python ~/.claude/skills/skill-explorer/scripts/inventory_skills.py \ --out ~/.skill-inventory.json --prettysource=user-Skills sind register-relevant (Plugin/extern bleiben außen vor). - Soll-Stand lesen: die drei Register-Artefakte.
- Differenz bilden:
- Fehlend (im Inventar, nicht im Register) → nachtragen.
- Verwaist (im Register, nicht mehr im Inventar) → markieren/entfernen.
- Count-Abweichung (z. B. „18 Skills" stimmt nicht mehr) → Zahl korrigieren.
- Nachtragen: je neuer Skill eine Zeile im passenden
catalog-<kategorie>.md, eine Zeile im Skill-Index (+ Kopf-Datum) und — falls neue/geänderte Familie — ein Abschnitt inSKILL-MAP.md. - Stand-Datum in allen berührten Dateien auf das aktuelle Datum setzen.
Hilfs-Snippet (fehlende user-Skills auflisten)
PYTHONIOENCODING=utf-8 python -c "
import json
inv=json.load(open('<USER_HOME>/.skill-inventory.json',encoding='utf-8'))
print('\n'.join(s['dir'] for s in inv['skills'] if s['source']=='user'))
"
Die Ausgabe gegen die Register-Artefakte abgleichen (manuell oder per grep).
Eiserne Regeln
- Kein viertes Register — nur die drei erweitern.
- Nur user-authored Skills gehören ins Register; Drittanbieter folgen dem externen Pfad.
- Datum nicht raten — aktuelles Datum setzen.
Changelog
0.1.0 (2026-06-17)
- Initiale Version. Erzeugt vom Audit-Modus (P2). Anlass: beim Audit 2026-06-17 fehlten ~10 user-Skills in der SKILL-MAP (swarm-operations, model-strategy, agents-bridge, mcp-config-sync, system-onboarding, update-cli-docs, migrate-rename, plugin-system + Therapie- und Game-Dev-Familie).