p:spec-design

Translate vague product ideas into a verifiable feature specification document.

1|Updated Jan 7, 2026
One-click install
npx skills add https://github.com/pontscho/prompt-heaven --skill p-spec-design
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: p:spec-design
Source: https://github.com/pontscho/prompt-heaven/tree/main/ClaudeCode/skills/p%3Aspec-design
Command: npx skills add https://github.com/pontscho/prompt-heaven --skill p-spec-design

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Maieutic specification designer helps users articulate and capture their intent as a complete feature specification, preventing invention of requirements or irrelevant assumptions.

Core Features & Use Cases

  • Conduct Socratic dialogue to surface user needs, goals, constraints, and rationale.
  • Produce a machine-readable feature specification ready for downstream planning (/p:feature-plan, /p:task-plan).
  • Surface open questions and gaps for explicit resolution, ensuring no premature commitments.

Quick Start

Describe your feature idea and I will guide you through the discovery dialogue to surface a complete spec.

Frequently Asked Questions about p:spec-design

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

FAQPage Schema
How do I turn a vague product idea into a verifiable feature specification?

To turn a vague product idea into a feature specification, a Socratic maieutic interview process surfaces user needs, constraints, and rationale without inventing requirements. This ensures the final spec accurately captures true intent.

What is the best way to write a feature spec without inventing irrelevant assumptions?

Using a maieutic specification designer is the best way to write a feature spec without inventing assumptions. It conducts a Socratic dialogue to explicitly surface open questions and gaps for resolution rather than making premature commitments.

How does a Socratic dialogue help create a complete product management feature spec?

A Socratic dialogue helps create a product management feature spec by systematically questioning the user to articulate their goals and constraints. This prevents invention and captures the exact rationale needed for a verifiable specification.

Can I use the generated feature specification directly with downstream planning tools?

Yes, you can use the generated feature specification directly with downstream planning tools. The process outputs a ready-to-use docs/feature-spec.md file specifically formatted for integration with /p:feature-plan and /p:task-plan.

How do I start the interview process to document my feature spec?

To start the interview process for documenting your feature spec, simply describe your feature idea. The system will then guide you through a discovery dialogue to surface a complete and verifiable specification.