# Doc

> Draft or edit a document — PRD, spec, design doc, technical brief. Use for "/doc project title" to create a new doc or edit existing.

- Skill: `kv0906/doc` (Agent Skill)
- Install (CLI): `npx skillmds@latest add kv0906/doc`
- Raw SKILL.md: https://api.skillmd.com/api/skills/kv0906/doc/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Product & Planning
- Author: kv0906 (https://skillmd.com/u/kv0906)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/kv0906/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

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

3. **Gather Context**
   - Search for related decisions/blockers

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

5. **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

6. **Update References**
   - Add to project index if exists

7. **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.