write-spec

Convert vague ideas into structured Spec documents with goals and acceptance criteria.

Updated Apr 25, 2026
One-click install
npx skills add https://github.com/nmoralescyber/claude-skill-optimization --skill write-spec-nmoralescyber
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: write-spec
Source: https://github.com/nmoralescyber/claude-skill-optimization/tree/main/skills/product-management/write-spec
Command: npx skills add https://github.com/nmoralescyber/claude-skill-optimization --skill write-spec-nmoralescyber

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Converts vague ideas and user requests into structured, buildable feature specifications with clear scope, goals, non-goals, and acceptance criteria.

Core Features & Use Cases

  • Converts an idea or problem statement into a complete Spec document with sections like TL;DR, Problem, Goals, Non-goals, Success metrics, User stories, Acceptance criteria, and Phased scope.
  • Guides disciplined scoping to prevent feature creep and ensures alignment with roadmap and engineering kickoff.
  • Provides templates and guidance for documenting decisions, risks, dependencies, and design notes.

Quick Start

Provide a complete Spec for a feature by supplying a problem statement and desired outcomes.

Frequently Asked Questions about write-spec

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

FAQPage Schema
How do I write a product spec from a vague feature idea?

To write a product spec from a vague idea, you convert the initial problem statement into structured sections like TL;DR, goals, non-goals, success metrics, and phased scope. This process ensures disciplined scoping and prevents feature creep.

What should be included in a PRD for engineering kickoff?

A PRD for engineering kickoff should include a TL;DR, problem statement, goals, non-goals, success metrics, user stories, acceptance criteria, and a phased scope. Defining these elements ensures alignment across product, design, and engineering teams.

How do I define acceptance criteria for phased feature delivery?

Defining acceptance criteria for phased delivery involves breaking down the overall scope into sequential milestones and specifying the exact success conditions for each phase. This approach guides disciplined scoping and structured delivery across teams.

Why do I need non-goals in a feature specification?

Non-goals are needed in a feature specification to explicitly state what is out of scope, which prevents feature creep and maintains alignment with the roadmap. They help guide disciplined product decisions and manage team expectations.

Can I use spec writing to prevent feature creep across cross-functional teams?

Yes, you can use structured spec writing to prevent feature creep by converting vague requests into crisp documents with defined goals, non-goals, and phased scope. This ensures disciplined alignment across engineering, design, and product teams.

What is the best way to structure a spec document for product management?

The best way to structure a spec document is to include sections for TL;DR, Problem, Goals, Non-goals, Success metrics, User stories, Acceptance criteria, and Phased scope. This format produces a production-ready guide for engineering and design decisions.