What is the patterns-api-contracts skill for Claude Code?

It is a specialized capability that guides Claude Code in creating standardized, production-ready RESTful API designs and OpenAPI specifications.

Can I use this for existing (brownfield) APIs?

Yes, the skill includes logic to detect and align with existing base paths, authentication patterns, and naming conventions to ensure consistency.

Does this skill support OpenAPI 3.0?

Yes, the skill is specifically designed to generate and validate schemas following the OpenAPI 3.0.3 specification.

How does it help with error handling?

It provides a standardized framework for mapping business logic failures to appropriate HTTP status codes and machine-readable error formats.

RESTful API Contract Designer

Name: RESTful API Contract Designer
Author: deepeshBodh

bydeepeshBodh

•

Desarrollo de API

Designs standardized RESTful API contracts using best practices for endpoint mapping, schema definition, and error handling.

The patterns-api-contracts skill is a specialized tool for Claude Code that enables the creation of high-quality, spec-first RESTful API designs. It streamlines the development process by mapping user actions to appropriate HTTP methods, defining rigorous OpenAPI 3.0.3 schemas, and establishing consistent error response patterns. Whether you are building a greenfield microservice or integrating with existing brownfield systems, this skill ensures your API contracts are scalable, readable, and traceable to functional requirements.

Características Principales

01Standardized HTTP error response patterns

027 GitHub stars

03Brownfield API alignment and collision handling

04Pagination and filtering logic design

05OpenAPI 3.0.3 compliant schema generation

06Comprehensive action-to-endpoint mapping

Casos de Uso

01Refactoring legacy APIs to follow modern REST conventions

02Documenting existing endpoints into a formal OpenAPI specification

03Designing a new RESTful microservice from scratch

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add deepeshbodh/human-in-loop patterns-api-contracts

For use in Claude.ai and ChatGPT

Download Skill