spec-organizer

Transforms vague product ideas into technical specs, plain-language specs, and staged Codex/Claude Code development plans.

Updated Aug 22, 2026
One-click install
npx skills add https://github.com/JustinChangTW/ai-skills-core --skill spec-organizer-justinchangtw
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: spec-organizer
Source: https://github.com/JustinChangTW/ai-skills-core/tree/main/skills/09-software-problem-solving/spec-organizer
Command: npx skills add https://github.com/JustinChangTW/ai-skills-core --skill spec-organizer-justinchangtw

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) and assets (resource) components.

What problem does it solve? Turning a rough feature idea into a specification that engineers can actually build from is slow and error-prone: requirements stay vague, acceptance criteria go missing, edge cases are forgotten, and non-technical stakeholders cannot read the result. This Skill runs a structured spec-first workflow that researches the domain, challenges the draft from PM/architect/QA perspectives, and delivers implementation-ready documents. ## Core Features & Use Cases - Dual-version specification output: Produces a full technical spec (data models, state machines, API design, error handling, SVG architecture and UI diagrams) plus a plain-language version with zero technical jargon for non-developers. - Research gate before writing: Searches key concept definitions, competitor products, and similar GitHub repositories, then presents comparisons in code blocks for user confirmation before drafting the final spec. - Staged agent development plans: Splits the build into vertical-slice stages (Stage 0 scaffolding, penultimate testing stage, final documentation stage), each with ready-to-paste Codex Instructions and Claude Code Instructions including DoD and rollback notes. - Use Case: You have a one-line idea for a PDF-upload AI summarizer tool. The Skill first shows competitor and open-source comparisons, then delivers the technical spec, a jargon-free spec for stakeholders, and per-stage instructions you can paste directly into Codex or Claude Code. ## Quick Start Ask the AI to turn your rough product idea into a complete technical spec, a plain-language spec, and a staged Codex and Claude Code development plan, noting any constraints or assumptions it should make.

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 rough product idea into a developer-ready spec?▼

Describe your goal, users, and constraints, and the Skill runs a structured workflow: domain research, feasibility analysis, PM/architect/QA review passes, then final output. You receive a technical spec, a plain-language spec, and staged Codex/Claude Code instructions.

What does the spec-organizer output include?▼

Every run delivers three artifacts: a technical specification with data models, API design, state machines and SVG diagrams; a jargon-free non-technical specification; and a staged development plan with paste-ready Codex and Claude Code instruction blocks per stage.

Can I get the full spec in a single conversation turn?▼

Yes. By default the Skill pauses after the research and comparison checkpoint for your confirmation, but if you explicitly ask it to proceed without questions, it makes reasonable assumptions, marks them clearly, and completes all three deliverables in one turn.

How does it keep the plain-language spec free of technical jargon?▼

It follows a plain-language rules reference that maps terms like API, database, and streaming to everyday phrasing. A bundled Python script, check_plain_language.py, scans the output file and fails if any banned technical terms remain.

When should I not use this spec-writing workflow?▼

It is not suited for copywriting, slide outlines, Mermaid-only diagrams, or direct code bug fixes. Those requests are routed to neighboring skills; this one only handles product, feature, or system specification work.