Automate REST/JSON API design with a 5-tier parameter model and pre-commit validation.
npx skills add https://github.com/yaleh/meta-cc --skill api-design-yaleh
Please help me install this Agent Skill. Skill: API Design Source: https://github.com/yaleh/meta-cc/tree/main/.claude/skills/api-design Command: npx skills add https://github.com/yaleh/meta-cc --skill api-design-yaleh
This Skill provides a methodical approach to API design, improving consistency, safety, and maintainability across endpoints using a 6-pattern framework, audit-first validation, and example-driven guidelines.
Use this Skill to outline a new API's structure and validation rules, then apply the patterns to a 6-endpoint example.
High-intent search queries and answers about installing and using this skill.
API design uses a 5-tier parameter system to categorize endpoint inputs deterministically, ensuring consistent validation rules across all endpoints. This framework standardizes how required, optional, and derived parameters are validated and documented throughout your REST API.
Pre-commit style checks enforce validation and documentation standards at code review time. Audit-first workflows catch inconsistencies early, preventing breaking changes and ensuring endpoints meet the 6-pattern framework before they reach production.
Safe refactoring guidance within the 6-pattern framework shows how to evolve endpoints incrementally. The Skill provides techniques to change validation rules and structure while maintaining backward compatibility with existing clients.
Yes. The 5-tier parameter model and 6-pattern framework scale across multi-endpoint redesigns. Apply deterministic patterns consistently to enforce uniform validation, documentation, and structure across your entire REST API surface.
Example-driven documentation scaffolding generates specifications directly from your parameter definitions and validation patterns. This ties documentation to actual endpoint behavior, keeping specs in sync with code.
The framework applies to REST and JSON APIs. The 5-tier parameter system and validation patterns work with any endpoint structure that accepts and validates parameters, not just REST conventions.
taichuyDefine API contracts as the single source of truth for oRPC layers.
mikopbxExtract and analyze OpenAPI 3.1.0 specifications to validate endpoints and generate tests.
giuseppe-trisciuoglioGenerate OpenAPI 3.0 documentation and Swagger UI for Spring Boot 3.x applications.
erichowensDesign and validate REST, GraphQL, and gRPC API contracts and architectures.
