API Design

API Design is an AI Engineering skill for Claude Code, published by seb1n in awesome-ai-agent-skills.

174 stars32 forkson seb1n/awesome-ai-agent-skillsAdded 2026/09/07+2% in starsRepository updated 2026/08/09

agent-skillsai-agent-skillsai-agentsawesome-listclaude-codeclaude-code-skillsclaude-skillscodexcodex-skillscontext-engineeringcursorcursor-skillsgemini-cligemini-skillsgithub-copilotmcpopenai-codexskill-mdskillswindsurf

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/seb1n/awesome-ai-agent-skills/tree/main/api-and-integration/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/seb1n/awesome-ai-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-and-integration/api-design/SKILL.md in seb1n/awesome-ai-agent-skills
Installs to: ~/.claude/skills/api-design
Collection: One of 25 skills cataloged from this repository
Category: AI Engineering — 3475 skills

What API Design does

API Design helps design production-quality RESTful APIs with resource modeling, HTTP methods, status codes, pagination, versioning, and OpenAPI docs. Use it when you need endpoint definitions, schemas, or a REST API specification.

API Design is cataloged under AI Engineering on DirSkills. API Design comes from a repository tagged agent-skills, ai-agent-skills, ai-agents, awesome-list and claude-code.

Documentation

README

Excerpt

API Design

This skill enables an AI agent to design production-quality RESTful APIs. The agent models resources, defines endpoints with correct HTTP method semantics, selects appropriate status codes, implements pagination and versioning strategies, and produces OpenAPI documentation. The output follows REST constraints including statelessness, uniform interface, and resource-based URIs.

Workflow

Identify resources and relationships: Analyze the application domain to extract nouns as resources (e.g., users, tasks, comments). Map relationships between resources—one-to-many, many-to-many—and determine whether sub-resources or independent collections are appropriate. Avoid verb-based endpoints; resources should represent entities, not actions.

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.

/tasks
/task

Frequently asked about API Design

What else does seb1n publish alongside API Design?
API Design is one of 25 skills that DirSkills catalogs from seb1n/awesome-ai-agent-skills, the repository it ships in. Its siblings there include API Integration, Agent Evaluation and Agent Observability. Each one is a separate skill with its own page in this directory, installs the same way API Design does, and is maintained by seb1n in that same repository. The rest of the collection is listed on the seb1n/awesome-ai-agent-skills page.
How does API Design compare to other AI Engineering skills?
API Design ranks #3203 by stars among the 3475 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.