How do I deprecate an old API version?

The skill provides patterns to mark specific versions as deprecated, which automatically adds the appropriate headers to inform clients of upcoming sunsets.

Can it help with API documentation?

Yes, it includes configuration patterns for the API Explorer to ensure all versions are correctly represented in OpenAPI/Swagger documentation.

Does this skill work with .NET 10?

Yes, it is specifically designed to work with .NET 10 and the latest ASP.NET Core standards using the Asp.Versioning library.

How does it handle breaking changes?

It provides implementation patterns for creating new versioned endpoint groups (e.g., v2) so you can evolve your API shape without breaking existing v1 consumers.

What versioning strategies does this skill support?

The skill supports URL segment versioning (recommended for public APIs), header-based versioning (ideal for internal services), and query string versioning.

ASP.NET Core API Versioning

Name: ASP.NET Core API Versioning
Author: codewithmukesh

bycodewithmukesh

•

189

•

API開発

Implements robust API versioning strategies for ASP.NET Core applications using industry best practices and the Asp.Versioning library.

This skill provides Claude with the specialized knowledge required to implement and manage professional API versioning within ASP.NET Core environments. It guides developers through setting up the Asp.Versioning library, choosing between URL segment or header-based strategies, and managing the lifecycle of an API from initial release to version deprecation. By following these standardized patterns, developers can ensure backward compatibility, maintain clean OpenAPI documentation, and evolve their services without breaking existing client integrations.

主な機能

01Implements URL segment, header, and query string versioning

02Automates OpenAPI/Swagger integration for versioned discovery

03Configures Asp.Versioning for .NET 10 applications

04189 GitHub stars

05Organizes version-specific endpoint groups for clean code architecture

06Manages API version deprecation and sunset headers

ユースケース

01Establishing a versioning strategy for a new greenfield API project

02Implementing deprecation timelines for legacy API endpoints

03Introducing breaking changes to an existing service while maintaining v1 compatibility

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add codewithmukesh/dotnet-claude-kit api-versioning

For use in Claude.ai and ChatGPT

Download Skill