Communitygithub.com

xFurti/skillctl

Universeller Paketmanager-CLI für Agent Skills – Manifest, Lockfile, Multi-Agent-Synchronisation (Cursor, Claude, Codex, Gemini). Node ≥22.13.

Was ist skillctl?

skillctl ist ein universeller Paketmanager für KI-Agenten-Skills (z. B. für Cursor, Claude, Codex und Gemini). Es ermöglicht Entwicklern, Skills zentral in `~/.skillctl/skills/` zu verwalten, sie über ein Manifest (`agent-skills.json`) und eine Lockdatei (`agent-skills.lock`) zu versionieren und per `sync`-Befehl in die Verzeichnisse verschiedener Agenten zu verknüpfen. Das Tool unterstützt portable Spezifikationen wie `file:`, `local:`, `github:`, `npm:` und `skills.sh/` und bietet Import-Workflows für bestehende Projekte oder von `npx skills`. Mit `doctor` und `audit` lassen sich die Integrität und Portabilität der Installation prüfen. skillctl ist auf reproduzierbare Team-Workflows ausgelegt – etwa durch `install --frozen` in CI – und vermeidet manuelle Kopien oder absolute Pfade.

Funktioniert mit✓Claude Code✓Codex CLI✓Cursor✓Gemini CLI✓OpenCode
npx skills add xFurti/skillctl

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

Was macht skillctl?

Operatives Playbook zur Verwaltung von Agent Skills mit der skillctl CLI. Führe echte Befehle aus; simuliere keine Ausgaben und kopiere SKILL.md-Dateien nicht manuell zwischen Agentenverzeichnissen.

Goldene Regeln

  1. Ein kanonischer Speicher — Skills befinden sich in ~/.skillctl/skills/<name>/; Agenten erhalten Symlinks via sync.
  2. Manifest + Lock committen — agent-skills.json und agent-skills.lock für Team-Reproduzierbarkeit in Git verfolgen.
  3. Nur portable Spezifikationen verwenden — file:./<pfad>, local:imported/<name>, github:, npm: oder skills.sh/; niemals absolute Home-Verzeichnis-Pfade committen.
  4. Installieren vor Synchronisieren — install materialisiert den Speicher; sync verlinkt nur die Agenten neu.
  5. Nach Änderungen überprüfen — skillctl doctor (und skillctl audit in CI) ausführen.
  6. Import vor manuellem Kopieren bevorzugen — import from-project oder import from-npx statt Skill-Ordner zu duplizieren.

Entscheidungsbaum

SituationBefehl
Neues Projekt, kein Manifestskillctl init oder skillctl init --with-skill
Remote- oder lokalen Skill hinzufügenskillctl add <spezifikator> dann skillctl install
Skills bereits in .claude/skills, .codex/skills, etc.skillctl import from-project
Migration von npx skillsskillctl import from-npx
Nur neu verlinken (Lock unverändert)skillctl sync
Vom entfernten Quellort neu holenskillctl update oder skillctl update <name>
CI-reproduzierbare Installationskillctl install --frozen dann skillctl audit --strict
Nicht-portable Pfade im Lockskillctl install zum Umschreiben; skillctl doctor-Warnungen prüfen

Schnellrezepte

# Bootstrap
skillctl init --with-skill
skillctl add github:vercel-labs/agent-skills#web-design-guidelines
skillctl install

# Projektlokaler Skill
skillctl add file:./my-skill
skillctl install
skillctl sync

# Vorhandene Agentenverzeichnisse importieren
skillctl import from-project --dry-run
skillctl import from-project

# Prüfen
skillctl list
skillctl doctor
skillctl audit --json

Erwartet nach add file:./my-skill + install: Manifest-Spezifikator file:./my-skill, Lock-canonicalPath wie ~/.skillctl/skills/my-skill.

Portabilität (0.3.1+)

  • Portabel: file:./rel, local:imported/<name>, entfernte Spezifikatoren, canonicalPath: ~/.skillctl/skills/<name>.
  • Nicht portabel: absolutes file:/Users/..., local:/abs/pfad, absolutes canonicalPath von einem anderen Rechner.
  • Wenn doctor vor nicht-portablen Pfaden warnt, skillctl install ausführen, um das Lock aus dem Manifest neu zu schreiben.

Fehlermodi

SymptomAktion
canonical path missingskillctl install
Integritätskonfliktskillctl update <name> oder skillctl install
Symlink schlägt fehl (Windows)doctor-Notiz; Konfiguration defaultMode: copy
Keine Agenten verlinktskillctl sync; Agenten in ~/.skillctl/config.json aktivieren
Frozen install failedSpeicher nicht synchron; install ohne --frozen ausführen

Referenzen

Verwandte Skills