api-design

Design and review REST APIs with resource naming, URL structure, HTTP methods, and status codes.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Designing, implementing, and reviewing REST APIs to ensure consistency, correctness, and maintainability across endpoints, contracts, and versioning.

Core Features & Use Cases

  • Resource naming conventions, URL structures, and HTTP method semantics
  • Pagination, filtering, sorting, and search patterns
  • Authentication, authorization, and rate-limiting guidelines
  • Versioning strategies and deprecation practices

Quick Start

Review a draft REST API and apply the patterns to align endpoints, responses, and error handling.

Frequently Asked Questions about api-design

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

FAQPage Schema
What are the best practices for REST API resource naming and URL structure?

REST API resource naming and URL structure should use nouns for endpoints and standard HTTP methods for actions. This ensures consistency and correctness across API contracts by applying structured guidance and example patterns to resource design.

How do I design pagination, filtering, and sorting patterns for REST endpoints?

Design pagination, filtering, and sorting patterns for REST endpoints by applying best-practice structures to query parameters. This enables efficient data retrieval and consistent client interactions across large collections of resources.

What HTTP status codes should I use for successful and error responses in API design?

Use HTTP status codes that accurately reflect the outcome of API requests, such as 200 for success or 4xx for client errors. Correct status code usage enforces clear contracts and robust error handling across endpoints.

How do I implement versioning strategies and deprecation practices for REST APIs?

Implement REST API versioning strategies and deprecation practices by applying structured patterns to URLs or headers. This maintains backward compatibility and governes lifecycle changes across real-world project endpoints.

What patterns should I follow for API authentication, authorization, and rate limiting?

Follow guidelines for API authentication, authorization, and rate limiting to secure REST endpoints. Applying these patterns protects resources from unauthorized access and manages traffic load effectively.

Can I use this to review a draft REST API and validate endpoint contracts?

Yes, you can review a draft REST API to validate endpoint contracts and align responses. The skill applies best-practice patterns to assess code changes and validate API design proposals for consistency.