spec-organizer

Convert vague ideas into technical specs, plain-language versions, and Codex/Claude Code stage plans.

2|1|Updated Feb 1, 2026
One-click install
npx skills add https://github.com/AllanYiin/Amon --skill spec-organizer-allanyiin
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: spec-organizer
Source: https://github.com/AllanYiin/Amon/tree/main/src/amon/resources/skills/spec-organizer
Command: npx skills add https://github.com/AllanYiin/Amon --skill spec-organizer-allanyiin

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill helps transform vague product ideas into structured, testable specifications and a clear development plan, enabling teams to align on scope and acceptance criteria from the outset.

Core Features & Use Cases

  • Dual deliverables: generate both a technical specification and a plain-language version to communicate the plan with technical and non-technical stakeholders.
  • Phased development planning: produce Codex / Claude Code stage plans that break work into verifiable stages with DoD and testing guidance.
  • Research-led onboarding: perform upfront concept research, competitor comparisons, and repository explorations to ground decisions with evidence.
  • Output contract and traceability: include a defined output contract, references with dates, and a path to production-readiness.

Quick Start

Provide a complete dual-delivery spec set for a given idea: a technical spec, a plain-language version, and a staged Codex/Claude Code plan.

Frequently Asked Questions about spec-organizer

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

FAQPage Schema
How do I turn a vague product idea into a concrete, testable specification?

To turn a vague product idea into a concrete specification, you need a tool that performs upfront research, structures dual deliverables for technical and non-technical stakeholders, and generates DoD-driven validation criteria. This approach aligns teams on scope and acceptance criteria from the outset.

What is the best way to generate a technical spec and a plain-language version for stakeholders?

The best way to generate a technical spec and a plain-language version is to use a dual-output system that structures deliverables for both technical and non-technical stakeholders. This ensures clear communication of the development plan and acceptance criteria across the entire team.

How do I create a phased development plan with Codex or Claude Code?

You can create a phased development plan with Codex or Claude Code by generating stage plans that break work into verifiable stages with Definition of Done and testing guidance. This provides a clear, phased delivery path for feature decomposition and repository exploration.

Does generating a development specification require upfront concept research?

Yes, generating a development specification requires upfront concept research to ground decisions with evidence. This research phase includes competitor comparisons and repository explorations to ensure the output contract and traceability are production-ready.

Can I use a specification organizer for feature decomposition and acceptance criteria?

Yes, you can use a specification organizer for feature decomposition and acceptance criteria. It converts fuzzy ideas into structured outputs, including a research block, full technical spec, and DoD-driven validation, specifically supporting scenarios like feature breakdown.

How to ensure my technical specifications include traceability and production-ready paths?

To ensure your technical specifications include traceability and production-ready paths, structure your output contract to include references with dates and DoD-driven validation. This grounds the specifications in evidence and provides a clear path to production-readiness.