define-product

Interview users to define product direction and write it to PRODUCT.md.

Updated Sep 17, 2026
One-click install
npx skills add https://github.com/hkw2028/toy-project --skill define-product-hkw2028
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: define-product
Source: https://github.com/hkw2028/toy-project/tree/main/.agents/skills/define-product
Command: npx skills add https://github.com/hkw2028/toy-project --skill define-product-hkw2028

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Product intent often lives only in scattered conversations, so teams lose track of who the app serves, what problem it solves, and what it promises. This Skill runs a structured interview to draw out that product meaning and preserves the confirmed direction in a single root PRODUCT.md file. ## Core Features & Use Cases - Guided product interview: Asks open, non-leading questions about users, situations, problems, current alternatives, promised change, core loop, boundaries, experience principles, and success signals without inventing answers. - Confirmed definition writing: Creates or updates root PRODUCT.md in place using a standard product context format, keeping it free of technology, architecture, and feature-spec detail. - Decision state tracking: Distinguishes confirmed meaning, delegated choices, accepted assumptions, and intentional unknowns so later work never mistakes a guess for intent. - Use Case: A founder says "an app that turns web pages into Markdown for LLMs." The Skill interviews them about real usage scenes, then writes a complete PRODUCT.md once the direction is confirmed. ## Quick Start Ask the assistant to use define-product to interview you about your app direction and create PRODUCT.md after you confirm the product meaning.

Frequently Asked Questions about define-product

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

FAQPage Schema
How do I define a product direction for a new app?

Provide at least a rough audience, situation, problem, or solution direction, then answer a short interview about real usage scenes. Once the central meaning is confirmed, the Skill writes a complete PRODUCT.md at the repository root.

What should a PRODUCT.md product definition file contain?

A PRODUCT.md contains a one-sentence definition, users and situations, problem and current alternatives, promised change, core loop, capabilities and boundaries, experience principles, success signals, and assumptions or unknowns. It excludes technology, architecture, and feature-level specs.

Can I update an existing PRODUCT.md when the target audience changes?

Yes. The Skill reads the current PRODUCT.md, applies only the confirmed changes such as a new audience or ownership, and rewrites the file in place without creating dated versions or preserving obsolete meaning.

When should I not use a product definition interview?

Do not use it for blank-page idea discovery with no direction, architecture decisions, or shaping a single feature into an implementable spec. Those cases belong to ideation, technical design, or work-unit specification workflows.

What happens if I have no app idea or direction yet?

The Skill requires at least one rough direction seed and stops without one. It does not mine your repository or notes to manufacture ideas, and it will not create PRODUCT.md from an invented premise.