Agent skill · software engineering · sickn33

api-designer

Generates complete, production-ready REST API endpoint specifications for any system or domain the user describes.

Why this skill is useful

Generates detailed REST API specifications including endpoints, methods, and error handling that the AI wouldn't reliably produce on its own.

What it needs

About 4k tokens when loaded. Last updated 2026-08-07. 44,571 stars on the source repository.

What this skill does

Supporting material availability This catalog copy contains the inline guidance below, but does not include the following supporting paths. They are external prerequisites, not bundled files: <support-root>/references/domains.md <support-root>/references/testmuexample.md Obtain the required material from the declared upstream source, or from a user-provided installation of that source. Resolve each path relative to that installation, inspect its contents, and verify any applicable license and execution prerequisites. Do not run a command or claim a referenced procedure was followed until its required file exists. Do not fabricate the missing scripts or treat an unrelated file with the same name as equivalent. Independent steps fully documented here can proceed within the user’s authorized scope; report any dependent step as unavailable. 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. …

How to use it

Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:

@skills sickn33/api-designer--f70195

View the source on GitHub

Browse the @skills marketplace