edit-for-readability
FeaturedApplies Han's shared Human-Readable Output Standard to a target you already have — a file on disk, text pasted into the prompt, or a draft already produced in the conversation — by dispatching the readability-editor to rewrite its prose so the main point comes first, headings are descriptive, each paragraph carries one idea, and sentences stay short and active, while preserving every fact. Use when you want to make a document or draft readable, edit or polish prose for readability, clean up writing, tighten wording, or re-apply the readability standard to something already written. Rewrites prose only, leaving code, diagrams, and citation identifiers unchanged. Does not write new feature or system documentation — use project-documentation. Does not restructure code or review it — use refactor to restructure code and code-review to audit it. Does not judge the underlying work or raise findings; it only rewrites the writing.
Install
Quality Score: 91/100
Skill Content
Details
- Author
- testdouble
- Repository
- testdouble/han
- Created
- 4 months ago
- Last Updated
- 2 days ago
- Language
- Shell
- License
- MIT
Bundled in these plugins
Similar Skills
Semantically similar based on skill content — not just same category
readability-guidance
Surfaces Han's shared Human-Readable Output Standard — the readability rule and the writing-voice profile — into the calling skill's own context, so the caller drafts in voice and runs its self-check against the current standard sourced from one canonical copy. Use when a prose-producing skill needs the shared readability standard available in context before it drafts. Governs the shape of a written deliverable, where explanation-guidance governs what a run says to a person in a turn. Runs in the caller's context and hands control straight back; it does not produce a deliverable of its own, rewrite anything, or judge the caller's work. Does not run the adversarial rewrite pass — dispatch the readability-editor agent for that, or use edit-for-readability to rewrite an existing target. Does not cover explaining technical work to a reader who will not implement it — use explanation-guidance for that.
edit
Refine an existing draft to read as easily as its ideas allow — at the grade the content earns, never below the floor your audience expects, never inflated above it. Runs a diagnose→propose→refine→gate-check methodology: shells out to the deterministic readability_diag.py for the countable flags (does NOT recompute them), judges intrinsic-vs-extraneous load, proposes refine moves with a floor/ceiling check, and on --apply runs the gate it can't game (meaning-preservation held outside the rewriter). Read-only default; --apply refines + gates. Voice-neutral; composes with a defect/AI-pattern linter and a content-drafting skill. TRIGGER when: user says "edit this for readability", "make this read easier", "reduce reading effort", "tighten this prose", "readability pass", "refine for clarity". DO NOT TRIGGER when: user wants a defect / AI-pattern / brand check (use a linter); to draft net-new content (use a content-authoring approach); a named-recipient message; or a literal file edit (use the editor directly).
write
Rewrites and polishes prose in Chinese or English, removes AI-like wording, and reviews product localization copy while preserving intent for drafts, docs, release notes, launch copy, and social posts. Use when users ask in any language to draft, rewrite, proofread, localize, polish release notes, remove AI-like wording, or prepare launch and social copy. Not for code comments, commit messages, or inline docs.