Docsbook
Übersicht

docs-skills: modulare Fähigkeiten für KI-Agenten in der Dokumentation

Im Jahr 2026 lesen KI-Agenten Dokumentation nicht einfach nur – sie führen Aktionen damit aus. Sie veröffentlichen eine Dokumentationsseite, beheben fehlerhafte Links, erstellen llms.txt, schreiben fehlende Seiten und prüfen die Barrierefreiheit. Woher sie wissen, wie diese Aktionen auszuführen sind, liegt an „Skills“ – gebündelten, auffindbaren und deklarativen Fähigkeitsbeschreibungen.

Dieser Beitrag erklärt, was Skills sind, was der Open-Source-Katalog von Docsbook heute enthält und wie diese Ebene zwischen MCP und Ihren Inhalten passt.

Kurz gesagt#

  • Ein „Skill“ ist eine SKILL.md-Datei mit Frontmatter, die eine Fähigkeit beschreibt — was sie tut, wann sie ausgelöst wird und welche Tools sie benötigt
  • KI-Agenten (Claude Code, Cursor) lesen Skills und führen sie autonom aus
  • docs-skills ist ein Open-Source-Katalog mit vier Dokumentations-Skills
  • Docsbook MCP stellt find_skill bereit, damit Agenten Skills zur Laufzeit per Abfrage entdecken
  • Sie können Skills lokal installieren (npx docs-skills install) oder sie über MCP verwenden

Wie ein Skill aussieht#

Ein minimales SKILL.md:

---
name: docs-pr-check
description: Validate documentation changes in a pull request — check for broken links, missing frontmatter, accessibility issues, and SEO regressions. Use when reviewing docs PRs.
category: automation
mode: agent
keywords: [pull request, broken links, frontmatter, review]
requires_docsbook_mcp: true
version: 1
---
 
# docs-pr-check
 
When the user opens a docs PR, run this skill to validate the change.
 
Steps:
 
1. Run `doc_search_unresolved` to find broken links in changed files
2. Verify YAML frontmatter on every new or modified `.md` file
3. Check that internal links resolve
4. Suggest improvements
 
Tools used: `doc_search_unresolved`, `doc_outline`, `doc_resolve_link` (Docsbook MCP)

Der obige Skill veranschaulicht das Format und ist kein Eintrag im Katalog – die vier tatsächlichen Skills sind weiter unten aufgeführt. Die Frontmatter-Felder sind diejenigen, die das Schema tatsächlich definiert: name, description, category, mode, keywords, requires_docsbook_mcp und version.

Die Frontmatter ist der Vertrag. Der Body ist der Prompt.

Warum dies für die Dokumentation wichtig ist#

Drei Probleme, die Skills lösen:

1. Auffindbarkeit von Fähigkeiten#

Ohne Skills muss ein KI-Agent beim Lesen Ihrer Dokumentation-MCP erraten, was zu tun ist. Mit Skills ruft der Agent find_skill("audit my docs") auf und erhält eine SKILL.md mit präzisen Anweisungen.

2. Modulare Wiederverwendung#

Ein für ein Projekt verfasster Skill funktioniert in jedem Projekt. docs-manage ist das Regelwerk zum Schreiben einer Seite und zum Ausführen der Website, auf der sie sich befindet, und gilt für jedes Dokumentations-Repository, unabhängig davon, ob es auf Docsbook betrieben wird oder nicht.

3. Komposition#

Skills werden zusammengesetzt statt vervielfacht. Jeder Skill enthält ein references/-Verzeichnis mit gezielt ausgerichteten Dokumenten, die er nur lädt, wenn die Aufgabe sie benötigt — docs-manage allein enthält separate Referenzen für Abruf-, Konvertierungs- und Schreibregeln. Der Agent liest den Skill und anschließend die eine relevante Referenz, statt einen Katalog zu laden.

Der docs-skills-Katalog#

Was befindet sich im docs-skills-Katalog?#

docs-skills ist ein Open-Source-Katalog mit vier Skills, die jeweils eine Aufgabe abdecken, die ein Agent mit Dokumentation ausführt. Früher war es eine lange Liste eng gefasster Skills; sie wurde konsolidiert, weil ein Agent, der zwischen fünfzig nahezu synonymen Beschreibungen wählen muss, schlechte Entscheidungen trifft und vier Aufgaben unterscheidbar sind.

Skill Die Aufgabe
docs-create Dokumentation erstellen, die noch nicht existiert – von einer Produktwebsite, einem Code-Repository, einer anderen Dokumentationsplattform, von der Sie migrieren, oder nur anhand eines Produktnamens
docs-analyze Herausfinden, was an bereits vorhandener Dokumentation falsch ist, und dies beheben – ausgehend von Suchpositionen, KI-Antwortsignalen, dem Verhalten der Leser und Funnels
docs-manage Das Regelwerk zum Schreiben einer Seite und zum Betreiben der Website, auf der sie sich befindet – Seitentyp, Struktur, Stil, Zielgruppe, Abruf, Konversion
docs-automate Die Dinge einrichten, die ohne Erinnerung von selbst weiterlaufen sollten – Drift-Wächter, Übersetzungsauslöser, Release-Ankündigungen

Jeder Skill ist ein eigenständiges SKILL.md im GitHub-Repository und verfügt über ein references/-Verzeichnis, das der Agent bei Bedarf liest. Der maschinenlesbare Index befindet sich als index.json im selben Repository; die obigen Zahlen wurden am 03.09.2026 daraus ausgelesen.

Zwei Möglichkeiten, Skills zu verwenden#

Lokale Installation#

npx docs-skills install

Kopiert den Katalog nach .claude/skills/, .cursor/rules/ oder AGENTS.md (abhängig vom erkannten Tool). Funktioniert offline. Wird mit docs-skills update aktualisiert.

Dieses Muster: Die Skills deiner Tools liegen in deinem Repository und werden versioniert.

Laufzeitentdeckung über MCP#

Wenn Docsbook MCP verbunden ist, ruft Ihr Agent Folgendes auf:

find_skill({ query: "audit my docs for SEO and accessibility" })

Es gibt die am besten passenden Skills mit raw_url für jeden SKILL.md zurück. Der Agent ruft die Anweisungen ab und befolgt sie.

Dieses Muster: keine lokale Installation, immer die neueste Version, funktioniert auf allen Rechnern.

Wie KI-Agenten Fähigkeiten in der Praxis nutzen#

Drei reale Arbeitsabläufe, die wir beobachtet haben:

Workflow 1: PR-Prüfung#

Ein Entwickler öffnet einen PR, der docs/ berührt. Sein Claude Code (oder Cursor) ruft docs-pr-check auf. Der Skill:

  1. Listet die geänderten .md-Dateien auf
  2. Ruft für jede Datei doc_search_unresolved auf
  3. Prüft die Vollständigkeit des Frontmatters
  4. Meldet die Ergebnisse als PR-Kommentar

Der Entwickler sieht den Bericht vor einem menschlichen Reviewer. Viele Probleme in der Dokumentation erreichen das Team nie.

Workflow 2: Erkennung veralteter Inhalte#

Der wöchentliche Cronjob im Setup des Benutzers ruft docs-stale-watcher auf. Der Skill:

  1. Durchsucht Docsbook Analytics nach Seiten mit Zugriffen, die seit mehr als 90 Tagen nicht bearbeitet wurden
  2. Gleicht die Ergebnisse mit dem Dokumentationsgraphen ab
  3. Listet Kandidaten für eine Aktualisierung auf

Die Ausgabe ist ein Backlog der zu aktualisierenden Seiten – Inhaltslücken mit Umsatzsignal.

Workflow 3: Feinabstimmung des KI-Chats#

Der Benutzer sagt: „Mein KI-Chat halluziniert über Funktion X.“ Der Agent ruft docs-tune-ai-chat auf. Der Skill:

  1. Ruft get_ai_questions auf, um kürzlich unbeantwortete Anfragen anzuzeigen
  2. Ruft get_negative_feedback auf, um Muster bei negativen Bewertungen zu erkennen
  3. Identifiziert fehlende oder unzureichende Inhalte
  4. Schlägt eine neue Seite oder eine Änderung des System-Prompts vor

Dies ist die Schleife „Agent verbessert Agent“.

Skills + MCP: die Architektur#

Skills sagen dem Agenten was zu tun ist. MCP-Tools sagen dem Agenten wie es zu tun ist.

  • Ein Skill sagt „Führe für jede Seite ein Accessibility-Audit durch“
  • Der Skill-Text listet Schritte wie „Rufe doc_list_pages auf und anschließend doc_outline für jede Seite“
  • MCP stellt die tatsächlichen Tools bereit, die der Skill aufruft

Keines von beiden reicht allein aus. Zusammen bilden sie einen vollständigen Ablauf: Ermittlung (find_skill) → Anweisungen (SKILL.md) → Ausführung (MCP-Tools).

So sieht das für Ihre eigene Dokumentation aus#

Wenn Sie ein entwicklerorientiertes Produkt anbieten und möchten, dass KI-Agenten gut mit Ihrer Dokumentation interagieren können, sind drei Schritte erforderlich:

  1. Veröffentlichen Sie auf einer Plattform mit llms.txt — Docsbook generiert automatisch einen pro Arbeitsbereich
  2. Stellen Sie einen MCP-Server bereit oder verlassen Sie sich auf den der Plattform — Docsbook MCP ist enthalten
  3. Installieren Sie relevante docs-skills lokal — npx docs-skills install

Danach kann jeder Agent (Claude Code, Cursor, ChatGPT mit HTTP MCP) autonom mit Ihrer Dokumentation arbeiten.

Erstelle deinen eigenen Skill#

Wenn du einen Docs-Workflow hast, der nicht im Katalog enthalten ist, trage ihn bei. Das SKILL.md-Format ist einfach, der Katalog öffentlich und Beiträge werden innerhalb weniger Tage veröffentlicht.

Ein nützlicher Skill ist:

  • Spezifisch (eine Aufgabe, gut erledigt)
  • Komponierbar (ruft vorhandene MCP-Tools auf)
  • Durch eine klare Benutzerabsicht ausgelöst
  • Mit Beispielen dokumentiert

Das Repository enthält eine SKILL.md-Vorlage und einen Leitfaden für Beiträge.

Docsbook bietet Unterstützung für Docs-Skills: das find_skill-MCP-Tool zur Laufzeit-Erkennung und npx docs-skills install für eine lokale Kopie. Veröffentliche einen Workspace, und der MCP-Endpunkt wird automatisch mitgeliefert – die Einrichtungsschritte findest du unter docsbook.io/mcp.

Kostenlos starten – keine Kreditkarte erforderlich

Nächste Schritte#

Updated

War diese Seite hilfreich?

Powered by Docsbook