dabydat/alpha-omega/nestjs-api-versioning

Claude Code and agent skill by dabydat/alpha-omega

Trust tier 3
  • community
Source check pending

Checking that the SKILL.md file is still in the repository.

API versioning patterns for NestJS. Covers URL versioning, header versioning, and API evolution strategies. Use when supporting multiple API versions, evolving APIs, or managing breaking changes.

Install

npx vskill@latest install dabydat/alpha-omega/nestjs-api-versioning

SKILL.md

NestJS API Versioning

APIs evolve. Versioning allows API changes without breaking existing clients. Without versioning, any change cascades as breaking change to all consumers.

Why API Versioning

See references/why-versioning.md for the ❌ BAD (breaking change without version) and ✅ GOOD (versioned URLs) examples.

Versioning Strategies

See references/versioning-strategies.md for URL Path, Header, and Query Parameter strategies.

URL Path Versioning Implementation

Controller Map with Version

See references/url-path-versioning.md for the UserRoutesV1/V2 and UserMessagePatternsV1/V2 constants.

Versioning Controller Patterns

Versioned Controller Structure (BFF Gateway)

See references/versioned-controllers.md for the folder tree (v1/, v2/ with DTOs) and the V1/V2 controllers.

Internal Message Pattern Versioning

See references/message-pattern-versioning.md (BFF sends to microservice with the versioned message pattern).

DTO Versioning

See references/dto-versioning.md (splitting name into firstName/lastName, renaming emailAddress→email, additive phone? in V2).

Deprecation Strategy

See references/deprecation-strategy.md (Deprecation, Sunset, Link headers).

Version Lifecycle

See references/version-lifecycle.md (v3 active → v2 deprecated → v1 sunset) and the migration guide (@Redirect 301).

Anti-Patterns to Avoid

See references/anti-patterns.md for the four ❌ examples with fixes.

Summary: Versioning Responsibilities

StrategyUse CaseComplexity
URL PathMost REST APIsLow
HeaderClean URLs, multiple versionsMedium
Query ParamQuick versioningLow

Golden rule: Version your API from the start. Breaking changes should be rare and deliberate. Communicate deprecation clearly and early.

Security

  • Security scanPassed, 95 of 100Pattern checks on the skill's files.
  • Model reviewPassed

See the full security report

Quality evaluation

  • Task evaluationNot runNo evaluation yet. Run one in Skill Studio.

See evaluation results

Source

Popularity

7-day trend score
5

Not refreshed yet.

Works with

Any agent vskill installs to: 56 targets in all. These 39 have a page on this site.

  • Claude Code
  • Cursor
  • GitHub Copilot
  • Windsurf
  • Codex
  • Gemini CLI
  • Cline
  • Amp
  • Roo Code
  • Goose
  • Continue
  • Kilo Code
  • Junie
  • Trae
  • OpenHands
  • Qwen Code
  • AI Agent
  • Tabnine Chat
  • Sourcegraph Cody
  • Amazon Q
  • Firebase Genkit
  • Sweep
  • Devin
  • Phind
  • Mentat
  • Claude Desktop
  • Aider
  • GPT Pilot
  • Plandex
  • bolt.new
  • v0
  • Replit Agent
  • Anse
  • TypingMind
  • BetterChatGPT
  • LibreChat
  • Warp AI
  • Pieces
  • Fig AI
Embed badge
vskill VERIFIED badge
[![vskill VERIFIED](https://verified-skill.com/api/v1/skills/dabydat/alpha-omega/nestjs-api-versioning/badge)](https://verified-skill.com/skills/dabydat/alpha-omega/nestjs-api-versioning)

Something wrong with this skill or its page? Tell us.