# Design API

> Triggered when user asks to design APIs, create API specifications, or plan API endpoints. Automatically delegates to the api-designer agent. Use when this capability is needed.

- Skill: `tomevault-io/design-api-2` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add tomevault-io/design-api-2`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/design-api-2/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: tomevault-io (https://skillmd.com/u/tomevault-io)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/tomevault-io/design-api-2

---


# Design API Skill

## Trigger Phrases

This skill is automatically triggered when the user:

- Asks to "design API" or "create API"
- Requests API endpoints or specifications
- Wants REST API design
- Mentions "API design", "endpoints", or "API documentation"
- Asks about API structure or patterns

## Delegation Instructions

When this skill is triggered:

1. **Delegate immediately** to the `api-designer` agent
2. Provide API requirements and use cases
3. Include resource definitions
4. Specify API style preferences (REST, GraphQL, etc.)
5. Include any constraints or standards

## Context to Pass

- **API Purpose**: What the API needs to do
- **Resources**: Resources the API will manage
- **Use Cases**: Main use cases and workflows
- **API Style**: REST, GraphQL, RPC, etc.
- **Standards**: Any API standards to follow
- **Constraints**: Rate limiting, authentication, etc.

## Agent Responsibilities

The api-designer agent will:

1. Design API structure and endpoints
2. Define request/response schemas
3. Plan error handling
4. Ensure RESTful design
5. Create API documentation
6. Follow API best practices

---
> Converted and distributed by [TomeVault](https://tomevault.io/claim/dobroslavradosavljevic) — claim your Tome and manage your conversions.
<!-- tomevault:4.0:skill_md:2026-04-13 -->