Will it help me keep my API documentation DRY?

Yes, it uses advanced OpenAPI components and $ref pointers to ensure your schemas and parameters are reusable and easy to maintain.

How does it handle complex authentication methods?

It provides detailed security schemes for OAuth2 with multiple flows, OpenID Connect Discovery, Mutual TLS, and standard JWT/Bearer tokens.

Does this skill support the latest OpenAPI standards?

Yes, it is fully optimized for OpenAPI 3.1, including support for the JSON Schema 2020-12 vocabulary and webhooks.

Can I use this to create interactive documentation?

While the skill generates the underlying specification (YAML/JSON), it follows best practices specifically for rendering in tools like Swagger UI, Redoc, and Stoplight.

API Documentation & OpenAPI Expert

Name: API Documentation & OpenAPI Expert
Author: cosmix

bycosmix

•

API 개발

Generates comprehensive OpenAPI/Swagger specifications and developer-friendly REST API documentation with technical precision.

This skill empowers Claude to act as a seasoned technical writer and API architect, specializing in the creation and maintenance of OpenAPI 3.1 specifications. It handles everything from defining complex request/response schemas with JSON Schema support to documenting authentication flows, rate limits, and error handling. Whether you are building interactive documentation for Swagger UI or Redoc, or generating client SDK guides, this skill ensures your API contracts are technically accurate, DRY, and highly usable for the developer community.

주요 기능

01Comprehensive webhook, rate limit, and error handling specifications

02Advanced JSON Schema modeling using $ref and discriminators

03Detailed authentication flow documentation including OAuth2 and JWT

044 GitHub stars

05Interactive documentation design for Redoc, Stoplight, and Swagger UI

06Full OpenAPI 3.1 and Swagger specification generation

사용 사례

01Updating API reference docs to include new endpoints and complex schema constraints

02Creating developer-facing guides with practical curl examples and troubleshooting tips

03Converting existing backend code or routes into a standardized OpenAPI specification

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add cosmix/loom api-documentation

For use in Claude.ai and ChatGPT

Download Skill