versioning-apis

Original：🇺🇸 English

Translated

Implement API versioning with backward compatibility, deprecation notices, and migration paths. Use when managing API versions and backward compatibility. Trigger with phrases like "version the API", "manage API versions", or "handle API versioning".

1installs

Sourcejeremylongshore/claude-code-plugins-plus-skills

Added on2026-02-20

NPX Install

npx skill4agent add jeremylongshore/claude-code-plugins-plus-skills versioning-apis

SKILL.md Content

View Translation Comparison →

Versioning Apis

Overview

This skill provides automated assistance for api versioning manager tasks. This skill provides automated assistance for the described functionality.

Prerequisites

Before using this skill, ensure you have:

API design specifications or requirements documented
Development environment with necessary frameworks installed
Database or backend services accessible for integration
Authentication and authorization strategies defined
Testing tools and environments configured

Instructions

Use Read tool to examine existing API specifications from {baseDir}/api-specs/
Define resource models, endpoints, and HTTP methods
Document request/response schemas and data types
Identify authentication and authorization requirements
Plan error handling and validation strategies
Generate boilerplate code using Bash(api:version-*) with framework scaffolding
Implement endpoint handlers with business logic
Add input validation and schema enforcement
Integrate authentication and authorization middleware
Configure database connections and ORM models
Write integration tests covering all endpoints

See

{baseDir}/references/implementation.md

for detailed implementation guide.

Output

```
{baseDir}/src/routes/
```
- Endpoint route definitions
```
{baseDir}/src/controllers/
```
- Business logic handlers
```
{baseDir}/src/models/
```
- Data models and schemas
```
{baseDir}/src/middleware/
```
- Authentication, validation, logging
```
{baseDir}/src/config/
```
- Configuration and environment variables
OpenAPI 3.0 specification with complete endpoint definitions

Error Handling

See

{baseDir}/references/errors.md

for comprehensive error handling.

Examples

See

{baseDir}/references/examples.md

for detailed examples.

Resources

Express.js and Fastify for Node.js APIs
Flask and FastAPI for Python APIs
Spring Boot for Java APIs
Gin and Echo for Go APIs
OpenAPI Specification 3.0+ for API documentation