← ClaudeAtlas

design-api-storieslisted

Generate API design stories from requirements, a domain model, and API standards. Stories bridge product requirements and OpenAPI specs — Emmanuel Paraskakis's method for designing APIs with LLMs. Use when user says "/design-api-stories" or asks to generate API user stories.
unperturbed-longislandsound997/skills · ★ 1 · AI & Automation · score 74
Install: claude install-skill unperturbed-longislandsound997/skills
# Design API Stories Generate API design stories from requirements, a domain model, and API standards. This is Emmanuel Paraskakis's method for designing APIs with LLMs — the stories become the bridge between product requirements and an OpenAPI specification. ## When to Use Use when the user says `/design-api-stories` or asks to generate API user stories from requirements. ## Inputs The user must provide three files (or paste their content). Files can be named anything — identify each file by its `# Title` heading or content, not by filename. 1. **Requirements** — ICP, needs, pain points, use cases, benefits. The "why" and "what." Look for a heading like `# Requirements`, `# Research`, or similar. 2. **Domain** — Data objects, properties, enums, object relations. The "nouns." Look for a heading like `# Domain`, `# Domain Model`, or similar. 3. **API Standards** — Style guide, naming conventions, path rules, security, error handling. The "how." Look for a heading like `# API Standards`, `# Style Guide`, or similar. If any file is missing, ask the user to provide it before proceeding. ### Working Example See `references/examples/` for a complete set of inputs (conference scheduling API): - `conference-research.md` — requirements - `conference-domain.md` — domain model - `API-standards.md` — API standards ## Step 1: Read All Inputs Read all three files completely. Understand: - Who the API consumers are (from requirements) - What entities and relationships exist (from