pm-spec-writing

Translate vague ideas into structured specs with acceptance criteria and verification steps.

523|69|Updated Apr 28, 2026
One-click install
npx skills add https://github.com/rampstackco/claude-skills --skill pm-spec-writing
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: pm-spec-writing
Source: https://github.com/rampstackco/claude-skills/tree/main/skills/pm-spec-writing
Command: npx skills add https://github.com/rampstackco/claude-skills --skill pm-spec-writing

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill helps product teams translate vague ideas into precise, actionable documents that guide engineers, designers, and QA throughout a project.

Core Features & Use Cases

  • Convert vague concepts into structured artifacts such as feature specs, PRDs, user stories, and acceptance criteria.
  • Generate multiple output formats (feature spec, dev brief, or bug report) depending on the scenario.
  • Assist with scoping, prioritization, risk, and success metrics to reduce backlogs and miscommunication.
  • Use cases include new feature specs, bug filing, scope planning, backlog refinement, and requirement breakdown.

Quick Start

Provide a one-sentence idea and ask the skill to produce a complete, actionable specification for engineers.

Frequently Asked Questions about pm-spec-writing

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

FAQPage Schema
How do I write user stories and acceptance criteria from a vague product idea?

To write user stories and acceptance criteria from a vague idea, define the problem statement first, then break it down into structured artifacts like dev briefs. This ensures engineering and QA teams have measurable delivery steps and clear scope definitions.

What is the best way to create a dev brief for a new feature?

The best way to create a dev brief for a new feature is to translate the concept into a structured specification. Include explicit problem statements, user stories, dependencies, and success metrics to guide engineers and reduce miscommunication throughout the project.

Can I use spec writing for backlog refinement and bug reporting?

Yes, you can use spec writing for backlog refinement and bug reporting. It generates multiple output formats depending on the scenario, translating ambiguous issues into precise bug reports or scoped backlog items with clear acceptance criteria.

How do acceptance criteria and success metrics improve product management delivery?

Acceptance criteria and success metrics improve product management delivery by providing explicit verification steps. This ensures measurable delivery, reduces backlogs caused by miscommunication, and gives engineering and QA teams a clear definition of done.

Does spec writing work for scoping features across different technology stacks?

Spec writing works for scoping features across any technology stack. It focuses on structuring the problem statement, user stories, and dependencies rather than implementation details, making it applicable to diverse software projects and bug reports.