ucsahinn/ai-skill-create

Was macht ai-skill-create?

AI Skill Create: Toolkit zum Erstellen, Validieren, Testen und Verpacken von wiederverwendbaren KI-Agenten-Fähigkeiten und Codex-Fähigkeiten.

Überblick

Diese Fähigkeit bietet eine Reihe von Werkzeugen, um:

• Neue KI-Agenten-Fähigkeiten zu erstellen
• Die Struktur und Metadaten einer Fähigkeit zu validieren
• Fähigkeiten in verschiedenen Umgebungen zu testen (z.B. Claude Code, Cursor, Codex)
• Fähigkeiten für die Verteilung zu verpacken

Voraussetzungen

• Python 3.10 oder höher
• git (für Versionskontrolle)
• Optional: node und npm (für Codex-spezifische Pakete)

Installation

pip install ai-skill-create

Verwendung

Neue Fähigkeit erstellen

ai-skill-create new --name "meine-faehigkeit" --description "Beschreibung meiner Fähigkeit"

Dies erstellt ein neues Verzeichnis mit der Standardstruktur einer Fähigkeit:

meine-faehigkeit/
├── SKILL.md
├── skills/
│   └── main.py
├── tests/
│   └── test_main.py
└── config.json

Fähigkeit validieren

ai-skill-create validate --path ./meine-faehigkeit

Der Validierungsprozess überprüft:

• Vorhandensein und korrekte Struktur von SKILL.md
• Gültigkeit der Metadaten (Name, Beschreibung, Version, Autor, etc.)
• Referenzierte Dateien und Abhängigkeiten
• Syntax der enthaltenen Code-Dateien (Python, JavaScript, etc.)

Fähigkeit testen

ai-skill-create test --path ./meine-faehigkeit

Führt alle Tests im tests/-Verzeichnis aus und meldet die Ergebnisse.

Fähigkeit verpacken

ai-skill-create package --path ./meine-faehigkeit --output ./pakete

Erstellt ein komprimiertes Archiv (.aipkg) im angegebenen Ausgabeverzeichnis.

Unterstützte Plattformen

Plattform	Status
Claude Code	✅ Vollständig unterstützt
Cursor	✅ Vollständig unterstützt
Codex	✅ Vollständig unterstützt
Andere KI-Agenten	✅ Grundlegende Unterstützung

Dateistruktur einer Fähigkeit

Jede gültige Fähigkeit muss folgende Struktur aufweisen:

./
├── SKILL.md          # Hauptmanifest mit Metadaten und Anweisungen
├── skills/           # Verzeichnis für den Quellcode der Fähigkeit
│   └── *.py, *.js, etc.
├── tests/            # Testdateien
│   └── test_*.py, *.test.js, etc.
└── config.json       # Optionale Konfigurationsdatei

Konfigurationsoptionen

Die config.json-Datei kann folgende Felder enthalten:

• name: Eindeutiger Name der Fähigkeit
• version: Semantische Version (z.B. 1.0.0)
• description: Kurzbeschreibung
• author: Autor oder Organisation
• license: Lizenztyp
• dependencies: Liste der Abhängigkeiten
• platforms: Liste der unterstützten Plattformen

Beispiele

Einfache Fähigkeit erstellen

ai-skill-create new --name "hello-world" --description "Eine einfache Hallo-Welt-Fähigkeit"
cd hello-world
# Bearbeiten Sie SKILL.md und fügen Sie Code in skills/ hinzu
ai-skill-create validate
ai-skill-create test
ai-skill-create package --output ./build

Häufige Fehler und Lösungen

1. Fehler: SKILL.md nicht gefunden

   • Stellen Sie sicher, dass die Datei im Stammverzeichnis der Fähigkeit existiert.

2. Fehler: Ungültige Metadaten

   • Überprüfen Sie, ob name, version und description in SKILL.md vorhanden und korrekt formatiert sind.

3. Fehler: Tests fehlgeschlagen

   • Überprüfen Sie die Testausgabe auf spezifische Fehlerdetails.

Mitwirken

Beiträge sind willkommen! Bitte lesen Sie CONTRIBUTING.md für Details.

Lizenz

Dieses Projekt ist unter der MIT-Lizenz lizenziert – siehe die Datei LICENSE für Details.

Support

Bei Fragen oder Problemen öffnen Sie bitte ein Issue im GitHub-Repository.