Agent skill

Plain Language for Legal Text

by GaZmagik in GaZmagik/iso-24495

Applies ISO 24495-2 style plain-language rules to contracts and legal writing, standardizing modal verbs without weakening enforceability.

MITAuto-check passedWriting & Content

Install Plain Language for Legal Text

skills CLI
$ npx skills add GaZmagik/iso-24495 --skill iso-24495-2 -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install GaZmagik/iso-24495 iso-24495-2 --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/GaZmagik/iso-24495.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/iso-24495-2 .claude/skills/iso-24495-2 && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
iso-24495-2
GitHub stars
190
Token cost
~2.4k tokens
SKILL.md length
1,336 words
Files
2
Skills in repo
8
Repo updated
First seen
Licence
MIT

At a glance

Applies ISO 24495-2 style plain-language rules to contracts and legal writing, standardizing modal verbs without weakening enforceability.

  • Works in 3 steps: Thinking Block Exemption → Legal Enforceability Primacy → Document Design Applies Here Too
  • Drafting a contract clause in plain language
  • SKILL.md covers Scope & Execution Boundaries, Quantitative Rules & Hard…, Contrastive Examples and Pre-Output Self-Audit Checklist
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Framed as the project's own proxy for the standard's principles rather than its literal text, this extends a plain-language base skill for contracts, licenses and regulatory writing. Internal reasoning inside thinking blocks is fully exempt from the style rules, but legal enforceability always wins: a term of art required to avoid ambiguity is kept and explained in plain language rather than cut.

It loads alongside a separate document-design skill that already covers headings and navigation, so this one focuses on what that leaves out: defined terms, cross-references, clause identifiers and a summary layer. Hard rules include standardizing on must, must not and may for obligations, prohibitions and permissions, naming the subject actor explicitly in every obligation sentence, banning words like shall, hereby and hereinafter, and formatting multi-condition clauses as trigger, obligation and consequence lists.

When your agent uses it

  • Drafting a contract clause in plain language
  • Reviewing a license agreement for archaic legal phrasing
  • Rewriting a compliance policy so obligations are explicit

Example prompts

  • “Rewrite this termination clause so the obligations are explicit and plain.”
  • “Check this contract for banned words like 'hereby' and 'shall'.”
  • “Format this multi-condition clause as trigger, obligation and consequence.”

Workflow steps

3 steps, taken from the first numbered list in SKILL.md.

  1. Thinking Block Exemption
  2. Legal Enforceability Primacy
  3. Document Design Applies Here Too

What it can do on your machine

Read from SKILL.md and the folder at commit 5951eb7. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Plain Language for Legal Text loads about 2.4k tokens when it runs. Until then it costs about 44 tokens; SKILL.md has 1,336 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~44
When it runs · the whole SKILL.md, loaded when a task matches
~2.4k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from GaZmagik/iso-24495 at commit 5951eb7, republished under its MIT licence (© GaZmagik). 1,336 words, ~2,432 tokens.

Download SKILL.mdSave it as .claude/skills/iso-24495-2/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
iso-24495-2
description
Sector-specific Plain Language standard for legal communication (ISO 24495-2:2025). Applied during contract drafting, license review, and legal/compliance writing.
metadata.version
0.7.0
metadata.iso-standard
ISO 24495-2:2025
metadata.iso-status
published

Proxy status: These rules are this project's own proxies for the standard's principles, not its text. Following them is never a claim of ISO conformance.

Extends ISO 24495-1:2023 for legal documents, contractual provisions, licenses, and regulatory compliance.

Scope & Execution Boundaries

  1. Thinking Block Exemption:

    • Internal reasoning and legal analysis within thinking blocks (the thought and thinking tags) are 100% exempt from plain language constraints.
    • Reason exhaustively within thinking blocks. Apply plain language rules strictly to final user-facing legal text.
  2. Legal Enforceability Primacy:

    • Plain language simplification must never alter legal rights, liabilities, or contractual enforceability. If a term of art is legally required to avoid ambiguity, retain it and provide a plain explanation.
  3. Document Design Applies Here Too:

    • A legal document is a document, so iso-24495-5 loads alongside this skill. Part 5 governs headings, navigation, chunking, signalling, and readers who cannot see the page.
    • Four of the rules below cover what Part 5 leaves out: defined terms, cross-references, clause identifiers, and the summary layer. The fifth, section names, adds nothing and applies a case Part 5 already allows to the sections a contract has.
    • Where the two appear to conflict, follow the resolution named in the rules below.

Quantitative Rules & Hard Constraints (User-Facing Output)

  1. Modal Verb Standardisation:

    • Use must for mandatory obligations ("The User must pay...").
    • Use must not for prohibitions ("The User must not copy...").
    • Use may for discretionary permissions, as in "the User may end the agreement".
    • Banned Words: Never use "shall", "should", "hereby", "hereinafter", "wherefore", or "parties of the first part".
  2. Explicit Subject Actor Identification:

    • Every obligation sentence MUST explicitly name the subject actor ("The Licensee must notify..." rather than "Notice must be provided...").
  3. Conditional Clause Formatting:

    • Format multi-condition legal clauses as structured itemised lists:
      • Trigger / Prerequisite: What condition initiates the rule.
      • Obligation / Action: What action must or may be taken.
      • Consequence: What occurs upon non-compliance.
  4. Defined Terms:

    • Define each term once, and use it unchanged everywhere after. Two words for one concept invite an argument that they mean two things.
    • Put the definition where the reader first meets the term. Where a term appears in more than one section, collect the definitions in one section and point the first use at it.
    • Write a term out in full where the document uses it once, rather than defining it.
    • Say in words that a term is defined, and where. Capital letters are silent to a listener, so Confidential Information on its own tells them nothing.
  5. Cross-References:

    • Name what the referenced clause says, alongside its identifier. Write "the notice deadline in clause 4.2" rather than "clause 4.2".
    • Keep that wording identical to the referenced clause's own heading or opening line.
    • When you point at an obligation, point at the clause carrying it, never at one that only points somewhere else. A first use pointing at the collected definitions is the exception rule 4 requires, because a definition binds nobody.
  6. Clause Identifiers:

    • Number every operative clause, because a reader, a court and a counterparty must all cite the same thing. An operative clause imposes, permits or prohibits an action. Recitals, definitions and schedules are numbered by the conventions of the document, not by this rule.
    • Write the identifier into the clause text rather than as list markup. Markdown numbers an ordered list 1, 2, 3, so a compound identifier such as 4.2.1 survives only when it is written in the text.
    • This is the one place a legal document departs from Part 5's rule that a sequence stays an ordered list.
    • A clause identifier is neither a heading nor list numbering. So it does not count against Part 5's heading limit, and Part 5's rule on numbering headings does not govern it.
    • Keep an identifier for the life of the document. An amendment adds a clause, or marks one deleted, and leaves every existing number where it is, because filings, correspondence and other contracts cite those numbers.
  7. The Summary Layer:

    • Place a plain summary of the terms the reader must act on directly after Part 5's opening block. Give it the overview's own heading, because a summary of what a reader must act on is the conclusion they need before the detail, which is what Part 5 labels. Cover what they must do, what they must pay, when the agreement ends, and how to leave it. A document without one or more of those, such as a privacy policy with no payment, covers the rest. A document with no terms the reader must act on needs no summary of this shape, and Part 5 still decides whether it has an overview.
    • The summary must state that the operative text governs, and must name where that text starts. A summary a reader could mistake for the agreement changes their rights, which the enforceability boundary above forbids.
    • The summary must not add an obligation, newly qualify one, or leave a reader believing an obligation is gone. Where the operative text already qualifies a term, state the term together with that qualification, which Part 5 requires the overview to keep. Where stating it would take more words than the clause itself, leave the term out and point to its clause. A pointer keeps the obligation reachable, so it is not a removal.
    • Map the document onto Part 5's three levels of detail. The summary is the overview, and the operative terms are the main body. Place each schedule by what it holds, because Part 5's optional detail is for what only some readers need. A schedule carrying an obligation, a payment or a limit belongs in the main body with the rest of the operative terms, whichever page it is printed on. Reserve the optional level for a schedule a reader can skip and still comply, such as a list of contacts or a specimen form.
  8. Section Names:

    • A contract's section names are the reference case Part 5 already allows, and not a new exception. A reader jumps to Payment, Termination or Liability by subject, so each keeps its subject as its name.

Show full SKILL.md (409 more words)Show less

Contrastive Examples

Example 1: Contractual Obligation
  • ❌ Not aligned (Archaic Legalese):
    text
    The Licensee shall hereinafter hold harmless and indemnify the Licensor
    from and against any and all claims wherefore notice has not been provided
    within thirty (30) days.
  • ✅ ISO 24495-2 Aligned:

    Indemnification Notice Requirement:

    1. Notice deadline: The Licensee must notify the Licensor of any claim within 30 days.
    2. Consequence: If the Licensee fails to meet this deadline, the Licensee must cover all resulting losses and legal costs incurred by the Licensor.
Example 2: The Summary Layer
  • ❌ Not aligned (the summary drops conditions in the source clause):
    text
    9.1 The Customer may terminate this Agreement by giving the Supplier at
        least 30 days' written notice. If the Customer does so, the Supplier
        must refund to the Customer the fees paid for the part of the term
        that has not yet run. The refund is calculated pro rata.
    
    Summary: You can end the Agreement and get your money back.
  • ✅ ISO 24495-2 Aligned:

    Summary of your main terms

    The operative text starts at clause 9.1 below, and it governs.

    • Ending the Agreement: You may end this Agreement by giving the Supplier at least 30 days' written notice.
    • Refund: If you do, the Supplier must refund you the fees paid for the part of the term that has not yet run, calculated pro rata.
    text
    9.1 The Customer may terminate this Agreement by giving the Supplier at
        least 30 days' written notice. If the Customer does so, the Supplier
        must refund to the Customer the fees paid for the part of the term
        that has not yet run. The refund is calculated pro rata.

Pre-Output Self-Audit Checklist

Before outputting legal text, audit against these checks:

  • No legalese: Are terms like "shall", "hereinafter", and "hereby" eliminated?
  • Modal verbs: Are obligations expressed using only must, must not, or may?
  • Explicit subjects: Is every obligation attached to a clearly named actor?
  • Structured clauses: Are complex conditions presented as itemised lists?
  • Legal accuracy: Is legal enforceability preserved?
  • Defined terms: Is each term defined once, used unchanged, and reachable from its first use?
  • Cross-references: Does each name what the clause says, as well as its identifier?
  • Identifiers: Is every operative clause numbered, with existing numbers untouched by amendment?
  • Summary: Does it name the governing text, and add, qualify and remove nothing?
  • Section names: Does each name the subject a reader would look for?
  • Design applied: Did iso-24495-5 run over the document as well as this skill?

© GaZmagik, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 1 other file in skills/iso-24495-2 of GaZmagik/iso-24495.

  • SKILL.md
  • agents/openai.yaml

Open the folder on GitHubat commit 5951eb7

Compare with similar skills

Plain Language for Legal Text next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Plain Language for Legal Text compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Plain Language for Legal Text this skillGaZmagik/iso-24495190—~2.4kAutomated safety check: PassMIT
Contract Red Flagsmohitagw15856/pm-claude-skills1.4k—~1.1kAutomated safety check: PassMIT
Clause Explainermohitagw15856/pm-claude-skills1.4k—~731Automated safety check: PassMIT
Custom Nda Generatorzubair-trabzada/ai-legal-claude1.8k—~2.9kAutomated safety check: PassNone
Legal Design Assessmentlawve-ai/awesome-legal-skills847—~3.7kAutomated safety check: PassCC-BY-4.0
Contractsericrisco/rsc-harness180—~2.9kAutomated safety check: PassMIT

Similar skills

  • Contract Red Flags

    mohitagw15856/pm-claude-skills

    Scan a contract you're about to sign in plain language — surface the clauses that could bite you, what they mean, and what to question or renegotiate.

    1.4k GitHub stars~1.1k tokensUpdated 2 days ago
    Writing & ContentAuto-check passed
  • Clause Explainer

    mohitagw15856/pm-claude-skills

    Explain a contract clause in plain English — what it means, who it favours, the realistic risk, and what to negotiate.

    1.4k GitHub stars~731 tokensUpdated 2 days ago
    Legal & ComplianceAuto-check passed
  • Custom Nda Generator

    zubair-trabzada/ai-legal-claude

    Generates a complete, customized Non-Disclosure Agreement with plain English annotations, tailored to the specific parties and situation

    1.8k GitHub stars~2.9k tokensUpdated 6 mo ago
    Legal & ComplianceAuto-check passed
  • Legal Design Assessment

    lawve-ai/awesome-legal-skills

    Audits a legal document against legal design principles. An agent skill from lawve-ai/awesome-legal-skills.

    847 GitHub stars~3.7k tokensUpdated 8 days ago
    Legal & ComplianceAuto-check passed
  • Contracts

    ericrisco/rsc-harness

    A skill your agent uses when drafting or reviewing business contracts and clauses in plain language — NDAs, MSAs, SOWs, contractor agreements, risk boilerplate (liability caps, indemnity, force…

    180 GitHub stars~2.9k tokensUpdated yesterday
    Legal & ComplianceAuto-check passed
  • Contract Review

    jeremylongshore/tons-of-skills-marketplace

    Orchestrates a comprehensive multi-agent contract review that analyzes risk, plain-English translation, missing protections, and compliance in parallel.

    2.8k GitHub stars~1.9k tokensUpdated yesterday
    Legal & ComplianceAuto-check passed

More from GaZmagik/iso-24495

All 8 skills in this repo
  • Assesses how ready an organization is to produce plain language, through evidence sweeps, interviews and a maturity gap report.

    190 GitHub stars~1.3k tokensUpdated 2 days ago
    Auto-check passed
  • ISO 24495 Text Audit

    GaZmagik/iso-24495

    Audits a Markdown or text file or folder you choose for plain-language problems such as legalese, wordy phrases and long sentences, reporting each finding with file and line.

    190 GitHub stars~817 tokensUpdated 2 days ago
    Auto-check passed
  • Iso 24495 5

    GaZmagik/iso-24495

    Provisional sector-specific Plain Language standard for document design (based on ISO/WD 24495-5, under development).

    190 GitHub stars~3.7k tokensUpdated 2 days ago
    Auto-check passed
  • ISO 24495-1 Plain Language

    GaZmagik/iso-24495

    Makes the agent write every user-facing reply by the four plain-language principles of ISO 24495-1:2023: relevant, findable, understandable and usable.

    190 GitHub stars~2k tokensUpdated 2 days ago
    Auto-check passed
  • Applies plain language rules to software documentation, architecture explanations, code reviews and technical analysis, following the principles of ISO 24495-3:2026.

    190 GitHub stars~1.6k tokensUpdated 2 days ago
    Auto-check passed
  • Iso 24495 Code

    GaZmagik/iso-24495

    Plain language applied to source code (ISO 24495-1:2023 principles).

    190 GitHub stars~1.6k tokensUpdated 2 days ago
    Auto-check passed

Questions about Plain Language for Legal Text

What does Plain Language for Legal Text do?

Applies ISO 24495-2 style plain-language rules to contracts and legal writing, standardizing modal verbs without weakening enforceability. Framed as the project's own proxy for the standard's principles rather than its literal text, this extends a plain-language base skill for contracts, licenses and regulatory writing. Internal reasoning inside thinking blocks is fully exempt from the style rules, but legal enforceability always wins: a term of art required to avoid ambiguity is kept and explained in plain language rather than cut.

When should I use Plain Language for Legal Text?

Plain Language for Legal Text fits situations like: drafting a contract clause in plain language; reviewing a license agreement for archaic legal phrasing; rewriting a compliance policy so obligations are explicit.

How do I install Plain Language for Legal Text in Claude Code?

Run `npx skills add GaZmagik/iso-24495 --skill iso-24495-2 -a claude-code`. Or copy the skill folder (skills/iso-24495-2 in GaZmagik/iso-24495) into .claude/skills/iso-24495-2 in your project. Claude Code loads it when a task matches its description.

How do I install Plain Language for Legal Text in Codex?

Run `npx skills add GaZmagik/iso-24495 --skill iso-24495-2 -a codex`. Or copy the skill folder (skills/iso-24495-2 in GaZmagik/iso-24495) into .agents/skills/iso-24495-2 in your project. Codex loads it when a task matches its description.

Can I use Plain Language for Legal Text in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add GaZmagik/iso-24495 --skill iso-24495-2 -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/iso-24495-2, .gemini/skills/iso-24495-2, .github/skills/iso-24495-2 and .opencode/skills/iso-24495-2 in your project.

What does Plain Language for Legal Text need to run?

SKILL.md names no scripts, command-line tools or credentials: Plain Language for Legal Text is instructions for the agent only.

Does Plain Language for Legal Text access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Plain Language for Legal Text safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Plain Language for Legal Text use?

Plain Language for Legal Text is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Plain Language for Legal Text use?

About 2.4k tokens (SKILL.md is roughly 9.7k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Plain Language for Legal Text?

Skills that share tags, products or a category with Plain Language for Legal Text: Contract Red Flags (mohitagw15856/pm-claude-skills, 1.4k stars), Clause Explainer (mohitagw15856/pm-claude-skills, 1.4k stars), Custom Nda Generator (zubair-trabzada/ai-legal-claude, 1.8k stars) and Legal Design Assessment (lawve-ai/awesome-legal-skills, 847 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Plain Language for Legal Text?

GaZmagik (a GitHub user) maintains it in GaZmagik/iso-24495, which has 190 GitHub stars. The repository holds 8 skills in this directory. The repository was last updated on October 9, 2026.

Source: GaZmagik/iso-24495 on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.