to-spec

Synthesizes conversation context into a structured spec document committed to the repository.

2|Updated Jul 11, 2026
One-click install
npx skills add https://github.com/MoofonLi/dev-ready --skill to-spec-moofonli
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: to-spec
Source: https://github.com/MoofonLi/dev-ready/tree/main/.agents/skills/to-spec
Command: npx skills add https://github.com/MoofonLi/dev-ready --skill to-spec-moofonli

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Turning a long design conversation into a durable, written specification is tedious and error-prone. This Skill converts the current conversation and codebase understanding into a structured spec (PRD) without re-interviewing the user, and commits it as a durable document in the repository. ## Core Features & Use Cases - Conversation-to-Spec Synthesis: Generates a complete spec from existing discussion context, with no interview questions. - Structured Template: Produces Problem Statement, Solution, User Stories, Implementation Decisions, Testing Decisions, Out of Scope, and Further Notes sections. - Repository Conventions: Writes specs to docs/specs/<version>/fr-NN-<slug>.md, aligned with FR numbering, the project glossary, and ADRs. - Use Case: After discussing a new feature with your coding agent, invoke this Skill to capture the agreed design as a committed spec file that gates the next step (ticket breakdown) via its Draft-to-Accepted status. ## Quick Start Ask your agent to run the to-spec skill to turn the current conversation into a spec document under docs/specs.

Frequently Asked Questions about to-spec

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

FAQPage Schema
How do I turn a design conversation into a written spec?

Invoke the to-spec skill after discussing the feature with your agent. It synthesizes the existing conversation and codebase context into a structured spec with problem statement, user stories, and implementation decisions, without asking new interview questions.

What sections does a generated spec document contain?

The spec template includes Problem Statement, Solution, an extensive numbered list of User Stories, Implementation Decisions, Testing Decisions, Out of Scope, and Further Notes. Code snippets are excluded except for decision-rich prototype fragments.

Where are spec files stored in the repository?

Specs are written to docs/specs/<version>/fr-NN-<slug>.md, aligned with the FR numbering in requirements.md and version-plan.md. They are durable, committed documents and serve as the only lasting record of the design phase.

When should I not use conversation-to-spec synthesis?

Avoid it when the problem space is still unclear and needs discovery first. In that case run upstream steps like grilling or domain modeling before specification, since this skill only synthesizes what has already been discussed.

How does a spec get approved before implementation?

The spec carries a Status line that moves from Draft to Accepted. The project owner must accept it explicitly; the workflow does not proceed to ticket breakdown until that acceptance gate is passed.