skills/example/ex-create-spec/SKILL.md
Example skill — write a spec from a one-line idea. Demonstrates AskUserQuestion input, .draft file pattern, and digest output.
npx skillsauth add ricky-yosh/agent-workflows ex-create-specInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
Turn a one-line idea into a short spec.
AskUserQuestion:
question: "What do you want to build?"
options:
- "A greeting CLI tool"
- "A number formatter"
- "Let me type something"
Write .aw/test-progress/spec.md.draft:
# <Title>
## Goal
<One sentence based on their choice>
## Requirements
- R1: <requirement>
- R2: <requirement>
## Done When
- <Single acceptance criterion>
Then ask:
AskUserQuestion:
question: "Spec look good?"
options:
- "Approved"
- "Revise"
On approval, rename .aw/test-progress/spec.md.draft → .aw/test-progress/spec.md.
Say: "Spec saved."
development
Write tests for a batch of tasks BEFORE implementation. Detects the project's test framework and language, then writes tests that cover happy paths, edge cases, and failure modes. All tests should fail initially since there is no implementation yet. Part of the gf (greenfield) skill family. Use when the user says /gf-write-tests or wants to write tests before implementing a feature or task batch.
testing
Generate readable testing notes after a feature is complete. Compares spec against implementation to produce a concise list of what was built, how to test it, and any scope gaps. Writes testing-notes.md to .aw/greenfield-progress/. Part of the gf (greenfield) skill family.
testing
Save current session work to .aw/greenfield-progress/progress.txt. Captures decisions (why, not just what) that git diff cannot show. Updates tasks.json to mark completed tasks. Part of the gf (greenfield) skill family.
testing
Gate the greenfield workflow on user verification after an implementation step. Reads the implementation digest, shows verification steps, and waits for the user to confirm before advancing. Part of the gf (greenfield) skill family.