api-design

Provide guidelines for designing RESTful APIs with resource naming and HTTP methods.

Updated Feb 13, 2026
One-click install
npx skills add https://github.com/LiamVDB1/opencode-config --skill api-design-liamvdb1
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: api-design
Source: https://github.com/LiamVDB1/opencode-config/tree/main/skills/api-design
Command: npx skills add https://github.com/LiamVDB1/opencode-config --skill api-design-liamvdb1

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill provides a comprehensive guide to designing production-ready REST APIs, ensuring consistency, developer-friendliness, and maintainability.

Core Features & Use Cases

  • Resource Naming & Structure: Establishes clear conventions for URLs and resource representation.
  • HTTP Methods & Status Codes: Details the semantic use of HTTP verbs and status codes for effective communication.
  • Response Formatting: Defines patterns for success, collection, and error responses, including pagination.
  • Versioning & Rate Limiting: Outlines strategies for managing API evolution and preventing abuse.
  • Use Case: When designing a new set of API endpoints for a user management system, use this Skill to ensure all endpoints follow best practices for resource naming, request/response formats, and error handling.

Quick Start

Use the api-design skill to review the resource naming conventions for a new user endpoint.

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 requires clear conventions for URLs and resource representation to ensure consistency. Establishing standardized paths for collections and items provides a maintainable structure for web services.

How do I use HTTP methods and status codes for effective API communication?

Effective API communication uses semantic HTTP methods and status codes to indicate request outcomes. Applying the correct HTTP verbs and response codes ensures clear API contracts and improves the developer experience.

What is the best way to format API responses for pagination and error handling?

Formatting API responses involves defining consistent patterns for success, collection, and error outputs. Including pagination, filtering, and sorting parameters within collection responses ensures scalable data retrieval.

How do I implement API versioning and rate limiting for production web services?

API versioning and rate limiting manage API evolution and prevent abuse in production environments. Outlining strategies for version transitions and request throttling maintains robust and scalable backend services.

Does REST API design cover authentication and authorization mechanisms?

REST API design covers authentication and authorization mechanisms to secure web services. Enforcing standards for access control ensures that API endpoints validate user permissions and protect sensitive resources.