# Rest API Design

> Comprehensive, technology-agnostic principles and best practices for designing REST APIs. Use this skill whenever designing new REST endpoints, reviewing API contracts, planning versioning strategy, defining error formats, or establishing API standards for a project. Also trigger when discussing backward compatibility, API security, pagination, rate limiting, authentication schemes, or OpenAPI spec authoring — even if the user doesn't say "REST API" explicitly. This skill is the authoritative guide for all API design decisions.

## Facts
- Page: https://tashan.sh/capability/skill-virajp-rest-api-design
- tashan id: skill:virajp/rest-api-design
- Source: https://github.com/virajp/ai-plugins
- Type: skill
- Category: other
- tashan score: not scored (catalogued only — too little public evidence)
- Adoption: 9.0
- Upkeep: 81.0
- Freshness: 98.0
- Evidence coverage: 84% of the inputs this score can use
- Health: active
- Instruction depth: not yet graded
- License: MIT
- Official: no

## Install

```sh
cp -r rest-api-design ~/.claude/skills/
```

## Security audit
Not scanned. We audit npm-published capabilities; this one has no npm package we can resolve, or has not reached the queue. This is not a clean bill of health.

---
Measured 2026-08-15 by tashan (https://tashan.sh) from public evidence. Scorer s5.