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.

主な機能

Example-driven documentation and specification templates
Deterministic 5-tier parameter categorization system
Audit-first refactoring to minimize unnecessary code changes
15 GitHub stars
Automated consistency validation and quality gates
Safe schema evolution leveraging JSON property ordering

ユースケース

Designing new RESTful APIs with systematic parameter organization
Refactoring legacy endpoints to improve consistency without breaking clients
Standardizing API conventions across large-scale microservice architectures

概要

主な機能

Example-driven documentation and specification templates
Deterministic 5-tier parameter categorization system
Audit-first refactoring to minimize unnecessary code changes
15 GitHub stars
Automated consistency validation and quality gates
Safe schema evolution leveraging JSON property ordering

ユースケース

Designing new RESTful APIs with systematic parameter organization
Refactoring legacy endpoints to improve consistency without breaking clients
Standardizing API conventions across large-scale microservice architectures