Which OpenAPI versions does this skill support?

This skill is designed with deep knowledge of modern standards, specifically focusing on OpenAPI 3.0 and 3.1 specifications.

Does it provide documentation for error states?

Yes, it emphasizes documenting all possible status codes and structured error responses to improve API reliability and developer experience.

Can I use this for existing API projects?

Absolutely. It can audit, clean up, and improve existing OpenAPI files to bring them up to modern RESTful industry standards.

Can this skill help with API security?

Yes, it treats security definitions as mandatory and ensures that authentication schemes are applied consistently across all endpoints.

How does it handle complex data models?

It utilizes JSON Schema references ($ref) to avoid duplication and maintain a DRY (Don't Repeat Yourself) architecture for complex nested objects.

OpenAPI Architect

Name: OpenAPI Architect
Author: pointware

bypointware

0•

API開発

Designs, validates, and optimizes OpenAPI specifications to ensure high-quality, maintainable RESTful API contracts.

The OpenAPI Architect skill empowers Claude to act as a professional API consultant, providing specialized guidance on OpenAPI schema design, RESTful best practices, and robust validation patterns. It assists developers in creating precise, versioned, and secure API contracts that serve as a single source of truth for backend services. By focusing on consistency, realistic examples, and clear error handling, this skill ensures that API specifications are not just documentation, but functional blueprints for reliable software development.

主な機能

01Generation of realistic request and response examples for better UX

02Expert-level OpenAPI 3.x schema design and optimization

03Implementation of robust security schemes and authentication patterns

040 GitHub stars

05Comprehensive validation of API types, constraints, and parameters

06Standardized error response and HTTP status code documentation

ユースケース

01Refactoring legacy documentation into standardized OpenAPI formats

02Designing a contract-first REST API for new microservices

03Auditing existing specifications for security gaps and schema inconsistencies

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add pointware/custom-marketplace openapi

For use in Claude.ai and ChatGPT

Download Skill