How do I install the API Design skill?

Run npx skills-ws install api-design in your project. The skill is added to your agent's skills directory (.claude/skills, .cursor/skills, .agents/skills, or the OpenClaw workspace skills/ directory) and works with Claude Code, OpenClaw, Cursor, Codex, and GitHub Copilot.

Which AI coding assistants support the API Design skill?

API Design works with any agent that supports the SKILL.md standard, including openclaw, claude-code, cursor, codex.

Is the API Design skill free?

Yes. API Design is MIT-licensed open source and free to use. Source code is on GitHub at github.com/san-npm/skills-ws.

API Design skill

API Design is an agent skill for AI coding assistants (Claude Code, OpenClaw, Cursor, Codex). Production HTTP API design — REST conventions, pagination, error models, versioning, rate limiting, auth, and idempotency. Use when designing or reviewing public/internal HTTP APIs, OpenAPI contracts, pagination, error models, rate limits, auth, or idempotent write endpoints. Install with: npx skills-ws install api-design.

devv1.11.0Updated Aug 2026

copied ✓

openclawclaude-codecursorcodex

0 installsSecurity scan: cleanSource code

API Design

Reference guide

Read only the references needed for the current request:

REST Conventions That Actually Matter: references/rest-conventions-that-actually-matter.md
Pagination: Cursor vs Offset: references/pagination-cursor-vs-offset.md
Error Handling: RFC 9457 Problem Details: references/error-handling-rfc-9457-problem-details.md
API Versioning: references/api-versioning.md
Rate Limiting: references/rate-limiting.md
Authentication Patterns: references/authentication-patterns.md
Idempotency: references/idempotency.md
OpenAPI 3.1 Specification: references/openapi-3-1-specification.md
GraphQL vs REST: Decision Matrix: references/graphql-vs-rest-decision-matrix.md
Response Envelope: references/response-envelope.md
Checklist: Production-Ready API: references/checklist-production-ready-api.md

API Design

Reference guide

Related Dev skills