wa:design-specs

Generate design specification artifacts from feature descriptions.

Updated Mar 26, 2026
One-click install
npx skills add https://github.com/jeremy-newhouse/eck-e2e-weather-app --skill wa-design-specs
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: wa:design-specs
Source: https://github.com/jeremy-newhouse/eck-e2e-weather-app/tree/main/.claude/skills/design-specs
Command: npx skills add https://github.com/jeremy-newhouse/eck-e2e-weather-app --skill wa-design-specs

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Converts a feature or epic description into implementable, structured specification artifacts so teams can align on API contracts, database schemas, and non-functional requirements before coding.

Core Features & Use Cases

  • Stage-based spec generation: Runs a multi-phase workflow (pre-flight, complexity assessment, API, schema, NFRs) guided by a mode/rigor tier.
  • API contract outputs: Produces endpoint-level method/path definitions with request/response schemas, error codes, authentication, and rate limits.
  • Database schema outputs: Generates table/collection design, relationships, indexes, and migration plans, and adds sequence diagrams for complex cases.
  • Non-functional requirements: Captures quantified performance, scalability, security, reliability, and observability targets for complex tiers.

Quick Start

Run /design-specs user notification preferences API to generate the planning artifacts for the specified feature.

Frequently Asked Questions about wa:design-specs

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I generate API contracts and database schemas from a feature description?

You can generate API contracts and database schemas by providing a feature or epic description to a design specification generator. This tool runs a multi-phase workflow to produce endpoint definitions, request/response schemas, table designs, and migration plans.

What is the best way to document non-functional requirements for a complex API?

Documenting non-functional requirements for a complex API is best handled by a complexity-tiered design spec generator. It captures quantified performance, scalability, security, reliability, and observability targets based on the feature's assessed complexity.

How do I create sequence diagrams for database schema migrations?

To create sequence diagrams for database schema migrations, use a design specification tool that adds them automatically for complex cases. It generates table designs, relationships, indexes, and sequence diagrams alongside the migration plans.

Can I publish design specifications to Confluence directly from the generation tool?

Yes, you can publish design specifications to Confluence directly. The tool writes versioned draft specs to local docs and optionally attempts a Confluence publish without blocking the workflow if the publish operation fails.

Does the design spec generation workflow require plan mode?

Yes, the design specification workflow requires plan mode to function. It uses plan mode to resolve development rigor and guide the multi-phase complexity assessment before generating the structured specification artifacts.