API Compat Review
Backward-compatibility review of changes to a project's public surface. Use when a diff changes exported function or type signatures, renames or removes public symbols, changes a default value, alters config keys, environment variables, or CLI flags, modifies an HTTP or wire format, migrates a database schema, changes exception or error types, touches plugin or extension hooks, or whenever a PR proposes a major-version bump. Establishes what the project actually promises, diffs the public surface between base and head with language-native tooling, classifies each change against a breaking-chan
Install
/plugin marketplace add priyank766/OpenSource-SKILLThe repo is a Claude Code plugin marketplace. Run /plugin afterwards to pick the plugin that includes this skill.
npx skills add priyank766/OpenSource-SKILL --skill api-compat-reviewgit clone --depth 1 https://github.com/priyank766/OpenSource-SKILL.git /tmp/OpenSource-SKILL
mkdir -p ~/.claude/skills
cp -r /tmp/OpenSource-SKILL/skills/api-compat-review ~/.claude/skills/api-compat-reviewPersonal skills live in ~/.claude/skills. Use .claude/skills in a project folder to share a skill with your team.
From the SKILL.md
# API Compatibility Review A specialised lens layered on [`pr-review`](https://github.com/priyank766/OpenSource-SKILL/blob/main/skills/pr-review/SKILL.md). Run the general procedure first; run this when the diff touches anything a downstream consumer can observe. **Read first:** [`DETECTION-PLAYBOOK.md`](references/DETECTION-PLAYBOOK.md) · [`QUALITY-FILTER.md`](references/QUALITY-FILTER.md) · [`REVIEW-VOICE.md`](references/REVIEW-VOICE.md) > **Where the time goes.** Finding the flaw is the review. The playbook above is the > general flaw-hunting procedure; this file is the domain-specific lens on top of it. > Scoring and writing the comment are the last ten minutes, not the work. **Severity floor: 7.5** — lower than the suite default of 8.0. The asymmetry justifies it. A noisy comment costs one maintainer thirty seconds. A missed break reaches every downstream user simultaneously the moment the release publishes, and cannot be un-shipped: registries are append-only, a yanked version is still in someone's lockfile, and the fix arrives as *another* release those users must now also adopt. Under that asymmetry, a false positive is cheap and a false negative is not. --- ## The governing question > **What breaks for someone who upgrades without reading the changelog?** Not "is this change reasonable" — most breaks are reasonable. Not "is the new API better" — it usually is. The only question is what happens to the person who bumps a caret range,
Details
- Skill name
api-compat-review- Repository
- priyank766/OpenSource-SKILL
- Path
skills/api-compat-review/SKILL.md- License
- Apache-2.0
- Repo updated
- 6 August 2026
- Listed in
- karanb192/awesome-claude-skills
FAQ
What does the API Compat Review skill do?
Backward-compatibility review of changes to a project's public surface. Use when a diff changes exported function or type signatures, renames or removes public symbols, changes a default value, alters config keys, environment variables, or CLI flags, modifies an HTTP or wire format, migrates a database schema, changes exception or error types, touches plugin or extension hooks, or whenever a PR proposes a major-version bump. Establishes what the project actually promises, diffs the public surface between base and head with language-native tooling, classifies each change against a breaking-chan
How do I install the API Compat Review skill?
Claude Code plugin: /plugin marketplace add priyank766/OpenSource-SKILL. Skills go in ~/.claude/skills (personal) or .claude/skills (project), and Claude loads them automatically when a task matches the description.
Is API Compat Review popular?
It lives in priyank766/OpenSource-SKILL, which has 1 GitHub stars and 0 forks, and is included in 1 curated skill list.
Related skills
Contributor Experience Review
1priyank766/OpenSource-SKILL
Review of a first-time or early-stage contributor's pull request, where the technical bar stays fixed but the sequencing, batching, and supplied context change. Use when GitHub labels the author a first-time contributor, when the PR comes from a newcomer to this repo, when it arrives via Hacktoberfest, GSoC, Outreachy, or a good-first-issue, when the change is technically close but procedurally messy (missing DCO, wrong base branch, unsigned commits, failing lint), or when the PR must be declined and the decline needs to not cost the project a future contributor. Applies a raised severity floo
Dependency Review
1priyank766/OpenSource-SKILL
Supply-chain review of dependency and CI changes in an open-source pull request. Use when a PR adds or bumps a dependency, changes a lockfile, introduces a build or postinstall script, edits a GitHub Actions workflow, changes a container base image, or when a bot-generated dependency bump needs human judgement before merge. Covers install-time code execution, package-identity and typosquat checks, artifact provenance, transitive footprint, license class, and workflow privilege changes. Ecosystem-agnostic — npm, PyPI, Go, Cargo, RubyGems, Composer, containers. Do NOT use for routine patch bumps
Docs Review
1priyank766/OpenSource-SKILL
Review of documentation correctness in an open-source pull request — treating docs as unexecuted code and verifying them by running them. Use when a diff touches README files, docstrings, tutorials, quickstarts, API reference, migration guides, changelogs, or example projects, and equally when a code diff renames a symbol, changes a default, adds a required argument, or alters a config key in a way that silently invalidates documentation elsewhere in the repo. Verifies samples in a clean environment, walks quickstarts from an empty state, greps the docs tree for every symbol the diff touched,
API Endpoint Builder
5lucaspmarie-a11y/claude-skills-vault
Builds production-ready REST API endpoints with validation, error handling, authentication, and documentation. Follows best practices for security and scalability.
Vis Lens Reproducibility
5TalonT-Org/AutoSkillit
Create Replicative Reproducibility visualization planning spec showing data availability, preprocessing parameter disclosure (bin widths, smoothing windows), plotting library/version, random seeds, and code reference per figure. Replicative lens answering "Can the figures be reproduced from the data and code?
Apify Actor Development
5lucaspmarie-a11y/claude-skills-vault
Important: Before you begin, fill in the generatedBy property in the meta section of .actor/actor.json. Replace it with the tool and model you're currently using, such as "Claude Code with Claude Sonnet 4.5". This helps Apify monitor and improve AGENTS.md for specific AI tools and models.
Browse the most popular Claude skills, all software development skills, or write your own with the skills generator.