🔗
QualityPython

API Design

by nimadorostkar

API Design is a Quality skill for Claude Code, published by nimadorostkar in Claude-Skills-collection.

18 stars2 forkson nimadorostkar/Claude-Skills-collectionAdded 2026/07/16+13% in starsRepository updated 2026/07/14
View source on GitHubDownload repo ZIP
aiclaudeclaude-skillsskills
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/nimadorostkar/Claude-Skills-collection/tree/main/skills/backend/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/nimadorostkar/Claude-Skills-collection.git

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

In this catalog

Source file
skills/backend/api-design/SKILL.md in nimadorostkar/Claude-Skills-collection
Installs to
~/.claude/skills/api-design
Collection
One of 50 skills cataloged from this repository
Category
Quality — 1897 skills

What API Design does

Use when designing or reviewing an HTTP API. Covers resource modeling, status codes, pagination, idempotency, versioning, error formats, and the contract details that break clients when you get them wrong.

API Design is cataloged under Quality on DirSkills. API Design comes from a repository tagged ai, claude, claude-skills and skills.

Documentation

README

API Design

Purpose

Design HTTP APIs that clients can use correctly without reading your source code, and that you can evolve without breaking them.

When to Use

  • Designing a new API or a new endpoint on an existing one.
  • Reviewing an API before it becomes public and therefore permanent.
  • Introducing versioning, pagination, or idempotency to an API that lacks them.
  • Writing or auditing an OpenAPI specification.

Capabilities

  • Resource and URL modeling.
  • Status-code semantics and consistent error payloads (RFC 9457 problem details).
  • Pagination strategies and their trade-offs.
  • Idempotency for unsafe methods.
  • Versioning and deprecation without breaking clients.
  • OpenAPI specification as the source of truth.

Inputs

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

Frequently asked about API Design

  • What else does nimadorostkar publish alongside API Design?

    API Design is one of 50 skills that DirSkills catalogs from nimadorostkar/Claude-Skills-collection, the repository it ships in. Its siblings there include Agent Design, Agent Instructions and Agent Memory. Each one is a separate skill with its own page in this directory, installs the same way API Design does, and is maintained by nimadorostkar in that same repository. The rest of the collection is listed on the nimadorostkar/Claude-Skills-collection page.

  • How does API Design compare to other Quality skills?

    API Design ranks #1874 by stars among the 1897 Quality skills in this catalog. The most-starred ones next to it are Benchmark, Benchmark Optimization Loop and API Design Patterns. 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.

More from nimadorostkar/Claude-Skills-collection

API Design is one of 50 skills cataloged on DirSkills from nimadorostkar/Claude-Skills-collection.

See all 50 skills →
🤖
2026/07/16

Agent Design

Provides patterns for designing reliable LLM agents with tool use, including loop termination, error handling, human checkpoints, and recognizing when an agent isn't needed.
AI Engineering
182
🧭
2026/07/16

Agent Instructions

Write short, accurate instruction files for coding agents, including commands, conventions, and hard constraints. Use it when setting up or refreshing CLAUDE.md, AGENTS.md, or similar files.
AI Engineering
182
🧠
2026/07/16

Agent Memory

A method for agents to persist critical state—facts, failures, conclusions—in a file that survives context compaction and session ends, with strategies for retrieval and preventing stale data.
AI Engineering
182
🧾
2026/08/12

Architecture Decisions

Architecture Decisions records technical choices as ADRs with context, options, the decision, and consequences. Use it when a significant or hard-to-reverse decision needs to be documented for future maintainers.
Writing
253
⏳
2026/07/16

Background Jobs

Use when designing asynchronous job processing. Covers queue selection, idempotency, retry and backoff policy, scheduling, poison messages, and observability for work that happens outside the request.
DevOps
182
🎨
2026/08/12

Brand Guidelines

Brand Guidelines helps document and apply a brand system across new work. Use it to extract colours, type, spacing, imagery, and voice from existing assets, then audit for drift and consistency.
Writing
253

More Quality skills

API Design is one of 1897 Quality skills cataloged on DirSkills, ranked #1874 by stars among them.

Browse all Quality skills →
⏱️
4w ago

Benchmark

Benchmark measures performance baselines, detects regressions before and after PRs, and compares stack alternatives for pages, APIs, and builds.
Quality
239.8K36.4K
⏱️
4w ago

Benchmark Optimization Loop

Benchmark Optimization Loop turns vague performance goals into a bounded, measured optimization process. Use it when asked to make something faster, benchmark latency/throughput/cost, or choose the best implementation by repeated measured tests.
Quality
239.8K36.4K
🔌
4w ago

API Design Patterns

API Design Patterns provides conventions and best practices for designing consistent REST APIs. Use it when creating endpoints, reviewing contracts, handling pagination, error responses, status codes, filtering, or versioning.
Quality
239.8K36.4K