API Designer

What it does

When your agent uses it

• The user asks about API design
• Says things like what endpoints do I need for...
• Design an API for...

Example prompts

• “what endpoints do I need for...”
• “design an API for...”
• “Use the api-designer skill to generate complete, production-ready REST API endpoint specifications for any system or domain the user describes”
• “/api-designer”

Workflow steps

10 steps, taken from the first numbered list in SKILL.md.

1. 1Cover all major resources for the described system. Infer resources if the user doesn't list them.
2. 2Always include CRUD (Create, Read, Update, Delete) where applicable, plus domain-specific actions.
3. 3Use RESTful conventions: plural nouns for collections, nested paths for relationships (e.g. /hotels/{id}/rooms).
4. 4Auth: Default to Bearer token (JWT) for protected routes. Add API key header where relevant (e.g. third-party integrations). Mark public…
5. 5Request body: Show realistic JSON with field names, types, and brief descriptions. Mark required vs optional fields in comments.
6. 6Responses: Show the success response shape with realistic fields. Always include the HTTP status code.
7. 7Error codes: List the relevant subset per endpoint — don't always paste all 7. Use judgement.
8. 8Pagination: For list endpoints, include query params (page, limit, sort, filter) and wrap responses in a paginated envelope.
9. 9Versioning: Prefix all paths with /api/v1/ unless the user specifies otherwise.
10. 10Group endpoints by resource (e.g. "Authentication", "Hotels", "Rooms", "Bookings", "Payments", "Reviews").

What it can do on your machine

Read from SKILL.md and the folder at commit 000116a. It shows what the files ask for, not the result of running them.

• Tool permissions

  Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

  From allowed-tools in the SKILL.md frontmatter.

• Runs code

  No scripts in the folder and no shell commands in SKILL.md (its code samples are json).

  From the folder's file list and the shell code blocks in SKILL.md.

• Network

  No URLs in SKILL.md.

  From URLs in SKILL.md, links to its own repository left out.

• Credentials

  Names no API keys, tokens, secrets or passwords.

  From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

API Designer loads about 1.6k tokens when it runs. Until then it costs about 75 tokens; SKILL.md has 764 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it

~75

When it runs · the whole SKILL.md, loaded when a task matches

~1.6k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from majiayu000/claude-skill-registry at commit 000116a, republished under its MIT licence (© majiayu000). 764 words, ~1,613 tokens.

name

api-designer

description

Generates complete, production-ready REST API endpoint specifications for any system or domain the user describes. Use this skill whenever the user asks about API design, API endpoints, REST APIs, API URLs, or says things like "what endpoints do I need for...", "design an API for...",...

risk

unknown

source

https://github.com/LambdaTest/agent-skills/tree/main/api-skill/api-designer

source_repo

LambdaTest/agent-skills

source_type

community

date_added

2026-07-01

license

MIT

license_source

https://github.com/LambdaTest/agent-skills/blob/main/LICENSE

{
  "field": "type — description",
  "field2": "type — description"
}

{
  "field": "value or type"
}

{
  "data": [...],
  "pagination": {
    "total": 100,
    "page": 1,
    "limit": 20,
    "totalPages": 5
  }
}

© majiayu000, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 1 other file in skills/api/api-designer-sickn33-agentic-awesome-skil of majiayu000/claude-skill-registry.

• SKILL.md
• metadata.json

Open the folder on GitHubat commit 000116a

Used in 2 other repositories

We found 6 copies of this SKILL.md (exact, near-identical or edited) in other folders, from 2 other GitHub owners. This page covers the copy in majiayu000/claude-skill-registry, which our catalogue first saw on October 7, 2026.

• sickn33/agentic-awesome-skillsskills/api-designerplugins/agentic-awesome-skills/skills/api-designer+1 more
• lingxling/awesome-skills-cnantigravity-awesome-skills/skills/api-designerantigravity-awesome-skills/plugins/agentic-awesome-skills/skills/api-designer+1 more