plain-language-iso-24495listed

Write documents that conform to ISO 24495-1:2023 (Plain Language — Governing principles and guidelines). Use when the user asks for a document, memo, proposal, RFC, PRD, design doc, runbook, postmortem, one-pager, or explanation to be written in "plain language", "clear language", "accessible language", or "ISO 24495"; when they ask a document to be understandable by a mixed or non-specialist audience; when they ask to make an existing document clearer, more readable, or easier to scan; when they mention audiences like legal, executive, or cross-functional stakeholders who need to skim and decide; or when they ask to reduce jargon.
nikdumroese/plain-language-skill · ★ 2 · AI & Automation · score 70

Install: claude install-skill nikdumroese/plain-language-skill

# Plain language (ISO 24495-1:2023) Apply the four principles to every document: **Relevant**, **Findable**, **Understandable**, **Usable**. Readers must be able to find what they need, understand it, and use it. The workflow below is a loop, not a checklist. If new reader information appears at step 3, return to step 1. ## References Load on demand: - `references/principles.md` — full principles and guidelines. - `references/checklist.md` — 42-item pre-flight review. - `references/reader-test.md` — reader evaluation. External docs only; skip for internal memos. - `assets/template.md` — starting shape for the output. Use it as the default structure. ## Step 1 — Identify readers and format (Principle 1) Before drafting, know: - **Readers:** roles or teams. If several, name the **primary** audience. - **Purpose:** what they must do after reading (decide, approve, act, learn). - **Prior knowledge:** what they know; adjust vocabulary. - **Reading context:** phone, desktop, meeting, Slack link. - **Time available.** - **Language:** confirm before drafting in English if the reader group is not native. - **Format:** a video, form, FAQ, or dashboard may serve better than prose. Ethics: accurate content, no misleading claims, no hidden content the reader needs. If any of the above is missing, ask one focused question before drafting. Do not skip. ## Step 2 — Structure for findability (Principle 2) - The most important message goes at the top. The reader knows the ask, deci