writing-product-specs

Write structured product specification documents through interactive requirements elicitation.

5|Updated Nov 9, 2025
One-click install
npx skills add https://github.com/britt/agent-skills --skill writing-product-specs-britt
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: writing-product-specs
Source: https://github.com/britt/agent-skills/tree/main/skills/writing-product-specs
Command: npx skills add https://github.com/britt/agent-skills --skill writing-product-specs-britt

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Turning a vague feature idea into a complete product spec or PRD is hard: key context like audience, success criteria, and scope boundaries often goes undocumented, leaving engineers and stakeholders misaligned. This Skill guides an interactive elicitation process and produces a structured spec file covering the problem, audience, requirements, and tradeoffs. ## Core Features & Use Cases - Interactive Elicitation: Asks targeted questions about the problem, audience, benefits, success and failure indicators, and explicit non-goals before drafting anything. - Structured Spec Template: Drafts the document using a defined template with sections for Background, Hypothesis, Success Criteria, Requirements, Non-requirements, and Tradeoffs. - Iterative Refinement and Saving: Revises the draft based on feedback and saves the final result as a dated markdown file like spec-<feature-name>-MM-DD-YYYY.md. - Use Case: A product manager asks to spec a new notifications feature; the Skill interviews them about users and success metrics, drafts a full PRD, iterates on feedback, and saves the final document. ## Quick Start Ask the assistant to write a product spec for your new feature idea and answer its questions about the problem, audience, and success criteria.

Frequently Asked Questions about writing-product-specs

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

FAQPage Schema
How do I write a product requirements document with an AI assistant?▼

Ask the assistant to write a product spec for your feature. It will interview you about the problem, audience, benefits, and success criteria, then draft a structured PRD, iterate on your feedback, and save it as a markdown file.

What sections should a product spec include?▼

The template includes a title with summary, Background (context, audience, problem statements), Hypothesis, Success Criteria, Requirements, Non-requirements, and Tradeoffs and concerns. Each section has guidance on what to write.

What is the difference between a product spec and an implementation plan?▼

A product spec describes what to build and why: the problem, audience, requirements, and success criteria. It explicitly does not cover step-by-step engineering work, which belongs in a separate implementation plan.

When should I not use a product spec workflow?▼

Skip it when you need an implementation plan rather than a requirements document, or when the work is a small bug fix or change that does not need stakeholder-facing context, success criteria, or scope definition.

How are finished product specs saved and named?▼

Once you confirm the draft is complete, the spec is saved as a markdown file named spec-<feature-name>-MM-DD-YYYY.md, or under a different filename if you request one.