Skill Explorer

Skill-Explorer — Skill-Landschaft verwalten (Audit · Explore · Installer)

Zweck

Mit wachsendem Skill-Bestand entstehen Duplikate, ungenutzte Ressourcen und unklare „welcher Skill statt welchem"-Situationen — und es gibt draußen ständig neue Skills/Plugins. skill-explorer bündelt drei Rollen in einem Werkzeug:

Aufruf: /skill-explorer (Audit als Default) bzw. „… für Thema X finden" (Explore). Beide Modi teilen Taxonomie (references/clustering.md), Berichtsformat (references/report-format.md) und das Nummerierungsschema, damit der User mit einer einzigen Zahlenliste antworten kann.

Installer-Prinzip & Persistenz

Statt selbst monolithisch zu wachsen, generiert skill-explorer bei Bedarf schlanke, einzeln ladbare Subskills — so muss nie ein überlanger Einzel-Skill geladen werden:

• Skill-Finder ([F]) — aktiver Finder/Router analog einem „using-superpowers"-Türsteher, der vor jeder Aufgabe das Register liest und zur passenden Familie routet (references/skill-finder.md, Vorlage assets/skill-finder-template.md).
• Familien-Umbrella (c1) — Meta-Skill, der eine ganze Familie kennt (assets/family-umbrella-template.md).
• Pflege-Skills ([P1] Familien, [P2] Register) — halten Familien/Register aktuell (references/family-care.md).

Entscheidungen werden in ~/.claude/skills/skill-explorer/config.json persistiert (references/config.md, Vorlage assets/config.example.json): beim Start lesen (bekannte Familien/Router/erzeugte Subskills), nach Ausführung aktualisieren — so legt ein Re-Run nichts doppelt an.

Branch-Mechanismus (Drittanbieter anpassen)

Ein read-only-Skill (Plugin, importierter Drittanbieter) kann angepasst werden, ohne das Original zu verändern: Das Original-Verzeichnis wird vollständig kopiert (Branch); anschließend wird nur die Kopie bearbeitet. Der Branch trägt vier Pflichtangaben: Verweis aufs Original, Branch-Datum, Bearbeiter und Grund. Sobald der Branch das Original ablöst, wird das Original für die Runtime deregistriert (SKILL.md → CONTENT.md) oder der Familien-Router auf den Branch gezeigt, damit zwei nahezu identische Skills nicht kollidieren. Drittanbieter-Branches bleiben privat — sie gehen nicht in die öffentliche .AI/.SKILLS-Library. Detail: references/skill-branching.md.

Ablauf

1. Modus wählen: Bestand sichten/aufräumen → Audit-Modus. Von außen suchen/installieren → Explore-Modus. (Explore kann auf einen vorherigen Audit/config.json aufsetzen.)
2. Audit-Modus (references/audit-mode.md): Inventar (Skript) → Familien-Cluster → Teilberichte → eine global durchnummerierte Entscheidungsliste (a/b/c1/c2/c3, plus R/F/P1/P2).
3. Explore-Modus (references/explore-mode.md): zweisprachige Mehrquellen-Recherche → 3 Kategorien je Kandidat → Wirkungs-Simulation → nummerierte Install/Remove-Empfehlungen.
4. Ausführen nur nach Zahlen-Bestätigung des Users; Skill-Erzeugung/-Änderung registrieren und config.json aktualisieren.

Eiserne Regeln

• Survey ≠ Mutation: alles clustern, aber nur user-eigene Skills editieren; Plugin-/Drittanbieter- Skills sind read-only (nie Header/Löschung). Wer ein Drittanbieter-Skill anpassen will, erzeugt stattdessen einen Branch (Fork-Kopie) — das Original bleibt unangetastet, die Anpassung erfolgt ausschließlich an der Kopie (→ references/skill-branching.md).
• Register erweitern, nicht duplizieren: existiert ein Skill-Register (Index + Familien-Map + Index-Skill), dieses erweitern statt ein viertes anzulegen.
• Sicherheit primär manuell: vor jeder Installation liest das Modell den Skill selbst und urteilt; scripts/scan_skill_security.py ist nur unterstützende Triage mit bekannten Grenzen. Nie auto-install.
• Registrierung nach Herkunft: user-authored → Library; Drittanbieter → externer Pfad, nicht Library.

Orchestrierung (modell-neutral)

Familien-Teilberichte bzw. Quellen/Sprachen sind unabhängige Arbeitspfade. Wenn die Plattform günstigere Subagenten bietet als der Orchestrator selbst, je Familie/Quelle einen Subagenten beauftragen und als Orchestrator nur konsolidieren/prüfen (Spezialist-Schwarm). Sonst sequenziell selbst.

Ressourcen

• Modi: references/audit-mode.md, references/explore-mode.md
• Geteilt: references/clustering.md, references/report-format.md, references/config.md
• Audit: references/family-care.md, references/skill-finder.md
• Explore: references/research-method.md, references/integration-sim.md, references/install-uninstall.md
• Branch: references/skill-branching.md
• Skripte: scripts/inventory_skills.py (Inventar), scripts/inject_family_header.py (Header-Router), scripts/scan_skill_security.py (Security-Triage)
• Vorlagen: assets/family-umbrella-template.md, assets/skill-finder-template.md, assets/skill-register-template.md, assets/config.example.json, assets/branch-header.example.md

Changelog

1.1.1 (2026-08-24)

• Der Inventarhelfer akzeptiert nun auch ältere, einzeilig serialisierte dependencies-Mappings und behandelt beschädigte Werte fehlertolerant, statt den gesamten Audit abzubrechen. Seine Abschlussmeldung ist außerdem mit Windows-Konsolen kompatibel.

1.1.0 (2026-06-17)

• Branch-Mechanismus ergänzt: Drittanbieter-/read-only-Skills können per Fork-Kopie (Branch) angepasst werden — mit Verweis aufs Original, Datum, Bearbeiter und Grund; Original bleibt unangetastet. Eiserne Regel „Survey ≠ Mutation" um Branch-Ausweg erweitert. Neuer Abschnitt ## Branch-Mechanismus. Neu: references/skill-branching.md, assets/branch-header.example.md.

1.0.0 (2026-06-17)

• Initiale Version. Vereint Bestands-Audit (Familien-Clustering, nummerierte Entscheidungen) und Web-Recherche (gated Install mit Security-Triage) in einem Installer, der schlanke Subskills erzeugt.