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.