api-validator

Validate REST API routes, naming, HTTP methods, pagination, and Swagger documentation.

5|1|Updated Oct 29, 2025
One-click install
npx skills add https://github.com/moasadi/ddd-bun-api-boilerplate --skill api-validator
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: api-validator
Source: https://github.com/moasadi/ddd-bun-api-boilerplate/tree/main/.claude/skills/api-validator
Command: npx skills add https://github.com/moasadi/ddd-bun-api-boilerplate --skill api-validator

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps teams enforce REST API design and documentation standards, reducing review time and deployment risks by validating versioning, naming, HTTP methods, status codes, pagination, and Swagger documentation.

Core Features & Use Cases

  • Versioning rules: Enforce the /v1/ prefix on all routes to maintain stable contracts.
  • Resource Naming: Validate plural nouns, lowercase-with-hyphens, and no verbs in resource names.
  • HTTP Methods & Status Codes: Ensure endpoints use the correct methods and status codes (e.g., 201 for create, 200/204 for reads/deletes).
  • Pagination: Require list endpoints to support pagination DTOs and structured responses.
  • Swagger/OpenAPI Docs: Verify full OpenAPI documentation coverage for all endpoints.
  • Error Mapping: Check consistent error status usage and descriptive messages.
  • Use Case Scenarios: Useful during pre-deployment checks, API design reviews, and documentation completeness verification.

Quick Start

  • Run the API validator against your project to check /v1/ routes, naming, HTTP methods, pagination, and Swagger docs.
  • Example input: "Validate the User API endpoints"

Frequently Asked Questions about api-validator

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I validate REST API design standards across my endpoints?

REST API validation checks versioning, resource naming, HTTP methods, status codes, pagination, and Swagger documentation compliance. Run the validator against your project to identify deviations from standards like /v1/ prefixes, plural lowercase resource names, and correct method-status mappings, catching issues before deployment.

What REST API naming conventions should I enforce?

Enforce plural nouns, lowercase-with-hyphens format, and exclude verbs from resource names. The validator checks that your endpoints follow these conventions consistently, ensuring predictable, readable API contracts across your microservices and monoliths.

Can I validate Swagger and OpenAPI documentation completeness?

Yes. The validator verifies full OpenAPI documentation coverage for all endpoints, ensuring every route has complete Swagger specs. This catches undocumented endpoints during design reviews and pre-deployment audits.

How do I enforce HTTP method and status code correctness?

The validator checks that endpoints use correct HTTP methods with matching status codes—for example, POST returns 201, GET returns 200, DELETE returns 204. This prevents common contract violations and improves API predictability.

Why should list endpoints require pagination DTOs?

Pagination DTOs structure large responses, improving performance and usability. The validator requires list endpoints to support pagination and structured responses, preventing unbounded result sets and ensuring scalable API design.

When should I run API validation checks?

Run validation during API design reviews, pre-deployment checks, and documentation audits. Early validation reduces review time, catches standards drift, and prevents deployment risks by enforcing versioning, naming, methods, and documentation rules before code ships.