Doc

/doc — Document Drafting

Create or edit documents (specs, PRDs, design docs, etc.).

Context

Today's date: !date +%Y-%m-%d Existing docs: !ls docs/*/*.md 2>/dev/null | tail -10

Reference template: @templates/doc.md Config: @core/config.yaml Processing logic: @_core/PROCESSING.md

Input

User input: $ARGUMENTS

Processing Steps

1. Parse Input

• Extract project
• Extract title/feature name

1. Check Existing

• Search docs/{project}/*.md for similar titles (or docs/general/*.md if no project)
• If found: Offer to edit or create new

1. Gather Context

• Search for related decisions/blockers

1. Interactive Drafting

• Prompt for each major section:
• Problem statement
• Goals / Non-goals
• Requirements (P0/P1/P2)
• Technical approach
• Or accept full content at once

1. Create Doc Note

• If no project specified: write to docs/general/{slug}.md
• If project specified: write to docs/{project}/{slug}.md
• Apply template with gathered data
• Status: draft
• Add ## Links section

1. Update References

• Add to project index if exists

1. Append to Vault Log

• Append entry to 01-index/_vault-log.md (see .claude/rules/vault-log.md)
• Action: doc
• Details: doc title and status

Output

Created: docs/{project}/{slug}.md
Status: draft
Sections: {filled}/{total}

Export (Optional)

Supports --docx, --pdf flags. See .claude/rules/export-formats.md for layout specs and workflow. Complete normal processing first, then generate the formatted file.

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: kv0906
• Source: kv0906/pm-kit
• License: MIT
• Homepage: https://willtran.xyz

Install and usage instructions live in the source repository linked above.