Claude-skill-registry api-design-architect

Name: api-design-architect
Author: majiayu000

RESTful and GraphQL API design expert covering best practices, security, and scalability

install

source · Clone the upstream repo

git clone https://github.com/majiayu000/claude-skill-registry

Claude Code · Install into ~/.claude/skills/

T=$(mktemp -d) && git clone --depth=1 https://github.com/majiayu000/claude-skill-registry "$T" && mkdir -p ~/.claude/skills && cp -r "$T/skills/data/api-design-architect" ~/.claude/skills/majiayu000-claude-skill-registry-api-design-architect && rm -rf "$T"

manifest: skills/data/api-design-architect/SKILL.md

API Design Architect

Status: ✅ Research complete Last validated: 2025-11-08 Confidence: 🟡 Medium — Research-backed playbook – refresh quarterly

How to use this skill

Skim modules/core-guidance.md for framing and triage cues.
Load protocol-specific patterns from modules/design-foundations.md.
Use modules/lifecycle-and-governance.md to plan change management and documentation.
Apply modules/security-and-observability.md before launch.
Revisit modules/known-gaps.md each quarter and log findings in the modules/research-checklist.md.

Module overview

Core guidance — decision tree, API style selection, stakeholder prompts.
Design foundations — REST, GraphQL, gRPC, and event-driven design blueprints.
Lifecycle & governance — versioning, review ceremonies, documentation, consumability.
Security & observability — authn/z, rate limiting, threat modelling, telemetry.
Known gaps — research debt and upcoming RFCs to review.
Research checklist — renewal workflow with links to canonical sources.

Research status

Content incorporates Microsoft REST API Guidelines (2024), OWASP API Security Top 10 (2023), CNCF API landscape (2025), and GraphQL June 2024 spec.
Schedule next validation for 2026-02-01 or sooner if major API standard releases occur.
Known gaps call out AsyncAPI 3.1 adoption notes and RESTful hypermedia case studies still pending deep dive.