manuelmauro/arkouda

Verwenden Sie Skilo

Skilo ist ein CLI-Tool zur Entwicklung von Agent Skills.

Installation

curl -sSfL https://raw.githubusercontent.com/manuelmauro/skilo/main/install.sh | sh

Kurzanleitung

skilo new my-skill        # Aus Vorlage erstellen
skilo add owner/repo      # Aus Git installieren
skilo lint .              # Gegen Spezifikation validieren
skilo fmt .               # SKILL.md-Dateien formatieren

Führen Sie skilo -h für alle Befehle und Optionen aus.

Skills IMMER validieren

Führen Sie vor dem Committen von Skill-Änderungen skilo lint und skilo fmt aus. Diese Befehle setzen die Agent Skills Spezifikation durch und erkennen häufige Probleme.

# Validieren und formatieren in einem Befehl
skilo check .

# Strenger Modus für CI (Warnungen werden zu Fehlern)
skilo check --strict .

Skill-Struktur

my-skill/
├── SKILL.md        # Erforderlich: Manifest mit YAML-Frontmatter
├── scripts/        # Optional: Ausführbarer Code
├── references/     # Optional: Zusätzliche Dokumente (bei Bedarf geladen)
└── assets/         # Optional: Statische Ressourcen

Frontmatter-Anforderungen

Erforderliche Felder

name (1-64 Zeichen)

• Nur Kleinbuchstaben, alphanumerische Zeichen und Bindestriche (a-z, 0-9, -)
• Darf NICHT mit - beginnen/enden oder -- enthalten
• Muss mit dem Namen des übergeordneten Verzeichnisses übereinstimmen

description (1-1024 Zeichen)

• Beschreibt, WAS der Skill tut UND wann er verwendet werden soll
• Enthält Schlüsselwörter, die Agenten helfen, Benutzeranfragen zuzuordnen

Optionale Felder

• license – Kurz halten; für Details auf die LICENCE-Datei verweisen
• compatibility (max. 500 Zeichen) – Umgebungsanforderungen (z.B. Erfordert git, docker)
• metadata – Schlüssel-Wert-Paare für benutzerdefinierte Eigenschaften
• allowed-tools – Durch Leerzeichen getrennte Liste vorab genehmigter Tools (experimentell)

Best Practices

Effektive Beschreibungen schreiben

Die Beschreibung entscheidet, wann Agenten Ihren Skill aktivieren. Seien Sie spezifisch.

# Gut – spezifisch, schlüsselwortreich
beschreibung: Extrahiert Text und Tabellen aus PDF-Dateien, füllt PDF-Formulare aus und führt mehrere PDFs zusammen. Verwenden Sie dies, wenn Sie mit PDF-Dokumenten arbeiten oder der Benutzer PDFs, Formulare oder Dokumentenextraktion erwähnt.

# Schlecht – vage, keine Aktivierungshinweise
beschreibung: Hilft bei PDFs.

Body-Inhalt präzise halten

Der gesamte SKILL.md-Body wird geladen, wenn der Skill aktiviert wird. Halten Sie ihn unter 500 Zeilen.

• Schritt-für-Schritt-Anleitungen einfügen
• Beispiele für Eingaben und Ausgaben hinzufügen
• Häufige Randfälle abdecken
• Detailreiches Material in references/ verschieben

Progressive Offenlegung verwenden

Strukturieren Sie Skills, um die Kontextnutzung zu minimieren:

1. Metadaten (~100 Tokens) – name + description werden beim Start für alle Skills geladen
2. Anweisungen (<5000 Tokens) – Vollständiger Body wird beim Aktivieren des Skills geladen
3. Ressourcen (bei Bedarf) – scripts/, references/, assets/ werden nur bei Bedarf geladen

Eigenständige Skripte schreiben

Skripte in scripts/ sollten:

• Eigenständig sein oder Abhängigkeiten klar dokumentieren
• Hilfreiche Fehlermeldungen enthalten
• Randfälle elegant behandeln

Referenzen effektiv organisieren

Dateien in references/ werden bei Bedarf geladen:

• Dateien fokussiert halten (eine Datei = ein Konzept)
• Relative Pfade vom Skill-Stammverzeichnis verwenden
• Tief verschachtelte Referenzketten vermeiden

Lint-Regeln

Skilo erzwingt diese Regeln (konfigurierbar in .skilorc.toml):

Code	Regel	Standard
E001	name_format	aktiviert
E002	name_length	64 Zeichen
E003	name_directory	aktiviert
E004	description_required	aktiviert
E005	description_length	1024 Zeichen
E006	compatibility_length	500 Zeichen
E009	references_exist	aktiviert
W001	body_length	500 Zeilen
W002	script_executable	aktiviert
W003	script_shebang	aktiviert

CI-Integration

- name: Skills validieren
  ausführen: |
    curl -sSfL https://raw.githubusercontent.com/manuelmauro/skilo/main/install.sh | sh
    skilo check --strict skills/