Review Rest Api Designs Before Implementation For Versioning Security And Contract Clarity

---
name: "Review REST API designs before implementation for versioning, security, and contract clarity"
slug: "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

Requirements and caveats from upstream:
- | Language | TypeScript, Python, Go, Java, Rust, Ruby, C#, and more |
- deploy/ — CI/CD pipelines, Docker, deploy scripts
- **Skills 2.0:** allowed-tools: Read Grep Glob Write Bash(git *) — argument-hint: [path/to/scope] — auto-invokes on trigger phrases; requires git for churn analysis

Basic usage or getting-started notes:
- ├── article-example.md Article with callouts + code blocks
- ├── meeting-brainstorm-example.md Brainstorming session
- └── transcript-example.md Article with transcript appendix

- Source: https://github.com/psenger/ai-agent-skills/tree/main/skills/review-api-design
- Extracted from upstream docs: https://raw.githubusercontent.com/psenger/ai-agent-skills/HEAD/README.md

## 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/)