API Contract Review

Review ASP.NET Core Web API contracts for HTTP semantics, versioning, backward compatibility, and response consistency. Use when the user asks to review an API, check endpoints, validate REST behavior, or before releasing contract changes.

Install

skills CLI (Claude Code, Cursor, Codex and more)
npx skills add DIL8654/claude-code-dotnet-template --skill api-contract-review
Manual install
git clone --depth 1 https://github.com/DIL8654/claude-code-dotnet-template.git /tmp/claude-code-dotnet-template
mkdir -p ~/.claude/skills
cp -r /tmp/claude-code-dotnet-template/.claude/skills/api-contract-review ~/.claude/skills/api-contract-review

Personal skills live in ~/.claude/skills. Use .claude/skills in a project folder to share a skill with your team.

From the SKILL.md

# API Contract Review Skill

Audit ASP.NET Core Web API design for correctness, consistency, and compatibility.

## When to Use
- User asks "review this API" or "check these endpoints"
- Before releasing API changes
- Reviewing pull requests with controller, endpoint, or contract changes
- Checking backward compatibility for public APIs

---

## Quick Reference: Common Issues

| Issue | Symptom | Impact |
|-------|---------|--------|
| Wrong HTTP verb | `POST` used for idempotent retrieval or update | Confusing semantics, caching issues, harder clients |
| Missing versioning | `/api/users` instead of `/api/v1/users` | Breaking changes affect all consumers |
| Entity leak | EF Core entity returned directly from controller | Exposes internals, persistence shape, concurrency fields |
| `200 OK` with error payload | Error body returned with HTTP 200 | Breaks client error handling |
| Inconsistent route naming | `/getUsers` vs `/users` | Makes APIs harder to learn and maintain |

---

## HTTP Verb Semantics

### Verb Selection Guide

| Verb | Use For | Idempotent | Safe | Request Body |
|------|---------|------------|------|--------------|
| GET | Retrieve resource | Yes | Yes | No |
| POST | Create resource or invoke non-idempotent action | No | No | Yes |
| PUT | Replace resource | Yes | No | Yes |
| PATCH | Partial update | Usually | No | Yes |
| DELETE | Remove resource | Yes | No | Optional |

### Common Mistakes
Read the full skill on GitHub

Details

Skill name
api-contract-review
Path
.claude/skills/api-contract-review/SKILL.md
License
GPL-3.0
Repo updated
24 March 2026

FAQ

What does the API Contract Review skill do?

Review ASP.NET Core Web API contracts for HTTP semantics, versioning, backward compatibility, and response consistency. Use when the user asks to review an API, check endpoints, validate REST behavior, or before releasing contract changes.

How do I install the API Contract Review skill?

skills CLI (Claude Code, Cursor, Codex and more): npx skills add DIL8654/claude-code-dotnet-template --skill api-contract-review. Skills go in ~/.claude/skills (personal) or .claude/skills (project), and Claude loads them automatically when a task matches the description.

Is API Contract Review popular?

It lives in DIL8654/claude-code-dotnet-template, which has 9 GitHub stars and 5 forks.

Related skills

Architecture Review

9

DIL8654/claude-code-dotnet-template

Review Clean Architecture boundaries, dependency direction, layering decisions, and abstraction quality in .NET solutions. Use when evaluating project structure, new dependencies, service boundaries, or architectural drift.

Software Development

Azure Integration

9

DIL8654/claude-code-dotnet-template

Add Azure services to .NET applications with Managed Identity, typed options, infrastructure isolation, and production-safe configuration. Use when wiring Key Vault, App Configuration, Storage, Service Bus, or Azure Identity patterns.

DevOps & Cloud

Clean Code

9

DIL8654/claude-code-dotnet-template

Prefer small, explicit, readable C# code and pragmatic refactoring. Use for cleanup, maintainability reviews, naming improvements, duplication removal, and simplifying overly complex implementations.

Software Development

Israeli Customer Support Automator

9

skills-il/communication

Deploy and configure customer support automation for Israeli businesses. Categorizes Hebrew support tickets, manages complaints per Consumer Protection Law 1981 (14-day returns, cooling-off periods), configures SLA with Israeli hours (Sunday-Thursday), and generates Hebrew canned responses for multi-channel support. Use when user asks to "set up customer support", "automate ticket routing", "sherut lakokhot", "handle complaints", or configure helpdesk for Israeli companies. Integrates with Monday.com and Priority ERP. Do NOT use for building chatbots (use hebrew-chatbot-builder), WhatsApp API

Marketing, Sales & Business

Conversion Retraction

6

treboutat/google-ads-conversion-retraction-system

Correct Google Ads conversions that no longer meet the definition the business counts, using CRM evidence. Use when a user says "retract bad leads", "conversion retraction", "remove spam conversions", "restate conversion value", "partial refund adjustment", or wants disqualified leads corrected in Google Ads. Defines what each conversion action should count, maps CRM dispositions to keep / report deeper / restate / retract / hold, checks each original conversion can be adjusted (identifier, action type, 54-day window), builds a fixed reviewed batch in Google's adjustment format, and reconciles

Marketing, Sales & Business

Israeli Hr Recruitment Automator

9

skills-il/communication

Not legal advice. Employer-side hiring automation for Israeli companies. Drafts Hebrew job descriptions against the published requirements of the Equal Employment Opportunities Law 1988, posts to Israeli job boards (AllJobs, Drushim, JobMaster, LinkedIn Israel), screens resumes with Israeli context (military service, academic institutions, tech bootcamps), schedules interviews around Israeli holidays and Shabbat, and generates offer letters with mandatory Israeli employment clauses. Use when user asks to "write a job description", "post a job in Israel", "screen Israeli resumes", "pirsum misra

Marketing, Sales & Business

Browse the most popular Claude skills, all marketing, sales & business skills, or write your own with the skills generator.