How does it help with API versioning?

The skill provides a comparison of URL, Header, and Query Parameter versioning strategies, helping you choose the best approach for your specific project needs.

Does this skill support GraphQL as well as REST?

Yes, it includes specific guidance for both RESTful resource design and GraphQL schema evolution, including the use of the @deprecated directive.

What is the API Lifecycle skill for Claude Code?

It is a specialized capability that provides Claude with domain-specific knowledge to help you design, document, and manage the full lifecycle of web APIs.

What error standards does this skill recommend?

It promotes the use of the RFC 7807 Problem Details format to ensure consistent, machine-readable, and human-friendly error responses.

API Lifecycle & Design

Name: API Lifecycle & Design
Author: doancan

bydoancan

•

API Development

Provides comprehensive guidance for designing, versioning, and maintaining robust REST and GraphQL APIs throughout their entire lifecycle.

The API Lifecycle skill serves as a definitive resource for developers looking to build scalable and professional APIs. It covers essential design principles such as resource-oriented modeling, idempotency, and statelessness, while providing clear frameworks for versioning strategies and managing breaking changes. By integrating industry standards like RFC 7807 for error handling and OpenAPI for documentation, this skill helps teams ensure their APIs remain maintainable, secure, and developer-friendly from initial design to eventual deprecation.

Key Features

01Comprehensive versioning and breaking change management

021 GitHub stars

03Rate limiting strategies and documentation standards

04Step-by-step API deprecation and sunsetting workflows

05Standardized error handling using RFC 7807 Problem Details

06Resource-oriented REST and GraphQL design principles

Use Cases

01Standardizing error responses and rate-limiting headers across microservices

02Architecting a new public REST API with scalable versioning and pagination

03Managing the deprecation of legacy endpoints without disrupting existing consumers

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add doancan/mags api-lifecycle

For use in Claude.ai and ChatGPT

Download Skill