skills.rest
buiphucminhtam
buiphucminhtamCOMMUNITY
Explore all skills by this author →
GitHub

api-designer

Design REST, GraphQL, gRPC, and AsyncAPI APIs with OpenAPI/AsyncAPI spec generation.

47|11|Updated Mar 6, 2026
Search Tags:#versioning#documentation#openapi#governance#error-handling#pagination#api-design
One-click install
npx skills add https://github.com/buiphucminhtam/forgewright --skill api-designer-buiphucminhtam
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: api-designer
Source: https://github.com/buiphucminhtam/forgewright/tree/main/skills/api-designer
Command: npx skills add https://github.com/buiphucminhtam/forgewright --skill api-designer-buiphucminhtam

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Designs production-grade APIs and governance patterns across REST, GraphQL, gRPC, and AsyncAPI to standardize interfaces, improve consistency, and reduce costly regressions.

Core Features & Use Cases

  • Production-grade API design pipeline spanning domain modeling, resource design, endpoint specification, error taxonomy, and governance.
  • OpenAPI/AsyncAPI spec generation with pagination, versioning, and standardized error handling.
  • Comprehensive API style guide and deprecation governance to ensure consistent consumption patterns.

Quick Start

Create an OpenAPI document for a new microservice following the project conventions and governance rules.

Frequently Asked Questions about api-designer

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

FAQPage Schema
How do I design production-ready APIs across REST, GraphQL, and gRPC?▼

API design for REST, GraphQL, gRPC, and AsyncAPI requires production-grade pipelines spanning domain modeling, resource design, endpoint specification, error taxonomy, and governance to standardize interfaces and reduce costly regressions.

How do I generate an OpenAPI document for a new microservice?▼

Generating an OpenAPI document involves creating specifications for new microservices that follow project conventions and governance rules, incorporating standardized pagination, versioning, and consistent error handling across services.

What is the best way to standardize API versioning and error handling?▼

Standardizing API versioning and error handling involves applying standardized policies and a comprehensive API style guide to ensure consistent consumption patterns and deprecation governance across enterprise API programs.

Can I use AsyncAPI spec generation for event-driven architecture?▼

AsyncAPI spec generation supports event-driven architecture by providing production-grade design and governance patterns, targeting scalable design and standardized documentation for asynchronous services.

How do I create an API style guide for enterprise governance?▼

Creating an API style guide for enterprise governance involves defining per-endpoint guidelines, pagination strategies, versioning policies, and deprecation governance to ensure consistent consumption patterns across all services.

Related Skills

Explore More Software Engineering Skills→
Prathmesh2000Prathmesh2000
1

contract-designer

Define service contracts with OpenAPI and AsyncAPI before implementation.

Community
Advanced
ginkidaginkida
20

openapi-expert

Design, validate, and generate code from OpenAPI 3.x specifications.

Community
Advanced
AgentSecOpsAgentSecOps
183

api-spectral

Lint OpenAPI/AsyncAPI definitions with Spectral to enforce security and governance rules.

Official
Advanced
erichowenserichowens
181

api-architect

Design and validate REST, GraphQL, and gRPC API contracts and architectures.

Community
Advanced