spec-author

Authors and grows requirements-genre PRODUCT_SPEC.md files with completeness checks and cross-axis composition.

1|Updated Jul 4, 2026
One-click install
npx skills add https://github.com/happysasha18/live-spec --skill spec-author-happysasha18
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: spec-author
Source: https://github.com/happysasha18/live-spec/tree/main/skills/spec-author
Command: npx skills add https://github.com/happysasha18/live-spec --skill spec-author-happysasha18

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Specs written after the fact or left with silent gaps let agents ship behavior nobody decided. This Skill writes and grows a living PRODUCT_SPEC.md that states every reachable situation, marks undecided calls as ⟨DECIDE⟩ instead of guessing, and stays structured so a formal review pass can find the holes. ## Core Features & Use Cases - Structured spec authoring: Writes requirements with Context blocks, User Stories, and named-case acceptance criteria, plus a closed-vocabulary glossary and a generated code-to-location table. - Composition sweep: Enumerates every stateful surface across canonical axes (view, mode, tier, viewport, persistence, concurrency, sibling surfaces) so cross-section bugs are specified before code exists. - Completeness and facet passes: Runs checklists covering entities, transitions, invariants, regression fences, and per-feature facets, ending each as a decided or [default]-tagged spec sentence. - Use Case: You say "add a date filter to the report page" and the Skill grows the spec delta — fences for neighboring promises, the new behavior, facet sentences, non-goals, and a success measure — ready for product-prover review before tests or code. ## Quick Start Ask the agent to start a spec for the feature you are about to build, or to add a new feature to the existing PRODUCT_SPEC.md.

Frequently Asked Questions about spec-author

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

FAQPage Schema
How do I write a product spec before coding a feature?▼

Invoke the Skill with a plain-language request like "spec out this feature." It writes or grows a PRODUCT_SPEC.md requirement with a Context block, User Story, and named-case acceptance criteria, then runs a completeness pass before handing off to review.

What is cross-section composition in a product spec?▼

It is enumerating every stateful surface against each global axis — view, mode, tier, viewport size, persistence, concurrency, and sibling surfaces — and stating whether the state stays visible and reversible. Bugs that pass unit tests typically live in these unexamined products of surface-state and axis.

When should I not use spec-author?▼

Skip it for retro-documenting already-built code, prototypes that carry no spec, pure research notes, and single-file edits with no new behavior. Use product-prover instead when you want a spec reviewed rather than written.

How does spec-author handle undecided product decisions?▼

It never invents intent. Domain calls only a human can make are marked ⟨DECIDE⟩ with a one-line question, and source holes become [GAP: ...] lines naming the actor most likely to own the call, so gaps stay visible instead of being silently filled.

Does spec-author work with product-prover?▼

Yes, they form a pair using the same formal-verification primitives. spec-author writes the spec with surfaces named once and cross-links explicit, then product-prover reviews the whole spec to find gaps, contradictions, and missing invariants before tests are derived.