speccer

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

5|Updated Jan 6, 2026

Search Tags:#specification #requirements #decomposition #issues #project-planning #speccer

Ready to run

npx skills add https://github.com/schpet/toolbox --skill speccer

💬 Prompt for ChatGPT / Claude Chat▼

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.