api-design

Automate REST/GraphQL API design and review with OpenAPI documentation.

8|Updated Feb 8, 2026
One-click install
npx skills add https://github.com/kensaurus/cursor-kenji --skill api-design-kensaurus
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: api-design
Source: https://github.com/kensaurus/cursor-kenji/tree/main/skills/api-design
Command: npx skills add https://github.com/kensaurus/cursor-kenji --skill api-design-kensaurus

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Designing and reviewing REST/GraphQL APIs to enforce consistency, quality, and scalable contracts across teams.

Core Features & Use Cases

  • RESTful resource design guidelines including naming, nesting, and versioning
  • GraphQL contract design, data shaping, and schema evolution
  • Server Actions vs Route Handlers patterns and effective error handling
  • OpenAPI/OpenAPI-like documentation templates and review checklists
  • Use case: standardize endpoint design across services to improve maintainability and developer experience

Quick Start

Create a RESTful endpoint for listing resources under /api/v1/resources using consistent naming, versioning, and error handling.

Frequently Asked Questions about api-design

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

FAQPage Schema
How do I design REST API endpoints with consistent naming and versioning?

To design REST API endpoints with consistent naming and versioning, apply automated resource design guidelines covering endpoint naming, nesting, and route versioning. This enforces clear request and response schemas, ensuring scalable contracts and improved maintainability across services.

What is the best way to handle errors in GraphQL and REST APIs?

The best way to handle errors in GraphQL and REST APIs is to apply standardized server actions and route handler patterns. This enforces effective error handling and consistent data contracts, preventing ambiguous failures and improving overall developer experience.

Can I use this to generate OpenAPI documentation for my API?

Yes, you can generate OpenAPI-style documentation for your API. The skill provides documentation templates and review checklists that automate the creation of clear data contracts and versioned documentation for both REST and GraphQL implementations.

How do I evolve a GraphQL schema without breaking existing contracts?

To evolve a GraphQL schema without breaking existing contracts, apply automated contract design and data shaping patterns. This enforces schema evolution rules and maintains consistency across data contracts, ensuring backward compatibility during API updates.

When should I use server actions instead of route handlers for my API?

You should use server actions instead of route handlers when your API architecture requires specific data mutation patterns. The skill provides comparative patterns for both approaches, enforcing effective error handling and clear data contracts based on your specific endpoint requirements.