speclet-spec

Convert .speclet/draft.md into an executable spec.json with trackable stories.

Updated Jan 9, 2026
One-click install
npx skills add https://github.com/danielcastro-dev/speclet --skill speclet-spec
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: speclet-spec
Source: https://github.com/danielcastro-dev/speclet/tree/main/.opencode/skill/speclet-spec
Command: npx skills add https://github.com/danielcastro-dev/speclet --skill speclet-spec

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Converts a draft document into an executable spec.json with trackable stories, enabling structured feature delivery from informal notes.

Core Features & Use Cases

  • Converts .speclet/draft.md into .speclet/spec.json with a clearly defined feature, summary, and acceptance criteria.
  • Generates atomic stories with verifiable acceptance criteria and numbers functional requirements (FR-1, FR-2, etc.).
  • Tracks story status with a passes boolean for each story and supports a quick spec-lite flow for rapid fixes.

Quick Start

Convert your draft at .speclet/draft.md into a fully formed .speclet/spec.json.

Frequently Asked Questions about speclet-spec

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

FAQPage Schema
How do I convert a draft document into an executable specification with acceptance criteria?

To convert a draft document into a specification, place your notes in the `.speclet/draft.md` file. The tool processes this informal draft and automatically generates a structured `spec.json` file containing functional requirements, atomic stories, and verifiable acceptance criteria.

What is the best way to track feature development stories from informal notes?

Tracking feature development from informal notes is done by generating a `spec.json` file with atomic stories. Each story receives a boolean `passes` flag and verifiable acceptance criteria, allowing you to monitor implementation status directly from the structured specification output.

How does a specification generator number functional requirements for story tracking?

A specification generator numbers functional requirements sequentially as FR-1, FR-2, and so on. This numbering enforces structure across the generated `spec.json` file, linking each atomic story to clearly defined functional requirements and verifiable acceptance criteria for accurate tracking.

Do I need a specific file structure to generate trackable stories from a draft?

You need a specific file structure to generate trackable stories. Your draft must be located at `.speclet/draft.md` before processing. The tool reads this exact path and outputs the structured `spec.json` file directly into the `.speclet` directory.

What required fields are enforced when creating a spec.json from a draft?

The spec.json creation enforces required fields including feature, branch, date, summary, nonGoals, functionalRequirements, and a stories array. These fields ensure the resulting specification provides a fully structured and trackable foundation for feature delivery.

Can I use a spec-lite flow for rapid fixes instead of full feature development?

You can use a spec-lite flow for rapid fixes alongside full feature development. This flow supports converting a draft document into a `spec.json` quickly, maintaining the required fields and verifiable acceptance criteria while enabling faster tracking for smaller updates.