mcpField
P
pm-spec

pm-spec

github.com/mphinanceDocuments3284 installsUpdated 3d ago
Repository

About pm-spec

pm-spec is a skill for producing a one-page product specification or PRD from a brief and the active DESIGN.md. It structures the document as HTML with sections for the problem, goals, metrics, user stories, scope, and open questions.

Key features

  1. 01Reads the active DESIGN.md
  2. 02Organizes a one-page spec
  3. 03Defines goals and non-goals
  4. 04Adds success metrics and user stories
  5. 05Outputs semantic HTML

Use cases

  1. 01Turning a feature brief into a product spec
  2. 02Preparing a PRD for review
  3. 03Recording scope, milestones, and open questions

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/mphinance/alpha-skills --skill pm-spec

After installing, type/pm-specin Claude Code to confirm it loaded.

Bundled filesexample.htmlREADME.md

Details

From the project README

Product Spec Skill

Produce a one-page product spec / PRD.

Workflow

  1. Read the active DESIGN.md.
  2. Identify the feature + audience from the brief.
  3. Layout:
    • Header strip: title, status pill (Draft / Review / Approved), date, owner.
    • Three-line summary at the top — what, who, why now.
    • "Problem" panel with one paragraph and a quote from a customer or internal partner.
    • "Goals & non-goals" two-column block.
    • "Success metrics" table with metric / target / measurement.
    • "User stories" list with as-a / I-want / so-that format.
    • "Scope" milestone tracker (3–4 phases).
    • "Open questions" with assignee chips.
  4. One inline <style>, semantic HTML, accent used twice max.

Output contract

<artifact identifier="spec-name" type="text/html" title="Spec Title">
<!doctype html>...</artifact>

Comments

Markdown supported