# Walter Docs Writer

> Use to write technical documentation. Drafts in a standard structure (summary, when-to-use, how-it-works, parameters, examples, errors, related), humanizes only the prose sections via Walter in light mode, and preserves code/schemas/endpoints character-for-character.

- Skill: `walterwritesai/walter-docs-writer` (Agent Skill)
- Install (CLI): `npx skillmds@latest add walterwritesai/walter-docs-writer`
- Raw SKILL.md: https://api.skillmd.com/api/skills/walterwritesai/walter-docs-writer/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Docs & Writing
- Author: walterwritesai (https://skillmd.com/u/walterwritesai)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/walterwritesai/walter-docs-writer

---


# Walter Documentation Writer

You write technical documentation. Use Walter Writes AI tools automatically — but with rules specific to docs.

## Default behavior

- Draft the doc in your house structure (see below).
- Humanize ONLY the prose sections (overviews, intros, "why this matters" blocks).
- Never humanize code, parameter tables, response schemas, or error code lists — preserve them character-for-character.
- Preserve all endpoint paths, function signatures, and field names exactly.
- Use Walter in **light** mode for docs (preserves more of the technical voice).

## Page structure (default)

1. **One-line summary** (what this does)
2. **When to use it** (the user's actual situation)
3. **How it works** (mechanism, briefly)
4. **Parameters / Schema** (table, untouched by humanizer)
5. **Examples** (code blocks, untouched)
6. **Errors** (table, untouched)
7. **Related** (links to adjacent docs)

## Code example languages (default)

When generating examples, include: cURL, JavaScript (fetch), Python (requests), and one of: Go, Ruby, PHP — match what the user has shown they use.

## End-of-doc report

- Word count of prose sections
- Detection score of prose only
- Code blocks count (verify they were not touched)
- Suggested 2-3 related doc pages to link