Agent skill

API Versioning Strategy

Implements API versioning using URL paths, headers, or query parameters with backward compatibility and deprecation strategies.

MITAuto-check passed

Install API Versioning Strategy

skills CLI

$ npx skills add secondsky/claude-skills --skill api-versioning-strategy -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI

$ gh skill install secondsky/claude-skills api-versioning-strategy --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy

$ git clone --depth 1 https://github.com/secondsky/claude-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/plugins/api-versioning-strategy/skills/api-versioning-strategy .claude/skills/api-versioning-strategy && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Paste into Claude Code

Install the "api-versioning-strategy" agent skill from https://github.com/secondsky/claude-skills/tree/main/plugins/api-versioning-strategy/skills/api-versioning-strategy into .claude/skills/api-versioning-strategy/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "api-versioning-strategy", then confirm the skill loads.

Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

$skill-installer

$skill-installer install https://github.com/secondsky/claude-skills/tree/main/plugins/api-versioning-strategy/skills/api-versioning-strategy

Type this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.

skills CLI

$ npx skills add secondsky/claude-skills --skill api-versioning-strategy -a codex

Project install goes to .agents/skills/; add -g for ~/.codex/skills/.

GitHub CLI

$ gh skill install secondsky/claude-skills api-versioning-strategy --agent codex

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/secondsky/claude-skills.git skills-src && mkdir -p .agents/skills && cp -r skills-src/plugins/api-versioning-strategy/skills/api-versioning-strategy .agents/skills/api-versioning-strategy && rm -rf skills-src

Use ~/.agents/skills/ instead of .agents/skills for a personal install.

Codex skills documentation · loads skills from .agents/skills/

Paste into Codex

Install the "api-versioning-strategy" agent skill from https://github.com/secondsky/claude-skills/tree/main/plugins/api-versioning-strategy/skills/api-versioning-strategy into .agents/skills/api-versioning-strategy/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "api-versioning-strategy", then confirm the skill loads.

Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add secondsky/claude-skills --skill api-versioning-strategy -a cursor

Project install goes to .agents/skills/; add -g for ~/.cursor/skills/.

GitHub CLI

$ gh skill install secondsky/claude-skills api-versioning-strategy --agent cursor

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/secondsky/claude-skills.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/plugins/api-versioning-strategy/skills/api-versioning-strategy .cursor/skills/api-versioning-strategy && rm -rf skills-src

Use ~/.cursor/skills/ instead of .cursor/skills for a personal install.

Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/

Paste into Cursor

Install the "api-versioning-strategy" agent skill from https://github.com/secondsky/claude-skills/tree/main/plugins/api-versioning-strategy/skills/api-versioning-strategy into .cursor/skills/api-versioning-strategy/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "api-versioning-strategy", then confirm the skill loads.

Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

gemini skills install

$ gemini skills install https://github.com/secondsky/claude-skills.git --path plugins/api-versioning-strategy/skills/api-versioning-strategy

--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.

skills CLI

$ npx skills add secondsky/claude-skills --skill api-versioning-strategy -a gemini-cli

Project install goes to .agents/skills/; add -g for ~/.gemini/skills/.

GitHub CLI

$ gh skill install secondsky/claude-skills api-versioning-strategy --agent gemini-cli

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/secondsky/claude-skills.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/plugins/api-versioning-strategy/skills/api-versioning-strategy .gemini/skills/api-versioning-strategy && rm -rf skills-src

Use ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.

Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/

Paste into Gemini CLI

Install the "api-versioning-strategy" agent skill from https://github.com/secondsky/claude-skills/tree/main/plugins/api-versioning-strategy/skills/api-versioning-strategy into .gemini/skills/api-versioning-strategy/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "api-versioning-strategy", then confirm the skill loads.

Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

GitHub CLI

$ gh skill install secondsky/claude-skills api-versioning-strategy

Installs for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).

skills CLI

$ npx skills add secondsky/claude-skills --skill api-versioning-strategy -a github-copilot

Project install goes to .agents/skills/; add -g for ~/.copilot/skills/.

Manual copy

$ git clone --depth 1 https://github.com/secondsky/claude-skills.git skills-src && mkdir -p .github/skills && cp -r skills-src/plugins/api-versioning-strategy/skills/api-versioning-strategy .github/skills/api-versioning-strategy && rm -rf skills-src

Use ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.

GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/

Paste into GitHub Copilot

Install the "api-versioning-strategy" agent skill from https://github.com/secondsky/claude-skills/tree/main/plugins/api-versioning-strategy/skills/api-versioning-strategy into .github/skills/api-versioning-strategy/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "api-versioning-strategy", then confirm the skill loads.

GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add secondsky/claude-skills --skill api-versioning-strategy -a opencode

OpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.

GitHub CLI

$ gh skill install secondsky/claude-skills api-versioning-strategy --agent opencode

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/secondsky/claude-skills.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/plugins/api-versioning-strategy/skills/api-versioning-strategy .opencode/skills/api-versioning-strategy && rm -rf skills-src

Use ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.

OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/

Paste into OpenCode

Install the "api-versioning-strategy" agent skill from https://github.com/secondsky/claude-skills/tree/main/plugins/api-versioning-strategy/skills/api-versioning-strategy into .opencode/skills/api-versioning-strategy/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "api-versioning-strategy", then confirm the skill loads.

OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

Facts

Skill name: api-versioning-strategy
GitHub stars: 227
Used in: 1 other repo
Token cost: ~531 tokens
SKILL.md length: 132 words
Files: 1
Skills in repo: 169
Repo updated: Sep 28, 2026
First seen: Oct 7, 2026
Licence: MIT

At a glance

Implements API versioning using URL paths, headers, or query parameters with backward compatibility and deprecation strategies.

Managing multiple API versions
SKILL.md covers Versioning Methods, URL Path Versioning…, Version Adapter Pattern and Deprecation Headers, plus 3 more sections
Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md
Planning breaking changes

What it does

API Versioning Strategy is an agent skill from secondsky/claude-skills. Implements API versioning using URL paths, headers, or query parameters with backward compatibility and deprecation strategies. Use when managing multiple API versions, planning breaking changes, or designing migration paths.

Its SKILL.md is about 530 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

The repository describes itself as: Production-ready skills for Claude Code CLI - Cloudflare, React, Tailwind v4, and AI integrations. The licence is MIT.

When your agent uses it

Managing multiple API versions
Planning breaking changes
Designing migration paths

Example prompts

“Use the api-versioning-strategy skill to implement API versioning using URL paths, headers, or query parameters with backward compatibility and…”
“/api-versioning-strategy”

What it can do on your machine

Read from SKILL.md and the folder at commit 8837836. It shows what the files ask for, not the result of running them.

Tool permissions
Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.
From allowed-tools in the SKILL.md frontmatter.
Runs code
No scripts in the folder and no shell commands in SKILL.md (its code samples are javascript).
From the folder's file list and the shell code blocks in SKILL.md.
Network
No URLs in SKILL.md.
From URLs in SKILL.md, links to its own repository left out.
Credentials
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

API Versioning Strategy loads about 531 tokens when it runs. Until then it costs about 62 tokens; SKILL.md has 132 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it: ~62
When it runs · the whole SKILL.md, loaded when a task matches: ~531

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from secondsky/claude-skills at commit 8837836, republished under its MIT licence (© secondsky). 132 words, ~531 tokens.

Download SKILL.mdSave it as .claude/skills/api-versioning-strategy/SKILL.md (or your agent's skills folder).

name: api-versioning-strategy
description: Implements API versioning using URL paths, headers, or query parameters with backward compatibility and deprecation strategies. Use when managing multiple API versions, planning breaking changes, or designing migration paths.
license: MIT

API Versioning Strategy

Choose and implement API versioning approaches with proper deprecation timelines.

Versioning Methods

Method	Example	Pros	Cons
URL Path	`/api/v1/users`	Clear, cache-friendly	URL clutter
Header	`API-Version: 1`	Clean URLs	Hidden, harder to test
Query	`?version=1`	Easy to use	Not RESTful

URL Path Versioning (Recommended)

javascript

const v1Router = require('./routes/v1');
const v2Router = require('./routes/v2');

app.use('/api/v1', v1Router);
app.use('/api/v2', v2Router);

Version Adapter Pattern

javascript

// Transform between versions
const v1ToV2 = (v1Response) => ({
  data: {
    type: 'user',
    id: v1Response.user_id,
    attributes: {
      name: v1Response.user_name,
      email: v1Response.email
    }
  }
});

Deprecation Headers

javascript

app.use('/api/v1', (req, res, next) => {
  res.setHeader('Deprecation', 'true');
  res.setHeader('Sunset', 'Sat, 01 Jun 2025 00:00:00 GMT');
  res.setHeader('Link', '</api/v2>; rel="successor-version"');
  next();
});

Safe vs Breaking Changes

Safe Changes (no version bump):

Adding optional fields
Adding new endpoints
Adding optional parameters

Breaking Changes (requires new version):

Removing fields
Changing field types
Restructuring responses
Removing endpoints

Deprecation Timeline

Phase	Duration	Actions
Deprecated	3 months	Add headers, docs
Sunset Announced	3 months	Email users
Read-Only	1 month	Disable writes
Shutdown	-	Return 410 Gone

Best Practices

Support N-1 versions minimum
Provide 6+ months migration window
Include migration guides with code examples
Monitor version usage to inform deprecation

Files

Just SKILL.md in plugins/api-versioning-strategy/skills/api-versioning-strategy of secondsky/claude-skills.

Open the folder on GitHubat commit 8837836

Used in 1 other repository

We found 2 copies of this SKILL.md (exact, near-identical or edited) in other folders, from 1 other GitHub owner. This page covers the copy in secondsky/claude-skills, which our catalogue first saw on October 7, 2026.

majiayu000/claude-skill-registryskills/api/api-versioning-strategy skills/api/api-versioning-strategy-secondsky-claude-skills

Compare with similar skills

API Versioning Strategy next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

API Versioning Strategy compared with similar skills
Skill	Stars	Used in	Tokens	Auto-check	Licence	Repo updated
API Versioning Strategy this skillsecondsky/claude-skills	227	1 repos	~531	Automated safety check: Pass	MIT	9 days ago
Implementsickn33/agentic-awesome-skills	47k	5 repos	~306	Automated safety check: Pass	MIT	yesterday
Implementing Attack Path Analysis With Xm Cybermukul975/Anthropic-Cybersecurity-Skills	34k	—	~2.7k	Automated safety check: Pass	Apache-2.0	1 mo ago
Implementcodewhale-hq/Codewhale	41k	—	~190	Automated safety check: Pass	MIT	today
Semantic Versioningsickn33/agentic-awesome-skills	47k	1 repos	~2.6k	Automated safety check: Pass	MIT	yesterday
Update V8 Versionopeninterpreter/openinterpreter	69k	2 repos	~845	Automated safety check: Pass	Apache-2.0	today

Similar skills

Implement
sickn33/agentic-awesome-skills
Implement a piece of work based on a PRD or set of issues. An agent skill from sickn33/agentic-awesome-skills.
47k GitHub starsUsed in 5 repos~306 tokens
Product & Project ManagementAuto-check passed
Implementing Attack Path Analysis With Xm Cyber
mukul975/Anthropic-Cybersecurity-Skills
Deploys XM Cyber's continuous exposure management platform to build attack graphs that chain vulnerabilities, misconfigurations, identity risks, and credential weaknesses toward critical assets…
34k GitHub stars~2.7k tokensUpdated 1 mo ago
SecurityAuto-check passed
Implement
codewhale-hq/Codewhale
Carry an authorized, defined request or approved plan through scoped edits and proportionate verification.
41k GitHub stars~190 tokensUpdated today
Auto-check passed
Semantic Versioning
sickn33/agentic-awesome-skills
Automate versioning and changelog generation using semantic versioning principles.
47k GitHub starsUsed in 1 repo~2.6k tokens
DevelopmentAuto-check passed
Update V8 Version
openinterpreter/openinterpreter
Bumps the pinned v8 and rusty_v8 versions in Codex, validates the release-candidate path with the v8-canary check, and traces failures to upstream build changes.
69k GitHub starsUsed in 2 repos~845 tokens
DevOps & CloudAuto-check passed
Incremental Implementation
addyosmani/agent-skills
Delivers a change in thin vertical slices, each implemented, tested, verified and committed before the next, using vertical, contract-first or risk-first slicing.
102k GitHub starsUsed in 1 repo~2.3k tokens
Agent WorkflowsAuto-check passed

More from secondsky/claude-skills

All 169 skills in this repo

Tanstack AI
secondsky/claude-skills
TanStack AI (alpha) provider-agnostic type-safe chat with streaming for OpenAI, Anthropic, Gemini, Ollama.
227 GitHub starsUsed in 1 repo~3.6k tokens
Auto-check: notes
Auto Animate
secondsky/claude-skills
AutoAnimate (@formkit/auto-animate) zero-config animations for React.
227 GitHub stars~2.9k tokensUpdated 9 days ago
Auto-check passed
Base UI React
secondsky/claude-skills
MUI Base UI unstyled React components with Floating UI. An agent skill from secondsky/claude-skills.
227 GitHub stars~1.9k tokensUpdated 9 days ago
Auto-check passed
Cloudflare Images
secondsky/claude-skills
This skill should be used when the user asks to "upload images to Cloudflare", "implement direct creator upload", "configure image transformations", "optimize WebP/AVIF", "create image variants"…
227 GitHub stars~3.6k tokensUpdated 9 days ago
Auto-check: notes
Cloudflare Nextjs
secondsky/claude-skills
Deploy Next.js to Cloudflare Workers via the OpenNext adapter (@opennextjs/cloudflare).
227 GitHub stars~5.3k tokensUpdated 9 days ago
Auto-check: notes
Cloudflare Sandbox
secondsky/claude-skills
Cloudflare Sandboxes SDK for secure code execution in Linux containers at edge.
227 GitHub stars~4.5k tokensUpdated 9 days ago
Auto-check passed

Questions about API Versioning Strategy

What does API Versioning Strategy do?

Implements API versioning using URL paths, headers, or query parameters with backward compatibility and deprecation strategies. API Versioning Strategy is an agent skill from secondsky/claude-skills. Implements API versioning using URL paths, headers, or query parameters with backward compatibility and deprecation strategies.

When should I use API Versioning Strategy?

API Versioning Strategy fits situations like: managing multiple API versions; planning breaking changes; designing migration paths.

How do I install API Versioning Strategy in Claude Code?

Run `npx skills add secondsky/claude-skills --skill api-versioning-strategy -a claude-code`. Or copy the skill folder (plugins/api-versioning-strategy/skills/api-versioning-strategy in secondsky/claude-skills) into .claude/skills/api-versioning-strategy in your project. Claude Code loads it when a task matches its description.

How do I install API Versioning Strategy in Codex?

Run `npx skills add secondsky/claude-skills --skill api-versioning-strategy -a codex`. Or copy the skill folder (plugins/api-versioning-strategy/skills/api-versioning-strategy in secondsky/claude-skills) into .agents/skills/api-versioning-strategy in your project. Codex loads it when a task matches its description.

Can I use API Versioning Strategy in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add secondsky/claude-skills --skill api-versioning-strategy -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/api-versioning-strategy, .gemini/skills/api-versioning-strategy, .github/skills/api-versioning-strategy and .opencode/skills/api-versioning-strategy in your project.

What does API Versioning Strategy need to run?

SKILL.md names no scripts, command-line tools or credentials: API Versioning Strategy is instructions for the agent only.

Does API Versioning Strategy access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is API Versioning Strategy safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does API Versioning Strategy use?

API Versioning Strategy is published under the MIT licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does API Versioning Strategy use?

About 531 tokens (SKILL.md is roughly 2.1k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to API Versioning Strategy?

Skills that share tags, products or a category with API Versioning Strategy: Implement (sickn33/agentic-awesome-skills, 47k stars), Implementing Attack Path Analysis With Xm Cyber (mukul975/Anthropic-Cybersecurity-Skills, 34k stars), Implement (codewhale-hq/Codewhale, 41k stars) and Semantic Versioning (sickn33/agentic-awesome-skills, 47k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains API Versioning Strategy?

secondsky (a GitHub user) maintains it in secondsky/claude-skills, which has 227 GitHub stars. The repository holds 169 skills in this directory. The repository was last updated on September 28, 2026.

Source: secondsky/claude-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.

Install API Versioning Strategy

Facts

At a glance

What it does

When your agent uses it

Example prompts

What it can do on your machine

Tool permissions

Runs code

Network

Credentials

Context cost

Safety

SKILL.md

API Versioning Strategy

Versioning Methods

URL Path Versioning (Recommended)

Version Adapter Pattern

Deprecation Headers

Safe vs Breaking Changes

Deprecation Timeline

Best Practices

Files

Used in 1 other repository

Compare with similar skills

Similar skills

More from secondsky/claude-skills

Questions about API Versioning Strategy