create-api-design

Design REST and GraphQL API contracts from feature specifications.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Designing scalable APIs from feature specs to reduce ambiguity and rework, ensuring consistent API contracts across teams.

Core Features & Use Cases

  • Auto-generates endpoints and schemas from feature descriptions to align with existing project conventions.
  • Creates API contracts including request/response schemas, error models, and pagination strategies.
  • Use Case: When a new feature emerges, design the complete API surface without manual back-and-forth.

Quick Start

Provide a complete API design for the given feature spec and generate the full design document.

Frequently Asked Questions about create-api-design

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

FAQPage Schema
How do I design production-ready API contracts from feature specifications?

To design API contracts from feature specs, generate endpoint and schema definitions that cover request/response models, error contracts, pagination, and authentication patterns. This ensures consistent naming conventions and alignment with existing codebase conventions.

What is the best way to create REST and GraphQL endpoints from user stories?

Creating REST and GraphQL endpoints from user stories requires translating feature requirements into structured schema definitions and endpoint paths. This approach guides schema creation while satisfying requirements for versioning, authentication patterns, and consistent naming conventions.

Can I auto-generate API schemas and error models without manual back-and-forth?

Yes, you can auto-generate API schemas and error models from feature descriptions to align with existing project conventions. This process creates complete API contracts including request/response schemas, error models, and pagination strategies without manual back-and-forth.

Does this API design approach support both REST and GraphQL schema definitions?

Yes, this API design approach supports both REST and GraphQL API design tasks across modules. It guides endpoint and schema creation from user stories while applying consistent naming conventions, schema definitions, and versioning strategies.

How do I ensure consistent API naming conventions and pagination strategies across teams?

Ensuring consistent API naming conventions and pagination strategies across teams requires defining standardized API contracts from feature specifications. This reduces ambiguity and rework by standardizing schema definitions, error contracts, and authentication patterns.

What limitations exist when generating API contracts from feature specs for existing codebases?

When generating API contracts from feature specs for existing codebases, limitations depend on alignment with existing codebase conventions. The design process requires complete feature specifications to accurately generate endpoint schemas, error models, and authentication patterns without ambiguity.