Guide · Agent skill
How to use the PRD Product Spec Template agent skill (pm-spec)
Updated · written with AI from the project's own documentation and checked against our catalogue data
The pm-spec skill is a template from the html-anything project that tells an agent how to lay out a one-page product requirements document (PRD). It is aimed at product managers, engineers, designers and founders who want a first draft of a feature spec in a consistent structure. After this guide you will know what the skill changes about the agent's output, how to install it, how to trigger it with a plain request, and what to check before you share the result.
Quick start
- 1Download the ZIP. Get the pm-spec ZIP from this page and unzip it.
- 2Place the folder. Move it into ~/.claude/skills/ for personal use or into the project's .claude/skills/ folder for one project.
- 3Or upload in the Claude apps. Go to Settings → Capabilities → Skills and upload the skill there.
- 4Ask for a PRD in plain language. Describe the feature, the user problem and any known numbers, and say you want a PRD or product spec.
- 5Check the draft. Verify every metric, target and claim against your own data before sharing.
- 6Replace placeholders. Swap the placeholder mockups for real designs and resolve the open questions in review.
What the pm-spec skill makes the agent produce
An agent skill is a set of instructions that an AI agent loads when it is relevant to a task. The pm-spec skill is a formatting template for a product requirements document. Its job is to guide how the agent writes the spec, so you get a consistent document rather than a free-form outline.
The layout the skill describes has these parts, in order: a title bar with a status pill (draft, approved or shipped), a Problem and Why now section, 3-5 success metrics, Scope split into in and out, user stories written as Given/When/Then, design notes with placeholder mockups, and a Rollout plan with Open questions.
- Status pill: draft, approved or shipped
- Problem and why it matters now
- Success metrics: 3-5 KPIs
- Scope: in and out
- User stories in Given/When/Then form
- Design notes with placeholder mockups
- Rollout plan and open questions
Install the pm-spec skill from the ZIP
Download the ZIP for the skill from this page and unzip it. You can install it in one of two places. For a personal setup, unzip it into ~/.claude/skills/. For a single project, unzip it into the project's .claude/skills/ folder. The skill ships as example.html and SKILL.md, and SKILL.md is the file that holds the instructions.
If you use the Claude apps instead, you can upload the skill there under Settings → Capabilities → Skills.
- Personal install: ~/.claude/skills/
- Project install: .claude/skills/ inside your project
- Claude apps: Settings → Capabilities → Skills
Trigger the skill with a natural request
You do not need a special command. Describe the document you want in plain language and mention that it is a PRD or product spec, so the agent knows to use the template. Include the feature, the user problem and any numbers you already have.
The skill only shapes the document. If you give it a vague brief, the spec will be well formatted but thin, so add context about who the users are and what success looks like.
- "Write a PRD for a bulk-export feature for our billing admins. Problem: they copy invoices one by one."
- "Draft a product spec for a lightweight onboarding checklist. Include success metrics and user stories."
- "Make a one-page spec for a dark mode toggle, status draft."
Review and check the output
Treat the output as a first draft. The template controls structure, not facts. The agent will not validate market data or metrics, so every number, target and claim in the spec must be checked by you before it goes to stakeholders.
Use the placeholder mockups as prompts for real design work rather than final visuals. Open questions are a useful part of the page: they show reviewers what is still undecided.
- Verify every metric and target against your own data
- Replace placeholder mockups with real designs
- Use Open questions as the agenda for your review meeting
What the skill needs and safety notes
The skill requires the html-anything project, since it is a template within that project. It does not run scripts and does not use the network, according to the source. Because it only contains instructions and an example file, there is no code to execute when you install it.
The skill is released under the Apache-2.0 licence.
- Requires: the html-anything project
- Runs scripts: no
- Uses network: no
- Licence: Apache-2.0
When this template is not the right fit
The template covers a one-page outline. It is not a full enterprise PRD and does not include legal, compliance or detailed technical architecture sections. If your process needs those, use a longer template or add the sections yourself.
Pick this skill for quick first drafts, shared requirement pages for review, and lightweight founder specs.
- Good fit: quick feature drafts, shared review pages, lightweight founder specs
- Poor fit: enterprise PRDs needing legal, compliance or architecture detail
What people use it for
- Drafting a first version of a feature spec for a product manager to refine
- Giving engineers and designers one structured page to review before building
- Writing a lightweight PRD for a new idea before committing to development
- Producing a consistent Given/When/Then set of user stories for a feature
Frequently asked questions
Is the pm-spec skill free?
The source says the skill is released under the Apache-2.0 licence. It is a template within the html-anything project, which the skill requires. Check that repository's licence file for the full terms.
What do I need to use pm-spec?
You need the html-anything project, since the skill is a template within it. You also need an agent that supports agent skills, and you install the skill by unzipping it into ~/.claude/skills/ or a project's .claude/skills/ folder, or by uploading it in Settings → Capabilities → Skills.
Does pm-spec run scripts or use the internet?
According to the source, the skill does not run scripts and does not use the network. It consists of SKILL.md and an example file that shape how the agent writes the document.
Where do I install the pm-spec skill?
Unzip it into ~/.claude/skills/ for personal use, or into .claude/skills/ inside a project for that project only. In the Claude apps, upload it under Settings → Capabilities → Skills.
Can pm-spec replace a full enterprise PRD?
No. The template covers a one-page outline and does not include legal, compliance or detailed technical architecture sections. It suits quick drafts and lightweight specs.
Does the skill check whether my metrics are realistic?
No. The template only shapes the document. The agent will not validate market data or metrics, so you need to check every number and claim yourself.
New agent skills, repos and AI tools — every week
The best new skills and open-source projects, the fastest-growing repos, and one free prompt. Five minutes to read. Unsubscribe anytime.
Our verdict
Use pm-spec if you need a quick, consistently structured first draft of a feature spec, or a shared page for engineers and designers to review. Pick a longer enterprise template if you need legal, compliance or detailed architecture sections, and remember that you must verify all numbers and claims yourself.
Download the skill