Design RESTful, GraphQL, and gRPC APIs with OpenAPI and Protobuf definitions.
npx skills add https://github.com/nahisaho/musubi --skill api-designer-nahisaho
Please help me install this Agent Skill. Skill: api-designer Source: https://github.com/nahisaho/musubi/tree/main/.claude/skills/api-designer Command: npx skills add https://github.com/nahisaho/musubi --skill api-designer-nahisaho
What problem does it solve? This Skill simplifies the complex task of designing well-structured, consistent, and documented APIs. It prevents common issues like inconsistent endpoints, poor error handling, and lack of documentation, which hinder developer experience and integration.
Core Features & Use Cases:
/users and /users/{id}, specify HTTP methods (GET, POST, PATCH, DELETE), generate a complete OpenAPI 3.x specification, and outline authentication using JWT.Quick Start: Design a REST API for user management. I need endpoints for creating, reading, updating, and deleting users.
High-intent search queries and answers about installing and using this skill.
REST API design involves defining resources, HTTP methods (GET, POST, PATCH, DELETE), and status codes, then generating OpenAPI specifications to document endpoints, parameters, and schemas. This ensures consistency across your API and improves developer experience.
OpenAPI specifications are YAML or JSON documents that formally describe your API's endpoints, request/response schemas, and authentication. Generating a complete OpenAPI 3.x spec ensures API contracts are machine-readable and enables automatic documentation and client generation.
API authentication design includes choosing mechanisms like OAuth 2.0, JWT, or API keys based on your security requirements. Proper authentication prevents unauthorized access and establishes clear token validation and refresh strategies.
This Skill covers REST, GraphQL, and gRPC API design. Each paradigm has distinct schema definitions—OpenAPI for REST, GraphQL schema language for GraphQL, and Protobuf for gRPC—with corresponding documentation and governance approaches.
API versioning strategies (URL paths, headers, content negotiation) and error handling patterns (consistent status codes, error response schemas) prevent breaking changes and improve client reliability. Clear guidelines establish how your API evolves without disrupting existing consumers.
OpenAPI specifications are machine-readable contracts that enable automated documentation, SDK generation, and testing tools beyond human-readable docs. They prevent inconsistencies between documentation and actual implementation.
wfukatsuExtract entities, relationships, and domain rules from codebase data models.
manastalukdarGenerate API mock servers from OpenAPI specs, GraphQL schemas, or code.
weirdgmeAutomate API design and governance with REST, GraphQL, and gRPC best practices.
eleva-labsGenerate backend API scaffolding from OpenAPI, Swagger, or GraphQL specifications.