Does it support authentication definitions?

Yes, it comes pre-configured with Bearer Token (JWT) authentication templates and standard security scheme definitions.

Can this skill handle complex nested schemas?

Yes, it uses a modular directory structure to define and reference complex data models separately in a schemas/ directory for better organization.

Can I generate a mock server from these specifications?

Absolutely. The generated files are compatible with Prism, allowing you to spin up a mock server for frontend development immediately.

How do I validate the generated specifications?

The skill provides specific CLI commands using Redocly lint to ensure your OpenAPI files are valid and follow best practices.

API Specification Architect

Name: API Specification Architect
Author: infinith4

byinfinith4

•

API 开发

Standardizes RESTful API design by generating comprehensive OpenAPI/Swagger documentation, schemas, and endpoint definitions.

This skill empowers Claude to act as a senior API architect, creating structured, modular, and production-ready API specifications. It automates the creation of OpenAPI 3.0.3 files, organized into discrete schemas and path definitions for better maintainability. By following established RESTful guidelines for URL design, status codes, and pagination, it ensures consistency across your backend services while providing the necessary scaffolding for mock servers, linting, and automated client code generation.

主要功能

01Implements standardized RESTful URL design and HTTP status code patterns

02Includes built-in support for Bearer Token (JWT) authentication schemes

03Integrates with Redocly and Prism for linting, documentation, and mocking

041 GitHub stars

05Generates modular OpenAPI 3.0.3 specifications with split schemas and paths

06Provides templates for common CRUD operations and complex pagination

使用场景

01Refactoring legacy API documentation into a modern, modular OpenAPI structure

02Generating consistent request/response schemas for frontend-backend synchronization

03Bootstrapping a new microservice with a well-defined API contract

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add infinith4/dev-ai-driven-development api-spec

For use in Claude.ai and ChatGPT

Download Skill