agentskills/agentskills

Was macht agentskills?

Die offene Spezifikation und das SDK für das SKILL.md-Format, das von Claude Code und anderen autonomen Agenten verwendet wird.

Übersicht

das agentskills/agentskills Repository definiert ein standardisiertes Format zur Beschreibung von Fähigkeiten (Skills) für KI-Agenten. Jeder Skill wird in einer SKILL.md-Datei definiert, die Metadaten, Anweisungen, Konfigurationen und Beispiele enthält. Dies ermöglicht Agenten, Fähigkeiten automatisch zu erkennen, zu laden und auszuführen.

Hauptmerkmale

• Offene Spezifikation: Vollständig dokumentiertes Format zur Beschreibung von Agentenfähigkeiten.
• SDK: Tools und Bibliotheken zur Validierung, Analyse und Generierung von SKILL.md-Dateien.
• Plattformunabhängig: Unterstützt Claude Code, Cursor, Codex und andere autonome Agenten.
• Interoperabilität: Fähigkeiten können zwischen verschiedenen Agenten-Ökosystemen geteilt und wiederverwendet werden.

Schnellstart

Installation

npm install agentskills

Verwendung

const { validateSkill } = require('agentskills');

const skillMD = `
---
name: Mein Skill
description: Eine Beispielbeschreibung
---

# Mein Skill

Anweisungen für den Agenten.
`;

const result = validateSkill(skillMD);
console.log(result.valid); // true oder false

SKILL.md-Struktur

Eine SKILL.md-Datei besteht aus zwei Hauptteilen:

1. YAML-Frontmatter: Enthält Metadaten wie Name, Beschreibung, Version und Abhängigkeiten.
2. Markdown-Text: Enthält Anweisungen, Konfigurationen und Beispiele für den Agenten.

Beispiel-Frontmatter

---
name: Code-Review-Skill
description: Ein Skill zur automatischen Code-Überprüfung
version: 1.0.0
author: maxmustermann
tags:
  - code-review
  - linting
dependencies:
  - eslint
---

SDK-Referenz

Das SDK bietet folgende Funktionen:

• validateSkill(markdown): Validiert eine SKILL.md-Datei gegen die Spezifikation.
• parseSkill(markdown): Parst eine SKILL.md-Datei in ein strukturiertes Objekt.
• generateSkill(metadata, instructions): Generiert eine SKILL.md-Datei aus Metadaten und Anweisungen.

Beispiele

Weitere Beispiele findest du im Ordner examples/ dieses Repositories.

Mitwirken

Beiträge sind willkommen! Bitte lies die CONTRIBUTING.md für Details.

Lizenz

Dieses Projekt ist unter der MIT-Lizenz lizenziert. Siehe LICENSE für Details.