speccer

Convert unstructured notes into a structured docs/spec.md specification document.

5|Updated Jan 6, 2026
One-click install
npx skills add https://github.com/schpet/toolbox --skill speccer
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: speccer
Source: https://github.com/schpet/toolbox/tree/main/plugins/speccer/skills/speccer
Command: npx skills add https://github.com/schpet/toolbox --skill speccer

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Speccer transforms messy, unstructured notes (bullets, rough ideas, transcripts) into a single, well-defined project specification document with actionable issues.

Core Features & Use Cases

  • Single spec document: Produces one docs/spec.md containing project overview, feature domains, open questions, and actionable issues.
  • Ambiguity reduction: Identifies ambiguities and surfaces clarifying questions to speed up alignment.
  • Issue generation: Outputs ready-to-create issues with acceptance criteria based on the spec.

Quick Start

Provide your rough input to Speccer (bullets, notes, or transcripts) and invoke /speccer. Speccer will generate docs/spec.md at the project root and present clarifying questions if needed.

Frequently Asked Questions about speccer

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

FAQPage Schema
How do I turn rough notes and transcripts into a structured project specification?

To convert rough notes into a project specification, input your unstructured bullets, ideas, or transcripts. The tool distills them into a single docs/spec.md containing project overview, feature domains, open questions, and actionable issues with acceptance criteria.

What is the best way to generate actionable issues from unstructured product ideas?

Generating actionable issues from unstructured product ideas is done by transforming rough notes into a consolidated specification. The output includes ready-to-create issues complete with acceptance criteria based directly on the structured spec document.

Can I create a project specification without any external dependencies or runtime environments?

Yes, you can create a project specification without external dependencies because the tool requires no external runtime beyond the repository. It operates entirely within your project to generate the ready-to-use docs/spec.md file at the root.

How does specification decomposition handle ambiguities in early-stage product planning?

Specification decomposition handles ambiguities by identifying unclear areas in your unstructured input and surfacing clarifying questions. This reduces ambiguity and speeds up team alignment during early-stage product discovery and planning.

What format does the generated project specification document use?

The generated project specification document uses a Markdown format saved as docs/spec.md at the project root. It contains consolidated sections for project overview, feature domains, open questions, and actionable issues.