product-description

Create feature-by-feature product behavior documentation from source code, tests, and live verification.

2|Updated Sep 14, 2026
One-click install
npx skills add https://github.com/kwanpham2195/agent-stuff --skill product-description-kwanpham2195
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: product-description
Source: https://github.com/kwanpham2195/agent-stuff/tree/main/skills/product-description
Command: npx skills add https://github.com/kwanpham2195/agent-stuff --skill product-description-kwanpham2195

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Product behavior is usually defined implicitly across state machines, handlers, and tests, with no single plain-language source describing what users see and can do. This Skill produces a complete behavior-spec repository that documents the product as a state chart, feature by feature, from the user's point of view. ## Core Features & Use Cases - Structured documentation pipeline: A six-phase workflow (scope, scaffold, pilot, parallel drafting, consistency pass, verification) that produces README, glossary, goal, feature documents, verification checklists, and a bug-triage file on one shared skeleton. - Product-kind adaptation: Reference guidance maps the template onto canvas editors, form-based web apps, CLIs, and chat products by fixing the unit of interaction, variant axis, interrupt list, and cross-cutting concerns. - Verification and defect triage: Generates hand-verification checklists with stable IDs and priorities, plus a deduplicated bug-triage file with severity, root cause, and decisions needed; includes a link and anchor checker script. - Use Case: Point the Skill at a web app's source repo and request a product-description repository; it drafts per-feature documents from code and tests, then verifies claims against the running product and collects suspected defects into bug-triage.md. ## Quick Start Create a product-description repository for the app in ./src, documenting each feature's behavior from the code and tests and verifying it against the running product.

Frequently Asked Questions about product-description

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

FAQPage Schema
How do I document product behavior from source code?▼

Read the interaction state (state machines, reducers, handlers) and behavior tests, then draft one document per feature on a fixed eight-section skeleton covering phases, modifiers, interrupts, and edge cases. Verify claims afterward against the running product.

What is a product description repository?▼

It is a documentation repo treating the product as a state chart, with a README, glossary, goal file, one document per feature on a shared skeleton, verification checklists, and a bug-triage file collecting every suspected defect with repro steps and severity.

Does this approach work for CLIs and chat products?▼

Yes. The product-kinds reference maps the template onto pointer-driven editors, form-and-page web apps, command-line tools, and chat or agent products by redefining the unit of interaction, variant axis, interrupt list, and cross-cutting concerns for each.

How are suspected bugs handled during documentation?▼

Every suspected defect from document bodies and open questions is collected into bug-triage.md, deduplicated by root cause, and written up with reproduction steps, the cause in the code with file and line, a severity, and the decision the product team needs.

Can I extend an existing product description repo later?▼

Yes. A later session reads AGENTS.md, README, goal.md, and glossary, confirms the source commit, then adds documents by updating the structure and coverage table first, adding checklist rows with new ID prefixes, and appending triage entries without renumbering existing IDs.