PluginInstalls cleanly

Write in plain, clear English

ISO 24495 Plain Language Skills

Seven skills that make your assistant write short, clear text and check your documents for plain language, based on the ISO 24495 series (unofficial).

Works with
Claude Code, Codex CLI
Good for
Daily work and research

What it does

Plain language means writing that your reader understands the first time: short sentences, active voice, clear headings and no padding. ISO 24495 is an international standard series about plain language. This plugin by Gareth Williams turns its public principles into seven skills (instruction files) for your assistant. Version 0.7.0 came out on 27 September 2026.

It is unofficial. It is not affiliated with or approved by ISO. Nothing it produces is a statement of ISO conformance, and no certification scheme exists (README).

Read this first. Once installed, the core skill (iso-24495-1) shapes every answer the assistant writes for you. Its description says it "governs all user-facing responses", and it switches on other skills by itself (README). If you want only some texts in plain language, keep that in mind before you install it.

The other skills cover special jobs:

  • Legal text (iso-24495-2), such as contracts and policies. It rewrites wording and structure and tries to keep the legal meaning, but it is not legal advice. Have a lawyer check important contracts.
  • Technical documents and long documents that need a clear structure.
  • Code (iso-24495-code). It renames things and changes comments and error messages in code the assistant writes.
  • An organisation audit (iso-24495-4). It writes report files (evidence.json, findings.json, maturity.json, gap-report.md) and a state.json file that it keeps adding to, all in your project.

The skills for Parts 4 and 5 are provisional. They are based on ISO drafts that are not published yet (README).

One skill checks your own files. You choose a Markdown or text file or a folder, and it lists problems such as very long sentences, undefined abbreviations, wordy phrases, or links that say only "click here". It does not change your text, and it runs only when you call it.

The text audit and the organisation audit run TypeScript tools with Bun, a program you must install yourself (README). In Claude Code, the plugin also adds an output style called ISO 24495. In Codex, you get an extra style skill called iso-24495-style.

Who it is for

People who write emails, policies, guides or documentation and want clear text that readers understand the first time.

Example prompts

  • "Apply iso-24495-1 to this email and make it shorter."
  • "Apply iso-24495-2 to this licence text."
  • "Rewrite this README section so a beginner can follow it."
  • "/iso-24495-plain-language:iso-24495-text-audit docs/policy.md"

How to install

/plugin marketplace add https://github.com/GaZmagik/iso-24495.git
/plugin install iso-24495-plain-language@iso-24495
codex plugin marketplace add https://github.com/GaZmagik/iso-24495.git
codex plugin add iso-24495-plain-language@iso-24495

How to use it

Ask: Apply iso-24495-1 to this email. To check a file, type /iso-24495-plain-language:iso-24495-text-audit docs/policy.md. In Claude Code you can also pick the ISO 24495 style with /output-style.

Check it works

  1. In Claude Code, run /plugin and look for iso-24495-plain-language in the installed list.
  2. Run /output-style. The ISO 24495 style should be in the list.
  3. In Codex, call a skill by name, for example $iso-24495-1 (README).

Common problems

  • The marketplace add fails with a GitHub SSH error — no exact error text in the README — some Claude Code versions clone the short owner/repo form over SSH. Use the full HTTPS address shown in the install lines (README).
  • The text audit does not run — no exact error text — it requires Bun. Install Bun from bun.sh first (README).
  • Codex does not follow the style in every reply — no error text — Codex has no output styles. Add the line Apply `iso-24495-style` to every response. to your AGENTS.md (README).

What to watch out for

  • Unofficial: not affiliated with or approved by ISO, and nothing it produces is a statement of ISO conformance (README)
  • Once installed, the core skill shapes every answer the assistant writes, and the code skill changes names, comments and error messages in code it writes (SKILL.md files)
  • The text audit and the organisation audit (iso-24495-4) run TypeScript tools with Bun, which you must install yourself (README)
  • The organisation audit writes report and state files into your project (iso-24495-4 SKILL.md)
  • The skills for Parts 4 and 5 are provisional, based on ISO drafts that are not published yet (README)
  • The legal writing skill rewrites wording and structure and tries to keep the legal meaning, but it is not legal advice; have a lawyer check important contracts

Licence and author

Licence
MIT
Author
Gareth Williams (GaZmagik)
Source code
github.com/GaZmagik/iso-24495

How we tested it

We installed it on an empty test computer on 18 Oct 2026. Installed and started in a clean test system. Not yet used in a real AI session.

Test level

Not run: "codex plugin marketplace add https://github.com/GaZmagik/iso-24495.git" (not a form the sandbox runs). Not run: "codex plugin add iso-24495-plain-language@iso-24495" (not a form the sandbox runs). The two Codex lines are in the README and the Codex CLI source (release rust-v0.163.0) but not on the Codex docs page. Not yet used on real work.

Technical details of the test
Date
18 Oct 2026
Method
Intake sandbox run on 2026-10-18 in a clean container with no account: cloned the repository and checked its skill, agent and plugin files; installed iso-24495-plain-language@iso-24495 with the Claude Code command line.

Checked again on 18 Oct 2026

Alternatives

  • Humanizer — removes signs of AI writing; this plugin aims for clarity and structure.
  • work-humanizer — rewrites work messages in a natural voice.
  • Marketing Skills — copywriting for marketing, not plain-language rules.

FAQ

Does it make my document ISO compliant? No. The README says no certification exists and nothing it produces states conformance.

Does it change my files on its own? The text audit only reports; it never changes the selected text (README). The organisation audit writes its own report files into your project.

Is the legal skill legal advice? No. It tries to keep the legal meaning, but it is not legal advice. Have a lawyer check important contracts.

Does it need an account or key? No. The skills and audit scripts make no network calls.

Does it work in Gemini CLI? The README covers Claude Code and Codex only.

Is it in Anthropic's directory? No. You install it from the author's own marketplace with the lines above. That marketplace pins version 0.7.0.

Sources