ex-create-spec

Convert a one-line idea into a formal software specification.

Updated Apr 4, 2026
One-click install
npx skills add https://github.com/ricky-yosh/agent-workflows --skill ex-create-spec
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ex-create-spec
Source: https://github.com/ricky-yosh/agent-workflows/tree/main/skills/example/ex-create-spec
Command: npx skills add https://github.com/ricky-yosh/agent-workflows --skill ex-create-spec

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Convert a one-line idea into a formal software specification to guide development.

Core Features & Use Cases

  • Guided AskUserQuestion prompts to capture idea choices.
  • Draft pattern: generate a .aw/test-progress/spec.md.draft that outlines goals, requirements, and acceptance criteria.
  • Digest output: finalize into a clean spec.md once approved with a simple confirmation.

Quick Start

Provide a one-line idea to start generating a project spec.

Frequently Asked Questions about ex-create-spec

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

FAQPage Schema
How do I convert a one-line idea into a formal software specification?

To convert a one-line idea into a software specification, you provide the initial concept and the tool uses interactive prompts to capture choices, generating a draft with goals, requirements, and acceptance criteria before finalizing the spec.

What is the best way to scope features for early project ideation?

The best way to scope features for early project ideation is using an interactive draft pattern that guides you through questions, outlines project goals and acceptance criteria, and finalizes a clean specification document upon confirmation.

Can I generate a draft specification before finalizing the project requirements?

Yes, you can generate a draft specification before finalizing requirements. The process creates a draft file outlining goals and acceptance criteria, allowing you to review the content before approving and finalizing the clean spec.

Do I need to provide detailed requirements to start writing a project spec?

You do not need to provide detailed requirements to start writing a project spec. You only need to provide a one-line idea to initiate the interactive prompts, which will guide you through capturing the necessary choices and scoping details.

How does the interactive prompt mechanism work for product management specifications?

The interactive prompt mechanism works by presenting targeted questions after you input your initial idea, capturing your specific choices to automatically structure the draft, and ensuring the final product management specification aligns with your stated goals.

What are the limitations of using automated tools for software specification generation?

A limitation of automated software specification generation is that it relies heavily on your one-line input and subsequent prompt answers, meaning incomplete or vague early ideation responses will result in a less accurate draft specification.