Über
api-doc ist ein Anthropic-Skill, der die Lücke zwischen API-Spec und gelebter Doku schließt. Er liest OpenAPI 3.1, JSON-Schema oder tRPC-Definitionen und erzeugt daraus Markdown, Beispiele in curl, Python und TypeScript, und prüft gleichzeitig, ob das Coding die Spec noch einhält. Sobald ein Endpunkt umbenannt oder entfernt wird, meldet der Skill einen Drift-Report.
Praxisbeispiel
Dein Team führt einen neuen Endpoint /v2/orders/:id/cancel ein. Der Skill sieht die OpenAPI-Änderung, erzeugt sofort eine Tabelle mit Pflichtfeldern, ergänzt ein curl-Beispiel mit Bearer-Token und ein fetch-Snippet mit Error-Handling. Eine halbe Stunde später fügt jemand das Response-Schema für 422 nicht hinzu; im Drift-Report taucht die Warnung auf und der Skill verhindert, dass der PR gemergt wird.
Stärken
- Hält Doc-Generator und Spec synchron; niemand editiert mehr drei README-Dateien parallel.
- Status-Code-Doku mit echten Snippets, nicht nur mit Text.
Schwächen
- Bei subschema-reichen GraphQL-APIs stösst der Skill an seine Tabellen-Grenzen und braucht einen ergänzenden Generator.