api-design-and-versioning
Design REST/GraphQL APIs with versioning and deprecation strategy.
npx skills add majiayu000/claude-skill-registry --skill api-design-and-versioning --agent claude-code
Same command for any agent — swap --agent for codex, cursor, copilot.
Weekly change comes from our own snapshots, not the repository page — it measures attention, not adoption.
# Api Design And Versioning ## Purpose - Design REST/GraphQL APIs with versioning and deprecation strategy. ## Preconditions - Access to system context (repos, infra, environments) - Confirmed requirements and constraints - Required approvals for security, compliance, or governance ## Inputs - Problem statement and scope - Current architecture or system constraints - Non-functional requirements (performance, security, compliance) - Target stack and environment ## Outputs - Design or implementation plan - Required artifacts (diagrams, configs, specs, checklists) - Validation steps and acceptance criteria ## Detailed Step-by-Step Procedures 1. Clarify scope, constraints, and success metrics. 2. Review current system state, dependencies, and integration points. 3. Select patterns, tools, and architecture options that match constraints. 4. Produce primary artifacts (docs/specs/configs/code stubs). 5. Validate against requirements and known risks. 6. Provide rollout and rollback guidance. ## Decision Trees and Conditional Logic - If compliance or regulatory scope applies -> add required controls and audit steps. - If latency budget is strict -> choose low-latency storage and caching. -
- Purpose
- Preconditions
- Inputs
- Outputs
- Detailed Step-by-Step Procedures
- Decision Trees and Conditional Logic
- Error Handling and Edge Cases
- Tool Requirements and Dependencies
- Stack Profiles
- Validation
- Rollback Procedures
- Success Metrics
- Example Workflows and Use Cases
What does the api-design-and-versioning skill do?
Design REST/GraphQL APIs with versioning and deprecation strategy.
How do I install it?
Run `npx skills add majiayu000/claude-skill-registry --skill api-design-and-versioning --agent claude-code` — it drops the skill into your project so the agent can pick it up. Swap the --agent value for codex, cursor or copilot if you use one of those.
Where does this skill come from?
From majiayu000/claude-skill-registry, a repository with 534 stars. We read it straight from the repository tree rather than a submitted listing, so what you see here is what is actually published.
Is a popular skill a good skill?
Not necessarily. Stars measure attention, not adoption — a repository can trend for a week and be abandoned. That is why we show the weekly change from our own snapshots next to the total, instead of a single flattering number.