المهارات API Documenter
📝

API Documenter

آمن

API-Dokumentation erstellen

Entwickler verbringen Stunden damit, API-Dokumentation manuell zu schreiben. Diese Fähigkeit automatisiert die Erstellung umfassender API-Dokumentation aus Code oder OpenAPI-Spezifikationen und spart Zeit sowie ensures Konsistenz.

يدعم: Claude Codex Code(CC)
🥉 72 برونزي
1

تنزيل ZIP المهارة

2

رفع في Claude

اذهب إلى Settings → Capabilities → Skills → Upload skill

3

فعّل وابدأ الاستخدام

اختبرها

استخدام "API Documenter". Generate API docs for a GET /users/{id} endpoint that returns user profile data

النتيجة المتوقعة:

  • # GET /users/{id}
  •  
  • Retrieves a user profile by unique identifier.
  •  
  • ## Request
  • - Method: GET
  • - Path: /users/{id}
  • - Auth: Bearer token required
  •  
  • ## Response 200
  • ```json
  • {"id": "user_123", "name": "John Doe", "email": "john@example.com"}
  • ```

استخدام "API Documenter". Document this OpenAPI spec for a pets API

النتيجة المتوقعة:

  • # Pet Store API
  •  
  • ## Overview
  • RESTful API for managing pet inventory.
  •  
  • ## Endpoints
  • - GET /pets - List pets
  • - POST /pets - Add pet
  • -GET /pets/{id} - Get pet
  • - DELETE /pets/{id} - Remove pet

التدقيق الأمني

آمن
v1 • 2/24/2026

This is a prompt-only skill that generates API documentation. Static analysis found no executable code, no network requests, no filesystem access, and no external command execution. The skill contains only natural language prompts for generating documentation content.

0
الملفات التي تم فحصها
0
الأسطر التي تم تحليلها
0
النتائج
1
إجمالي عمليات التدقيق
لا توجد مشكلات أمنية
تم تدقيقه بواسطة: claude

درجة الجودة

38
الهندسة المعمارية
100
قابلية الصيانة
85
المحتوى
50
المجتمع
100
الأمان
74
الامتثال للمواصفات

ماذا يمكنك بناءه

Schnelle API-Dokumentation für interne Dienste

Schnelle Dokumentationserstellung für interne Microservices während Entwicklungssprints

Öffentliche API-Dokumentation

Erstellen von polierter, benutzerorientierter Dokumentation für öffentliche API-Produkte

Wiederherstellung von Legacy-API-Dokumentation

Dokumentation für undokumentierte Legacy-APIs durch Code-Analyse erstellen

جرّب هذه الموجهات

Basis-Dokumentationsanfrage
API-Dokumentation für den folgenden Endpunkt erstellen: [Endpunktcode oder Beschreibung einfügen]
Vollständige API-Dokumentation
Umfassende API-Dokumentation für diese OpenAPI-Spezifikation erstellen: [OpenAPI JSON/YAML einfügen]
Mehrsprachige Beispiele
API-Dokumentation mit Code-Beispielen in Python, JavaScript und curl erstellen für: [Endpunktdetails einfügen]
Markdown-Dokumentation
Polierte Markdown-API-Dokumentation mit Abschnitten für Übersicht, Endpunkte, Authentifizierung, Fehlercodes und Beispiele erstellen: [API-Spezifikation einfügen]

أفضل الممارسات

  • Vollständige OpenAPI-Spezifikationen für beste Ergebnisse bereitstellen
  • Authentifizierungsdetails in der Eingabe angeben
  • Generierte Beispiele vor der Veröffentlichung auf Richtigkeit überprüfen

تجنب

  • Erwarten von Live-Tests von API-Endpunkten
  • Unvollständige oder mehrdeutige Endpunktbeschreibungen bereitstellen
  • Annehmen, dass die Fähigkeit Ihre spezifischen internen Konventionen kennt

الأسئلة المتكررة

Welche Eingabeformate akzeptiert diese Fähigkeit?
Diese Fähigkeit akzeptiert OpenAPI-Spezifikationen im JSON- oder YAML-Format sowie natürliche Sprachbeschreibungen von API-Endpunkten.
Kann diese Fähigkeit meine API-Endpunkte testen?
Nein, diese Fähigkeit erstellt nur Dokumentation. Sie kann keine tatsächlichen HTTP-Anfragen senden, um Endpunkte zu testen.
Welche Programmiersprachen werden für Code-Beispiele unterstützt?
Die Fähigkeit kann Beispiele in JavaScript, Python, curl, Ruby, Go und anderen gängigen Sprachen erstellen.
Funktioniert dies mit GraphQL-APIs?
Diese Fähigkeit konzentriert sich derzeit auf REST-APIs. GraphQL-Unterstützung könnte in zukünftigen Versionen hinzugefügt werden.
Wie genau ist die generierte Dokumentation?
Die Genauigkeit hängt von der Vollständigkeit Ihrer Eingabespezifikation ab. Vollständige OpenAPI-Spezifikationen erzeugen die genaueste Dokumentation.
Kann ich das Ausgabeformat anpassen?
Ja, Sie können Markdown, HTML oder andere Formate in Ihrer Eingabeaufforderung angeben. Die Standardausgabe ist Markdown.

تفاصيل المطور

المؤلف

sickn33

الترخيص

MIT

مرجع

main

بنية الملفات

📄 SKILL.md