# Doc Editing

> Use when editing documentation or long-form prose where consistency, clarity, and accuracy matter. Goal: produce clean publishable text without tone drift, structural churn, or meta commentary.

- Skill: `majiayu000/doc-editing-2` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds add majiayu000/doc-editing-2`
- Raw SKILL.md: https://api.skillmd.com/api/skills/majiayu000/doc-editing-2/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Docs & Writing
- Author: majiayu000 (https://skillmd.com/u/majiayu000)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/majiayu000/doc-editing-2

---


# Doc Editing

Edit documentation and substantial prose to be clear, accurate, and easy to scan. Write the document, not the editing process.

## Output Rules

* Optimize for clarity and correctness, then brevity.
* Preserve existing terminology and tone unless the request requires a change.
* Avoid narration, self-reference, and process notes inside the document.
* Prefer concrete statements over vague claims.

## Editing Workflow

1. Infer audience, purpose, and scope from the file and request.
2. Make the smallest structural change that improves comprehension.
3. Enforce local consistency: headings, tense, voice, terminology, formatting.
4. Remove redundancy and ambiguity; keep one idea per paragraph.
5. Keep emphasis proportional to importance; avoid a single section dominating without intent.
6. If required information is missing, proceed with safe edits and ask only the minimal questions needed for correctness.
7. Do not add change notes unless the user asks or reviewability clearly requires it.

## Markdown Guidance

* Keep headings short and parallel.
* Use short paragraphs and scannable lists.
* Avoid deep nesting.
* Use code blocks only for literal commands, snippets, or examples.

## Review Checklist

* Tone and terminology remain consistent.
* Structure changes are minimal and justified by clarity.
* No meta commentary or process narration appears in the document.
* Sections feel balanced; length matches importance.
* Markdown is scannable: short paragraphs, flat lists, and code blocks only for literals.