Deprecate R Functions and Arguments
tidyverse/dplyr
Walks through deprecating an R function or argument in a package: lifecycle warning, silenced tests, a new snapshot test, documentation badge and NEWS entry.
Creates comprehensive API changelogs documenting breaking changes, deprecations, and migration strategies for API consumers.
Install API Changelog Versioning
$ npx skills add secondsky/claude-skills --skill api-changelog-versioning -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install secondsky/claude-skills api-changelog-versioning --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ git clone --depth 1 https://github.com/secondsky/claude-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/plugins/api-changelog-versioning/skills/api-changelog-versioning .claude/skills/api-changelog-versioning && rm -rf skills-srcUse ~/.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/
Install the "api-changelog-versioning" agent skill from https://github.com/secondsky/claude-skills/tree/main/plugins/api-changelog-versioning/skills/api-changelog-versioning into .claude/skills/api-changelog-versioning/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "api-changelog-versioning", 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 install https://github.com/secondsky/claude-skills/tree/main/plugins/api-changelog-versioning/skills/api-changelog-versioningType 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.
$ npx skills add secondsky/claude-skills --skill api-changelog-versioning -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install secondsky/claude-skills api-changelog-versioning --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/secondsky/claude-skills.git skills-src && mkdir -p .agents/skills && cp -r skills-src/plugins/api-changelog-versioning/skills/api-changelog-versioning .agents/skills/api-changelog-versioning && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "api-changelog-versioning" agent skill from https://github.com/secondsky/claude-skills/tree/main/plugins/api-changelog-versioning/skills/api-changelog-versioning into .agents/skills/api-changelog-versioning/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "api-changelog-versioning", 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.
$ npx skills add secondsky/claude-skills --skill api-changelog-versioning -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install secondsky/claude-skills api-changelog-versioning --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/secondsky/claude-skills.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/plugins/api-changelog-versioning/skills/api-changelog-versioning .cursor/skills/api-changelog-versioning && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "api-changelog-versioning" agent skill from https://github.com/secondsky/claude-skills/tree/main/plugins/api-changelog-versioning/skills/api-changelog-versioning into .cursor/skills/api-changelog-versioning/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "api-changelog-versioning", 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 https://github.com/secondsky/claude-skills.git --path plugins/api-changelog-versioning/skills/api-changelog-versioning--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add secondsky/claude-skills --skill api-changelog-versioning -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install secondsky/claude-skills api-changelog-versioning --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/secondsky/claude-skills.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/plugins/api-changelog-versioning/skills/api-changelog-versioning .gemini/skills/api-changelog-versioning && rm -rf skills-srcUse ~/.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/
Install the "api-changelog-versioning" agent skill from https://github.com/secondsky/claude-skills/tree/main/plugins/api-changelog-versioning/skills/api-changelog-versioning into .gemini/skills/api-changelog-versioning/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "api-changelog-versioning", 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.
$ gh skill install secondsky/claude-skills api-changelog-versioningInstalls 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).
$ npx skills add secondsky/claude-skills --skill api-changelog-versioning -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/secondsky/claude-skills.git skills-src && mkdir -p .github/skills && cp -r skills-src/plugins/api-changelog-versioning/skills/api-changelog-versioning .github/skills/api-changelog-versioning && rm -rf skills-srcUse ~/.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/
Install the "api-changelog-versioning" agent skill from https://github.com/secondsky/claude-skills/tree/main/plugins/api-changelog-versioning/skills/api-changelog-versioning into .github/skills/api-changelog-versioning/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "api-changelog-versioning", 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.
$ npx skills add secondsky/claude-skills --skill api-changelog-versioning -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install secondsky/claude-skills api-changelog-versioning --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/secondsky/claude-skills.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/plugins/api-changelog-versioning/skills/api-changelog-versioning .opencode/skills/api-changelog-versioning && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "api-changelog-versioning" agent skill from https://github.com/secondsky/claude-skills/tree/main/plugins/api-changelog-versioning/skills/api-changelog-versioning into .opencode/skills/api-changelog-versioning/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "api-changelog-versioning", 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-changelog-versioning- GitHub stars
- 227
- Used in
- 1 other repo
- Token cost
- ~497 tokens
- SKILL.md length
- 74 words
- Files
- 1
- Skills in repo
- 169
- Repo updated
- First seen
- Licence
- MIT
At a glance
Creates comprehensive API changelogs documenting breaking changes, deprecations, and migration strategies for API consumers.
- Works in 4 steps: Update SDK to v3.x → Modify response handlers → Test in staging environment → …
- Managing API versions
- SKILL.md covers Changelog Structure, Deprecation Schedule, Version Support Policy and Migration Guide Template
- Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md
What it does
API Changelog Versioning is an agent skill from secondsky/claude-skills. Creates comprehensive API changelogs documenting breaking changes, deprecations, and migration strategies for API consumers. Use when managing API versions, communicating breaking changes, or creating upgrade guides.
Its SKILL.md is about 500 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.
It sits in Development, covering Changelog and release notes and Code migrations. 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 API versions
- Communicating breaking changes
- Creating upgrade guides
Example prompts
- “Use the api-changelog-versioning skill to create comprehensive API changelogs documenting breaking changes, deprecations, and migration strategies…”
- “/api-changelog-versioning”
Workflow steps
4 steps, taken from the first numbered list in SKILL.md.
- Update SDK to v3.x
- Modify response handlers
- Test in staging environment
- Update production
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 markdown and json).
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 Changelog Versioning loads about 497 tokens when it runs. Until then it costs about 60 tokens; SKILL.md has 74 words of instructions outside code blocks.
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). 74 words, ~497 tokens.
Download SKILL.mdSave it as
.claude/skills/api-changelog-versioning/SKILL.md (or your agent's skills folder).- name
- api-changelog-versioning
- description
- Creates comprehensive API changelogs documenting breaking changes, deprecations, and migration strategies for API consumers. Use when managing API versions, communicating breaking changes, or creating upgrade guides.
- license
- MIT
API Changelog & Versioning
Document API changes with clear migration paths and deprecation timelines.
Changelog Structure
# API Changelog
## v3.0.0 (2025-01-15) - Breaking Changes
### Breaking Changes
- Response format now follows JSON:API specification
- Authentication switched from API tokens to JWT Bearer
### Migration Steps
1. Update base URL to `/api/v3`
2. Replace `Authorization: Token xxx` with `Authorization: Bearer xxx`
3. Update response parsing for new envelope format
## v2.5.0 (2024-12-01) - Features
### New Features
- Webhook support for order events
- Batch operations endpoint
- Field filtering via `?fields=` parameter
### Improvements
- 56% faster response times on /products
- Enhanced error messages with field-specific suggestionsDeprecation Schedule
| Version | Status | Support Until |
|---|---|---|
| v3.x | Current | Full support |
| v2.x | Maintenance | 2025-06-01 |
| v1.x | EOL | Unsupported |
Version Support Policy
- Current: Full support, new features
- Maintenance: Bug fixes and security only
- EOL: No support, remove from docs
Migration Guide Template
## Migrating from v2 to v3
### Before (v2)
```json
{ "user_name": "john" }After (v3)
{ "data": { "type": "user", "attributes": { "name": "john" } } }Steps
- Update SDK to v3.x
- Modify response handlers
- Test in staging environment
- Update production
## Best Practices
- Provide 3-6 months deprecation notice
- Include before/after code examples
- Mark breaking changes prominently
- Maintain backward compatibility when feasible
- Version via URL path (`/api/v1/`) for clarity© secondsky, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file
Files
Just SKILL.md in plugins/api-changelog-versioning/skills/api-changelog-versioning 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.
Compare with similar skills
API Changelog Versioning 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.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| API Changelog Versioning this skillsecondsky/claude-skills | 227 | 1 repos | ~497 | Automated safety check: Pass | MIT | |
| Deprecate R Functions and Argumentstidyverse/dplyr | 5.1k | 1 repos | ~1.2k | Automated safety check: Pass | Custom licence | |
| Releasing Php Packageyansongda/pay | 5.4k | — | ~1.6k | Automated safety check: Pass | MIT | |
| Releasejaemk/self_update | 961 | — | ~2.2k | Automated safety check: Pass | MIT | |
| Releasejaemk/cached | 2.1k | — | ~2.8k | Automated safety check: Pass | MIT | |
| Mariadb Operator Release Notesmariadb-operator/mariadb-operator | 1k | — | ~3.3k | Automated safety check: Pass | Apache-2.0 |
Similar skills
Releasing Php Package
yansongda/pay
A skill your agent uses when preparing to publish a new version of a PHP Composer package and need to write or update CHANGELOG, upgrade guides, and documentation before tagging and releasing
Release
jaemk/self_update
Prepare a release (bump the crate version, update CHANGELOG.md with a migration guide for breaking changes, regenerate README, commit), or run a pre-release review.
Release
jaemk/cached
Prepare a release (bump versions across all Cargo.toml files, update CHANGELOG.md, refresh the migration guide, regenerate README, commit), or run a pre-release review.
Mariadb Operator Release Notes
mariadb-operator/mariadb-operator
Create the release notes and upgrade guide for a mariadb-operator release.
Skia Analyst
mono/SkiaSharp
Analyze Skia features for SkiaSharp - produces a unified analysis of what shipped (upstream engine benefits, PR links, migration guides) and what's missing (impact/priority/effort scoring, hidden…
More from secondsky/claude-skills
All 169 skills in this repoTanstack AI
secondsky/claude-skills
TanStack AI (alpha) provider-agnostic type-safe chat with streaming for OpenAI, Anthropic, Gemini, Ollama.
Auto Animate
secondsky/claude-skills
AutoAnimate (@formkit/auto-animate) zero-config animations for React.
Base UI React
secondsky/claude-skills
MUI Base UI unstyled React components with Floating UI. An agent skill from secondsky/claude-skills.
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"…
Cloudflare Nextjs
secondsky/claude-skills
Deploy Next.js to Cloudflare Workers via the OpenNext adapter (@opennextjs/cloudflare).
Cloudflare Sandbox
secondsky/claude-skills
Cloudflare Sandboxes SDK for secure code execution in Linux containers at edge.
Related
Categories
Questions about API Changelog Versioning
What does API Changelog Versioning do?
Creates comprehensive API changelogs documenting breaking changes, deprecations, and migration strategies for API consumers. API Changelog Versioning is an agent skill from secondsky/claude-skills. Creates comprehensive API changelogs documenting breaking changes, deprecations, and migration strategies for API consumers.
When should I use API Changelog Versioning?
API Changelog Versioning fits situations like: managing API versions; communicating breaking changes; creating upgrade guides.
How do I install API Changelog Versioning in Claude Code?
Run `npx skills add secondsky/claude-skills --skill api-changelog-versioning -a claude-code`. Or copy the skill folder (plugins/api-changelog-versioning/skills/api-changelog-versioning in secondsky/claude-skills) into .claude/skills/api-changelog-versioning in your project. Claude Code loads it when a task matches its description.
How do I install API Changelog Versioning in Codex?
Run `npx skills add secondsky/claude-skills --skill api-changelog-versioning -a codex`. Or copy the skill folder (plugins/api-changelog-versioning/skills/api-changelog-versioning in secondsky/claude-skills) into .agents/skills/api-changelog-versioning in your project. Codex loads it when a task matches its description.
Can I use API Changelog Versioning 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-changelog-versioning -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-changelog-versioning, .gemini/skills/api-changelog-versioning, .github/skills/api-changelog-versioning and .opencode/skills/api-changelog-versioning in your project.
What does API Changelog Versioning need to run?
SKILL.md names no scripts, command-line tools or credentials: API Changelog Versioning is instructions for the agent only.
Does API Changelog Versioning 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 Changelog Versioning 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 Changelog Versioning use?
API Changelog Versioning 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 Changelog Versioning use?
About 497 tokens (SKILL.md is roughly 2k 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 Changelog Versioning?
Skills that share tags, products or a category with API Changelog Versioning: Deprecate R Functions and Arguments (tidyverse/dplyr, 5.1k stars), Releasing Php Package (yansongda/pay, 5.4k stars), Release (jaemk/self_update, 961 stars) and Release (jaemk/cached, 2.1k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
Who maintains API Changelog Versioning?
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.