API Design and Evolution

by magnus919

API Design and Evolution is a DevOps skill for Claude Code, published by magnus919 in agent-skills.

40 stars6 forkson magnus919/agent-skillsAdded 2026/07/18+18% in starsRepository updated 2026/08/11

View source on GitHub Download repo ZIP

agent-skillsagentskillsai-agentsautomationllm

Install in seconds

Install API Design and Evolution

Copy API Design and Evolution into your Claude Code skills folder. Run the command in your terminal, or review the source on GitHub before installing.

terminal

npx degit https://github.com/magnus919/agent-skills/tree/main/api-design-and-evolution ~/.claude/skills/api-design-and-evolution

Requires Node.js. Downloads this skill only — not the rest of the repository — into your Claude Code skills folder.

Without Node.js

git clone https://github.com/magnus919/agent-skills.git

Clones the whole repository, then copy the skill’s own directory into your skills folder yourself.

In this catalog

Source file: api-design-and-evolution/SKILL.md in magnus919/agent-skills
Installs to: ~/.claude/skills/api-design-and-evolution
Collection: One of 33 skills cataloged from this repository
Category: DevOps — 1075 skills

What API Design and Evolution does

Design, document, review, and evolve consumer-facing APIs and event interfaces. Use when choosing REST, GraphQL, RPC, events, or webhooks; writing OpenAPI/AsyncAPI contracts; defining schemas, mutations, errors, idempotency, or planning API versioning, deprecation, and migration.

API Design and Evolution is cataloged under DevOps on DirSkills. API Design and Evolution comes from a repository tagged agent-skills, agentskills, ai-agents, automation and llm.

Documentation

README

Excerpt

API Design And Evolution

Design an interface as a durable agreement with its consumers, not a route list. Start with the consumer job, domain meaning, authority boundary, and failure modes; then choose the interface style and contract format. Keep facts, assumptions, and policy decisions distinguishable.

When to use

Use for a new or changed REST/HTTP API, GraphQL schema, RPC operation, event or message contract, webhook, or streaming interface. Use it before implementation and again whenever consumer-visible behavior changes.

This is the opening of the README. Read the full README on GitHub.

Frequently asked about API Design and Evolution

What else does magnus919 publish alongside API Design and Evolution?
API Design and Evolution is one of 33 skills that DirSkills catalogs from magnus919/agent-skills, the repository it ships in. Its siblings there include ADR Authoring, ARR CLI and Agent Council. Each one is a separate skill with its own page in this directory, installs the same way API Design and Evolution does, and is maintained by magnus919 in that same repository. The rest of the collection is listed on the magnus919/agent-skills page.
How does API Design and Evolution compare to other DevOps skills?
API Design and Evolution ranks #1029 by stars among the 1075 DevOps skills in this catalog. The most-starred ones next to it are Backend Patterns, API Connector Builder and Migration. DirSkills ranks by the star count of the repository each skill ships in, so that order reflects how popular those repositories are rather than any review of API Design and Evolution against them. Open each page to compare what they document and how they install.