itaywol/adeptability

Was macht adeptability?

Plattformübergreifende KI-Skill-Portabilität für deine KI-Coding-Agenten

Übersicht

Adeptability ist ein CLI-Tool und Paketmanager, mit dem du KI-Agenten-Skills einmal erstellen und auf über 45 KI-Coding-Agenten verteilen kannst – darunter Claude Code, Cursor, GitHub Copilot, Codex, OpenCode und viele mehr.

Es fungiert als eine dotfiles-ähnliche Lösung für KI-Agenten-Skills: ein zentraler Ort zum Verwalten, Versionieren und Synchronisieren deiner Skills über alle deine KI-Tools hinweg.

Funktionen

• 🔄 Einmal schreiben, überall ausführen: Definiere einen Skill einmal gemäß der Adeptability-Spezifikation und veröffentliche ihn auf jedem unterstützten Agenten.
• 📦 Zentrales Skill-Repository: Verwalte alle deine Skills in einem einzigen Repository, ähnlich wie bei dotfiles.
• 🔒 Sicherheitsscanner: Prüfe Skills automatisch auf schädliche oder verdächtige Anweisungen.
• 🔍 Content-Hash-Drift-Erkennung: Erkenne Änderungen in Skill-Definitionen und halte sie über Plattformen hinweg konsistent.
• ⚡ Schnelle Synchronisierung: Synchronisiere Skills mit einem einzigen Befehl: adept sync.

Unterstützte Plattformen

Agent	Status
Claude Code	✅ Unterstützt
Cursor	✅ Unterstützt
GitHub Copilot	✅ Unterstützt
Codex CLI	✅ Unterstützt
OpenCode	✅ Unterstützt
Windsurf	✅ Unterstützt
Continue	✅ Unterstützt
… und 40+ weitere	✅ Unterstützt

Installation

Installiere Adeptability mit npm:

npm install -g adeptability

Oder mit npx:

npx adeptability

Verwendung

Einen Skill erstellen

Erstelle eine adeptability.yaml-Datei in deinem Repository:

skills:
  - id: my-awesome-skill
    version: 1.0.0
    description: Ein Skill, der automatisch Code-Dokumentation generiert
    platforms:
      - claude-code
      - cursor
      - copilot
    instructions: |
      Wenn der Benutzer nach Dokumentation fragt, generiere automatisch JSDoc/Docstring-Kommentare für die aktuelle Funktion.

Skills synchronisieren

adept sync

Dieser Befehl extrahiert deine Skill-Definitionen, führt Sicherheitsprüfungen durch und synchronisiert sie auf alle konfigurierten Plattformen.

Sicherheitsprüfung

adept scan

Scanne deine Skill-Definitionen auf potenziell schädliche Anweisungen.

Drift erkennen

adept drift

Vergleiche die aktuellen lokalen Skill-Definitionen mit dem, was auf den Fernplattformen bereitgestellt wurde, um Unterschiede zu erkennen.

Konfiguration

Erstelle eine .adeptability.json- oder adeptability.yaml-Datei in deinem Projektstammverzeichnis:

{
  "registry": "https://registry.adeptability.io",
  "platforms": ["claude-code", "cursor", "copilot"],
  "plugins": []
}

Oder als YAML:

registry: https://registry.adeptability.io
platforms:
  - claude-code
  - cursor
  - copilot
plugins: []

Skill-Spezifikation

Jeder Skill benötigt die folgenden Felder:

• id: Eindeutige Kennung des Skills
• version: Semantische Versionierung
• description: Kurze Beschreibung des Skills
• platforms: Liste der Zielplattformen
• instructions: Die Anweisungen, die der KI-Agent befolgen soll (kann Markdown enthalten)

Optional:

• tags: Metadaten-Tags
• author: Autor des Skills
• license: Lizenzinformationen

Entwicklung

Repository klonen

git clone https://github.com/itaywol/adeptability.git
cd adeptability

Abhängigkeiten installieren

npm install

Bauen

npm run build

Testen

npm test

Beiträge

Beiträge sind willkommen! Bitte lies die CONTRIBUTING.md-Richtlinien, bevor du einen Pull Request erstellst.

Lizenz

MIT