API Designer

by Jeffallan

API Designer is a DevOps skill for Claude Code, published by Jeffallan in claude-skills.

11K stars1K forkson Jeffallan/claude-skillsAdded 2026/08/15Repository updated 2026/08/07

View source on GitHub Download repo ZIP

ai-agentsclaudeclaude-codeclaude-marketplaceclaude-skills

Install in seconds

Install API Designer

Copy API Designer 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/Jeffallan/claude-skills/tree/main/skills/api-designer ~/.claude/skills/api-designer

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/Jeffallan/claude-skills.git

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

In this catalog

Source file: skills/api-designer/SKILL.md in Jeffallan/claude-skills
Installs to: ~/.claude/skills/api-designer
Collection: One of 25 skills cataloged from this repository
Category: DevOps — 798 skills

What API Designer does

API Designer helps design REST and GraphQL APIs, creating OpenAPI specifications and planning API architecture including resource modeling, versioning, pagination, and error handling. Use it when you need to design or document an API contract.

API Designer is cataloged under DevOps on DirSkills. API Designer comes from a repository tagged ai-agents, claude, claude-code, claude-marketplace and claude-skills.

Documentation

README

Excerpt

API Designer

Senior API architect specializing in REST and GraphQL APIs with comprehensive OpenAPI 3.1 specifications.

Core Workflow

Analyze domain — Understand business requirements, data models, and client needs
Model resources — Identify resources, relationships, and operations; sketch entity diagram before writing any spec
Design endpoints — Define URI patterns, HTTP methods, request/response schemas
Specify contract — Create OpenAPI 3.1 spec; validate before proceeding: npx @redocly/cli lint openapi.yaml
Mock and verify — Spin up a mock server to test contracts: npx @stoplight/prism-cli mock openapi.yaml
Plan evolution — Design versioning, deprecation, and backward-compatibility strategy

Reference Guide

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

Frequently asked about API Designer

What else does Jeffallan publish alongside API Designer?
API Designer is one of 25 skills that DirSkills catalogs from Jeffallan/claude-skills, the repository it ships in. Its siblings there include .NET Core Expert, Angular Architect and Architecture Designer. Each one is a separate skill with its own page in this directory, installs the same way API Designer does, and is maintained by Jeffallan in that same repository. The rest of the collection is listed on the Jeffallan/claude-skills page.
How does API Designer compare to other DevOps skills?
API Designer ranks #96 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 API Designer against them. Open each page to compare what they document and how they install.