Designing APIs

by CloudAI-X

Designing APIs is a DevOps skill for Claude Code, published by CloudAI-X in claude-workflow-v2.

1.4K stars187 forkson CloudAI-X/claude-workflow-v2Added 2026/08/19Repository updated 2026/08/18

View source on GitHub Download repo ZIP

agent-skillsaiai-agentsclaude-codecodexcursorskillsworkflow

Install in seconds

Install Designing APIs

Copy Designing APIs 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/CloudAI-X/claude-workflow-v2/tree/main/skills/designing-apis ~/.claude/skills/designing-apis

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/CloudAI-X/claude-workflow-v2.git

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

In this catalog

Source file: skills/designing-apis/SKILL.md in CloudAI-X/claude-workflow-v2
Installs to: ~/.claude/skills/designing-apis
Collection: One of 14 skills cataloged from this repository
Category: DevOps — 798 skills

What Designing APIs does

Designing APIs guides the creation of REST and GraphQL APIs, covering endpoint structure, response formats, error handling, versioning, authentication, rate limiting, and OpenAPI documentation. Use it when creating new APIs, reviewing API contracts, or implementing REST or GraphQL patterns.

Designing APIs is cataloged under DevOps on DirSkills. Designing APIs comes from a repository tagged agent-skills, ai, ai-agents, claude-code and codex.

Documentation

README

Excerpt

Designing APIs

When to Load

Trigger: Designing REST or GraphQL endpoints, API contracts, versioning, request/response formats
Skip: Internal-only code with no API surface

API Design Workflow

Copy this checklist and track progress:

API Design Progress:
- [ ] Step 1: Define resources and relationships
- [ ] Step 2: Design endpoint structure
- [ ] Step 3: Define request/response formats
- [ ] Step 4: Plan error handling
- [ ] Step 5: Add authentication/authorization
- [ ] Step 6: Document with OpenAPI spec
- [ ] Step 7: Validate design against checklist

REST API Design

URL Structure

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

Commands Designing APIs provides

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

/users

Frequently asked about Designing APIs

What else does CloudAI-X publish alongside Designing APIs?
Designing APIs is one of 14 skills that DirSkills catalogs from CloudAI-X/claude-workflow-v2, the repository it ships in. Its siblings there include Analyzing Projects, Convex Backend and Database Design. Each one is a separate skill with its own page in this directory, installs the same way Designing APIs does, and is maintained by CloudAI-X in that same repository. The rest of the collection is listed on the CloudAI-X/claude-workflow-v2 page.
How does Designing APIs compare to other DevOps skills?
Designing APIs ranks #340 by stars among the 798 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 Designing APIs against them. Open each page to compare what they document and how they install.