write-clearly
Draft, edit, proofread, audit, or apply human feedback to repository prose for clarity, reader fit, and voice while preserving meaning, source language, and format. Includes documentation and wording in UI, CLI, comments, and localization strings. Exclude authoritative verification-context authoring beyond wording-only edits; without explicit $verification-context invocation, that is ordinary repository work. Also exclude semantic source-comment audits, code-only work, translation-only requests, summarization, extraction, and factual verification. Poetry and fiction require explicit invocation.
- License
- MIT
Pinned to revision 245c10557848, so it is the text this page describes rather than whatever the author pushed since.
Files
- skills/write-clearly/SKILL.md
- skills/write-clearly/agents/openai.yaml
- skills/write-clearly/references/decision-model-and-fidelity.md
- skills/write-clearly/references/document-functions-and-profiles.md
- skills/write-clearly/references/editorial-diagnostics.md
- skills/write-clearly/references/formats-safety-and-review.md
- skills/write-clearly/references/google-developer-documentation.md
- skills/write-clearly/references/language-voice-and-accessibility.md
- skills/write-clearly/references/methods-sources-and-licenses.md
- skills/write-clearly/scripts/check_prose_fidelity.py
Every link opens the file at its source, pinned to the revision this page describes.