Skip to content
Get packs

API Design Patterns

Gives the agent REST API conventions for naming, status codes, pagination, filtering, errors, versioning and rate limits.

Source Download skill
Repository
affaan-m/ECC
Stars
295,127
Licence
MIT
Files
1 file

What it does

When installed, this skill tells the agent to follow a consistent set of REST API design conventions when it designs or reviews endpoints. It covers how to name URLs, which HTTP status codes to return, how to structure success and error responses, how to paginate (offset versus cursor), and how to filter, sort and search collections. The file is written in Spanish and is a reference guide of patterns and examples, not a tool that changes files or calls services.

Great for

  • Backend developers designing a new REST API who want consistent endpoint naming and status codes
  • Teams reviewing an existing API contract for pagination, filtering or error-format consistency
  • Developers building public or partner-facing APIs who want guidance on versioning and rate limiting

Skip it if

  • Non-developers with no API work, since the content assumes familiarity with HTTP and REST (the skill's guidance is not a substitute for reviewing security-critical auth design)
  • APIs that use GraphQL, gRPC or other non-REST styles, where most of the advice does not apply

Try asking

  • “Design the REST endpoints for a new orders service with cancel and refund actions”
  • “Review this API contract and tell me where the status codes or URL naming break conventions”
  • “Add cursor-based pagination and consistent error responses to our users endpoint”
Step-by-step guide: how to use API Design PatternsInstall, first run, examples, tips and FAQs

Install in 3 steps

  1. 1

    Download the skill

    The ZIP contains the 1 original files, the MIT licence and an attribution note.

    api-design.zip
  2. 2

    Add it to your agent

    Claude Code (all projects)

    mkdir -p ~/.claude/skills && unzip api-design.zip -d ~/.claude/skills/

    Claude Code / Agent SDK (this project only)

    mkdir -p .claude/skills && unzip api-design.zip -d .claude/skills/

    Claude apps (web/desktop): Settings → Capabilities → Skills → Upload skill, and choose the ZIP.

  3. 3

    Ask for the task

    No special command needed — the agent reads the skill's description and loads it when your request matches. Try one of the prompts above.

Get better results

  • Name the framework or database you use so the agent can adapt the SQL and code examples
  • Ask for a review of a specific endpoint or contract rather than a general overview, so the agent applies the rules to real code
  • Check the agent's versioning and rate-limit suggestions against your own infrastructure, since the file covers these only briefly

What's inside

  • SKILL.md

Redistributed unmodified from affaan-m/ECC under the MIT licence. The assessment was drafted with AI from the skill's files on 2026-10-29. Skills can instruct your agent to run code — read SKILL.md and any scripts before installing.