API Contract Review

by decebals

API Contract Review is a Quality skill for Claude Code, published by decebals in claude-code-java.

714 stars142 forkson decebals/claude-code-javaAdded 2026/08/23+1% in starsRepository updated 2026/02/08

View source on GitHub Download repo ZIP

ai-assisted-developmentclaude-codeclaude-code-skillsdeveloper-toolsjava

Install in seconds

Install API Contract Review

Copy API Contract Review into your Claude Code skills folder. Run the command in your terminal, or review the source on GitHub before installing.

terminal

npx degit https://github.com/decebals/claude-code-java/tree/main/.claude/skills/api-contract-review ~/.claude/skills/api-contract-review

Requires Node.js. Downloads this skill only — not the rest of the repository — into your Claude Code skills folder.

Without Node.js

git clone https://github.com/decebals/claude-code-java.git

Clones the whole repository, then copy the skill’s own directory into your skills folder yourself.

In this catalog

Source file: .claude/skills/api-contract-review/SKILL.md in decebals/claude-code-java
Installs to: ~/.claude/skills/api-contract-review
Collection: One of 18 skills cataloged from this repository
Category: Quality — 1354 skills

What API Contract Review does

API Contract Review audits REST endpoints for HTTP semantics, versioning, backward compatibility, and response consistency. Use it when reviewing API changes or checking controller PRs before release.

API Contract Review is cataloged under Quality on DirSkills. API Contract Review comes from a repository tagged ai-assisted-development, claude-code, claude-code-skills, developer-tools and java.

Documentation

README

Excerpt

API Contract Review Skill

Audit REST API design for correctness, consistency, and compatibility.

When to Use

User asks "review this API" / "check REST endpoints"
Before releasing API changes
Reviewing PR with controller changes
Checking backward compatibility

Quick Reference: Common Issues

Issue	Symptom	Impact
Wrong HTTP verb	POST for idempotent operation	Confusion, caching issues
Missing versioning	`/users` instead of `/v1/users`	Breaking changes affect all clients
Entity leak	JPA entity in response	Exposes internals, N+1 risk
200 with error	`{"status": 200, "error": "..."}`	Breaks error handling
Inconsistent naming	`/getUsers` vs `/users`	Hard to learn API

HTTP Verb Semantics

This is the opening of the README. Read the full README on GitHub.

Commands API Contract Review provides

Slash commands named in this skill’s SKILL.md, listed in the order they first appear.

/users
/user

Frequently asked about API Contract Review

What else does decebals publish alongside API Contract Review?
API Contract Review is one of 18 skills that DirSkills catalogs from decebals/claude-code-java, the repository it ships in. Its siblings there include Architecture Review, Changelog Generator and Clean Code. Each one is a separate skill with its own page in this directory, installs the same way API Contract Review does, and is maintained by decebals in that same repository. The rest of the collection is listed on the decebals/claude-code-java page.
How does API Contract Review compare to other Quality skills?
API Contract Review ranks #1031 by stars among the 1354 Quality skills in this catalog. The most-starred ones next to it are Benchmark, Benchmark Optimization Loop and API Design Patterns. DirSkills ranks by the star count of the repository each skill ships in, so that order reflects how popular those repositories are rather than any review of API Contract Review against them. Open each page to compare what they document and how they install.