api-design-audit

Audit REST and GraphQL API designs for contracts, error handling, and documentation.

Updated Mar 30, 2026
One-click install
npx skills add https://github.com/radenadri/skills-alena --skill api-design-audit-radenadri
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: api-design-audit
Source: https://github.com/radenadri/skills-alena/tree/main/skills/api-design-audit
Command: npx skills add https://github.com/radenadri/skills-alena --skill api-design-audit-radenadri

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Streamlines API design quality assurance by enforcing defined contracts, consistent error handling, and up-to-date documentation to prevent breaking changes and integration issues.

Core Features & Use Cases

  • Design and review REST, GraphQL, RPC, and WebSocket APIs to ensure each endpoint has a clear contract, proper error handling, and consistent response formats.
  • Audit existing APIs for versioning strategy, pagination, and documentation adequacy, surfacing risks and recommended migrations.
  • Guide teams through a structured audit process from endpoint design through error handling and versioning, enabling safer API evolution.

Quick Start

Run an API design audit on your REST or GraphQL services to verify contracts, errors, and documentation across all endpoints.

Frequently Asked Questions about api-design-audit

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

FAQPage Schema
How do I audit my REST API design for consistent contracts and error handling?

An API design audit analyzes endpoints to ensure contracts, error response schemas, and documentation are consistently defined across all endpoints. It validates REST conventions, pagination, and versioning standards to prevent breaking changes and integration issues during API evolution.

What is the best way to review GraphQL API documentation and versioning strategy?

Reviewing GraphQL API documentation and versioning involves auditing existing endpoints for adequate documentation, consistent response formats, and proper error handling. This surfaces migration risks and ensures safer API evolution by validating defined contracts across the service.

Can I use this API audit process for both WebSocket and RPC interfaces?

Yes, the API audit process supports reviewing REST, GraphQL, RPC, and WebSocket APIs. It guides teams through a structured audit to verify that each endpoint type has clear contracts, proper error handling, and consistent response formats for safer integration.

How do I validate API pagination and versioning standards across existing endpoints?

Validating API pagination and versioning standards requires auditing existing endpoints to surface risks and recommended migrations. The audit checks that versioning strategies and pagination conventions are consistently applied and adequately documented across the API.

Why does my API integration keep breaking due to inconsistent error response schemas?

API integrations break when error response schemas and contracts are not consistently defined across endpoints. An API design audit enforces consistent error handling and up-to-date documentation to surface these risks, enabling safer API evolution and stable integrations.