pmai-doc-writing

Generates product direction memos, positioning statements, and introduction documents as Markdown deliverables.

4|Updated May 26, 2026
One-click install
npx skills add https://github.com/YYG501/PM-AI-Harness --skill pmai-doc-writing-yyg501
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: pmai-doc-writing
Source: https://github.com/YYG501/PM-AI-Harness/tree/main/skills/doc-writing
Command: npx skills add https://github.com/YYG501/PM-AI-Harness --skill pmai-doc-writing-yyg501

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Product managers often need to turn already-confirmed product judgments into polished direction memos, positioning statements, product introductions, feature lists, one-pagers, or executive briefing materials, but writing these from scratch is slow and prone to vague, slogan-heavy language. This Skill turns confirmed product decisions into structured, evidence-grounded Markdown documents under docs/deliverables/. ## Core Features & Use Cases - Multiple document types: Produces product direction memos, positioning statements, product introductions, feature lists, advantage statements, one-pagers, and decision/briefing materials, each with a fit-for-purpose structure. - Evidence-grounded writing: Reads the accepted proposal contract, PRODUCT.md, PRODUCT-STATE.md, and module specs so every key judgment traces back to a source, with unverified claims marked as assumptions. - Boundary enforcement: Redirects PRD and functional spec requests to /pmai-spec-writing and unresolved product direction questions to /pmai-proposal, keeping this Skill focused on expression rather than judgment. - Use Case: After confirming a product direction with stakeholders, ask for a one-page executive briefing; the Skill reads the current product baseline, drafts a judgment-first document with trade-offs and success metrics, writes it to docs/deliverables/, and updates the deliverables index. ## Quick Start Ask the assistant to write a product introduction one-pager for your confirmed product direction and save it to docs/deliverables/.

Frequently Asked Questions about pmai-doc-writing

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

FAQPage Schema
How do I write a product direction memo from confirmed decisions?

Invoke the doc-writing skill after your product direction is confirmed. It reads the accepted proposal, product state, and module specs, drafts a judgment-first memo with trade-offs and success metrics, and saves it as Markdown in docs/deliverables/.

What document types can this product writing skill generate?

It generates product direction memos, positioning statements, product introductions, feature lists, advantage statements, one-pagers, and decision or briefing materials. All outputs default to Markdown files under docs/deliverables/ with an updated index.

Can it write PRDs or functional specifications?

No. PRDs, functional requirements, feature descriptions, and review drafts are explicitly routed to the spec-writing skill. This skill only produces introductory and directional expression materials, never build-contract specifications.

Does it support exporting to PDF or Word formats?

It writes Markdown as the source of truth first. For PDF it delegates to the gstack make-pdf command, for docx it hands off to a document conversion skill, and for Feishu publishing it uses the publish-to-lark skill.

What happens if the product direction is not yet confirmed?

The skill stops and redirects to the proposal skill when the proposal contract status is invalid or product-level judgments are missing. It only expresses confirmed judgments and marks unverified claims as assumptions rather than conclusions.