api-design

Create HTTP API contracts with REST and GraphQL paradigms.

Updated Jul 7, 2026
One-click install
npx skills add https://github.com/voidrot/agents --skill api-design-voidrot
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: api-design
Source: https://github.com/voidrot/agents/tree/main/skills/meta/api-design
Command: npx skills add https://github.com/voidrot/agents --skill api-design-voidrot

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires pypdf, pdfplumber, pdf2image, and includes scripts (resource) and references (resource) and assets (resource) components.

What problem does it solve?

This Skill simplifies the process of designing and reviewing HTTP API contracts, streamlining the creation of resourceful, efficient, and maintainable APIs.

Core Features & Use Cases

  • API Design Patterns: Utilize predefined patterns for resources, methods, status codes, pagination, filtering, versioning, and OpenAPI behavior.
  • Scope Boundaries: Clearly define the boundaries between client-side API contracts, server internals, error handling, and language-specific implementation.
  • Workflow Guidelines: Follow step-by-step guidelines for audience identification, method selection, validation, error handling, and documentation.

Quick Start

Use the api-design skill to create a new API endpoint for the 'users' resource.

Frequently Asked Questions about api-design

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

FAQPage Schema
How do I design and review HTTP API contracts for REST and GraphQL?

To design HTTP API contracts, define resource models, HTTP semantics, and validation rules. The skill facilitates creating APIs by handling REST and GraphQL paradigms, authorization, rate limiting, and versioning while adhering to OpenAPI standards.

What is the best way to structure REST API resources and select HTTP methods?

The best way to structure REST API resources is by following predefined patterns for methods, status codes, and pagination. You can use workflow guidelines for audience identification and method selection to ensure proper HTTP semantics and OpenAPI behavior.

Does this API design approach support OpenAPI and Swagger standards?

Yes, this API design approach supports OpenAPI and Swagger standards. It requires awareness of these standards to facilitate the creation of resourceful contracts and utilizes scripts for automated design validation and documentation generation.

Can I automate API contract validation and documentation generation with Python?

You can automate API contract validation and documentation generation using Python scripts. The skill utilizes Python scripts to validate HTTP semantics, resource modeling, and authorization rules defined within your API contracts.

How do I handle error handling and API versioning boundaries in HTTP APIs?

To handle error handling and API versioning boundaries, clearly define the scope boundaries between client-side API contracts and server internals. The skill provides guidelines for validation, error handling, and documentation to maintain efficient APIs.