Agent skill · Backend & API

api-designer

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...",...

Nick44,086★ · +407/wk · 1 repos on radarProfile →
claude-codecodexcursorMIT
Install
npx skills add sickn33/agentic-awesome-skills --skill api-designer --agent claude-code

Same command for any agent — swap --agent for codex, cursor, copilot.

Facts
Files in the skill folder: 1
SKILL.md size: 6 KB
Bundled scripts: none
Path: skills/api-designer/SKILL.md
Open the folder on GitHub →
Where it comes from
Stars: 44,414 · +328 this week
Language: Python
Read our review of the source →

Weekly change comes from our own snapshots, not the repository page — it measures attention, not adoption.

From the SKILL.md

# API Designer Skill ## When to Use Use this skill when you need 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...",... You are an expert API architect. Ask the user if they want just the endpoints or complete detailed response (Enpoints Only/Detail Design). Do not ask these options if the user has specified the details of his requirement in the input already. If the user says **Endpoints Only**: - Output only the endpoints If the user says **Detail Design**: - Output complete design as the structure described in this skill. --- ## Output Format First list down all the endpoints one after another as output then expand each in this exact structure for **each endpoint group** (resource): --- ### `RESOURCE NAME` #### `METHOD /path/to/endpoint` > Short description of what this endpoint does. Not more than two lines. **Headers** | Header | Value | Required | |--------|-------|----------| | `Content-Type` | `application/json` | Yes | | `Authorization` | `Bea

What's inside
Steps it walks through
  1. When to Use
  2. Output Format
  3. RESOURCE NAME
  4. Rules for Output
  5. Pagination Envelope (for list endpoints)
  6. Common Auth Patterns
  7. Domain Reference Cheatsheet
  8. After Completing the API Design
  9. Tone & Length
  10. Limitations
More from agentic-awesome-skills
All skills →
About this skill
What does the api-designer skill do?

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...",...

How do I install it?

Run `npx skills add sickn33/agentic-awesome-skills --skill api-designer --agent claude-code` — it drops the skill into your project so the agent can pick it up. Swap the --agent value for codex, cursor or copilot if you use one of those.

Where does this skill come from?

From sickn33/agentic-awesome-skills, a repository with 44,414 stars. We read it straight from the repository tree rather than a submitted listing, so what you see here is what is actually published.

Is a popular skill a good skill?

Not necessarily. Stars measure attention, not adoption — a repository can trend for a week and be abandoned. That is why we show the weekly change from our own snapshots next to the total, instead of a single flattering number.

Keep going