What is the 5-tier parameter system?

It is a deterministic decision tree that categorizes parameters into Required, Filtering, Range, Output Control, and Standard tiers to ensure unambiguous API definitions.

How does audit-first refactoring save time?

By assessing compliance before execution, it helps identify already-compliant targets, avoiding unnecessary work—empirically shown to gain 37.5% in efficiency.

Is this skill language-agnostic?

Yes, it focuses on architectural decision-making and logic patterns rather than language-specific syntax, making it applicable to Go, Python, TypeScript, and more.

Does this work for non-JSON APIs?

While the core methodology has high transferability (82.5%), some specific patterns like safe refactoring assume JSON-based property characteristics.

API Design Methodology

Name: API Design Methodology
Author: yaleh

byyaleh

•

API 개발

Implements a systematic API design methodology with validated patterns and automated quality enforcement for consistent, evolvable backend services.

This skill provides a rigorous framework for Claude to design and refactor APIs using six validated patterns, including a deterministic five-tier parameter system and audit-first refactoring strategies. By focusing on empirical evidence and high transferability, it enables the creation of JSON-based APIs that are consistent, backward-compatible, and well-documented. It is particularly effective for teams looking to standardize conventions across multiple endpoints while automating quality gates to ensure long-term architectural integrity.

주요 기능

01Example-driven documentation and specification templates

02Deterministic 5-tier parameter categorization system

03Audit-first refactoring to minimize unnecessary code changes

0415 GitHub stars

05Automated consistency validation and quality gates

06Safe schema evolution leveraging JSON property ordering

사용 사례

01Designing new RESTful APIs with systematic parameter organization

02Refactoring legacy endpoints to improve consistency without breaking clients

03Standardizing API conventions across large-scale microservice architectures

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add yaleh/meta-cc api-design

For use in Claude.ai and ChatGPT

Download Skill