plain-language
Installation
SKILL.md
Audit project prose against the pl-01..pl-33 rule catalog and produce one findings document with verified rewrites. This skill is read-only over the reviewed files: it recommends, it never edits. The state file is for your own resumability, not human review.
Mirror the four phases below in the host's todo tool so the user sees progress.
Non-negotiables (read first)
- Never modify reviewed files. Findings and rewrites go in the plan document only.
- Explicit invocation only. This skill runs when the user invokes
/plain-language— never auto-activate. - Classify every finding FALSIFIABLE (cites exact prose on a specific line that Grep can confirm) or OPINION (tone, audience fit, ambiguity — interpretation-dependent).
- Grep-verify every FALSIFIABLE citation against the cited file before it enters the draft. No match → drop the finding and count it as a dropped hallucination.
- One output file. The consolidated plan is the single user-facing artifact; your end-of-run reply names only its path, never the state file or intermediate details.