---
title: "Review REST API designs before implementation for versioning, security, and contract clarity"
description: "Review an API design, endpoint set, or OpenAPI spec before implementation and return prioritized findings on design quality, security, resilience, and missing contract decisions."
verification: "security_reviewed"
source: "https://github.com/psenger/ai-agent-skills/tree/main/skills/review-api-design"
author: "Philip A Senger"
publisher_type: "individual"
category:
  - "Code Quality & Review"
framework:
  - "Claude Code"
---

# Review REST API designs before implementation for versioning, security, and contract clarity

Review an API design, endpoint set, or OpenAPI spec before implementation and return prioritized findings on design quality, security, resilience, and missing contract decisions.

## Prerequisites

Claude Code skill runtime

## Installation

Choose whichever fits your setup:

1. Copy this skill folder into your local skills directory.
2. Clone the repo and symlink or copy the skill into your agent workspace.
3. Add the repo as a git submodule if you manage shared skills centrally.
4. Install it through your internal provisioning or packaging workflow.
5. Download the folder directly from GitHub and place it in your skills collection.

Install command or upstream instructions:

```
Install as a Claude Code-compatible skill from the skill folder and invoke it when reviewing an API design, endpoint list, or OpenAPI spec.
```

## Documentation

- https://github.com/psenger/Best-Practices-For-Rest-API

## Source

- [Agent Skill Exchange](https://agentskillexchange.com/skills/review-rest-api-designs-before-implementation-for-versioning-security-and-contract-clarity/)