API Design

API Design is an AI Engineering skill for Claude Code, published by majiayu000 in spellbook.

265 stars26 forkson majiayu000/spellbookAdded 2026/09/02+1% in starsRepository updated 2026/08/31

agent-skillsai-agent-skillsai-agentsai-coding-assistantautomationclaudeclaude-codeclaude-code-skillscode-reviewcodexcodex-skillscross-runtimedeveloper-toolsmulti-agentproductivityprompt-engineeringskill-librarysoftware-developmentspellbookworkflows

Install in seconds

Install API Design

Copy API Design 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/majiayu000/spellbook/tree/main/skills/api-design ~/.claude/skills/api-design

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/majiayu000/spellbook.git

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

In this catalog

Source file: skills/api-design/SKILL.md in majiayu000/spellbook
Installs to: ~/.claude/skills/api-design
Collection: One of 25 skills cataloged from this repository
Category: AI Engineering — 2631 skills

What API Design does

API Design covers REST, GraphQL, and gRPC best practices for defining contracts, versioning, pagination, errors, and idempotency. Use it when designing public or internal APIs and their schemas.

API Design is cataloged under AI Engineering on DirSkills. API Design comes from a repository tagged agent-skills, ai-agent-skills, ai-agents, ai-coding-assistant and automation.

Documentation

README

Excerpt

API Design

Core Principles

Contract-First — Define API spec before implementation
OpenAPI 3.2 — Use OpenAPI for REST API documentation
URL Versioning — Version in path /v1/, with Sunset headers
Idempotency — PUT/DELETE must be idempotent, POST uses Idempotency-Key
Cursor Pagination — Avoid offset-based pagination
RFC 7807 Errors — Standard Problem Details format
No backwards compatibility — Delete, don't deprecate

Quick Reference

When to Use What

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

Commands API Design provides

Slash commands named in this skill’s SKILL.md, listed in the order they first appear.

/users
/orders

Frequently asked about API Design

What else does majiayu000 publish alongside API Design?
API Design is one of 25 skills that DirSkills catalogs from majiayu000/spellbook, the repository it ships in. Its siblings there include AGENTS.md Scaffold, Agents Md Optimize and App User Story QA. Each one is a separate skill with its own page in this directory, installs the same way API Design does, and is maintained by majiayu000 in that same repository. The rest of the collection is listed on the majiayu000/spellbook page.
How does API Design compare to other AI Engineering skills?
API Design ranks #2226 by stars among the 2631 AI Engineering skills in this catalog. The most-starred ones next to it are Architecture Decision Records, AI-First Engineering and Agentic OS. 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 against them. Open each page to compare what they document and how they install.