writing-prds

The `writing-prds` skill assists users in crafting effective product requirements documents (PRDs), addressing the common challenge of translating ideas into actionable and clear product specifications. It focuses on guiding users to start with the problem, articulate success criteria, and prioritize outcomes over exhaustive detail. By emphasizing the 'why' behind features and investments, it ensures teams are aligned on the purpose and urgency of the product initiatives. This skill is particularly valuable for product managers, engineers, and teams seeking to document, communicate, and implement product features efficiently.

The skill provides structured guidance through core principles drawn from experienced product leaders. It helps users define the problem context, leverage PR/FAQ formats for clarity, create interactive demos or prototypes, and establish executable evaluations for AI products. It emphasizes keeping PRDs lightweight, actionable, and of high quality while using AI to scaffold basic structures like user stories or out-of-scope items. Additionally, it prompts users with critical questions, including metrics for success, scope boundaries, customer impact, and prototyping options, to prevent common pitfalls such as starting with solutions or overloading with unnecessary details.

Typical use cases include preparing PRDs for new product features, defining specifications for engineering teams, creating feature briefs, or documenting requirements for cross-functional teams. Target users are product managers, AI product designers, engineers, and anyone responsible for guiding the team on what to build and why. By providing structured frameworks, practical questions, and guidance on maintaining clarity and impact, this skill enables teams to move from conceptual ideas to executable product plans effectively.