api-design

Design RESTful API contracts with OpenAPI specifications and ScalarDB 2PC.

6|Updated Feb 18, 2026
One-click install
npx skills add https://github.com/wfukatsu/coding-agent-for-scalardb --skill api-design-wfukatsu
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: api-design
Source: https://github.com/wfukatsu/coding-agent-for-scalardb/tree/main/skills/api-design
Command: npx skills add https://github.com/wfukatsu/coding-agent-for-scalardb --skill api-design-wfukatsu

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

RESTful API design and governance for scalable microservices, ensuring clear contracts and predictable client interactions.

Core Features & Use Cases

  • Endpoint design with consistent URL structures and HTTP methods.
  • Request/response specifications, DTO validation, and error mappings including ScalarDB transaction exceptions.
  • OpenAPI/Swagger documentation generation and CDC metadata filtering to hide internal fields.
  • Service-to-service communication patterns using ScalarDB 2PC across microservices.

Quick Start

To begin, provide your domain and constraints and this skill will generate a complete RESTful API design.

Frequently Asked Questions about api-design

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

FAQPage Schema
How do I design REST APIs with clear contracts for microservices?

To design REST APIs with clear contracts for microservices, define consistent endpoint URL structures, validate data transfer objects, and generate OpenAPI specifications to enforce predictable client interactions and standardized error responses.

How does ScalarDB 2PC handle inter-service communication in distributed transactions?

ScalarDB 2PC handles inter-service communication by enforcing transaction ID propagation across microservices, ensuring data consistency and mapping ScalarDB transaction exceptions to standardized REST API error responses during distributed transactions.

What's the best way to generate OpenAPI specifications and filter CDC metadata?

The best way to generate OpenAPI specifications and filter CDC metadata is to define request and response DTOs, then apply CDC metadata filtering rules to hide internal fields from the exposed API contract documentation.

How do I standardize error handling and input validation for RESTful APIs?

Standardize error handling and input validation for RESTful APIs by enforcing strict DTO validation rules at the endpoint level and mapping internal transaction exceptions into predictable, standardized HTTP error responses.

Do I need to provide domain constraints to generate a complete RESTful API design?

Yes, you need to provide your specific domain and constraints as input. The Skill uses these parameters to generate a complete RESTful API design, including endpoint structures, DTOs, and OpenAPI documentation.

When should I use CDC metadata filtering in API endpoint design?

Use CDC metadata filtering in API endpoint design when exposing microservice data streams to external clients, ensuring internal system fields are hidden to maintain a clean and secure REST API contract.