Translates every clause of a contract into plain language at an 8th-grade reading level and flags deliberately confusing language patterns.

MITAuto-check passedWriting & Content

Install Plain English

skills CLI
$ npx skills add jeremylongshore/tons-of-skills-marketplace --skill plain-english -a claude-code

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

GitHub CLI
$ gh skill install jeremylongshore/tons-of-skills-marketplace plain-english --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/jeremylongshore/tons-of-skills-marketplace.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/.curated/plain-english .claude/skills/plain-english && 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
plain-english
GitHub stars
2.8k
Token cost
~2.4k tokens
SKILL.md length
1,084 words
Files
1
Skills in repo
3,342
Repo updated
First seen
Licence
MIT

At a glance

Translates every clause of a contract into plain language at an 8th-grade reading level and flags deliberately confusing language patterns.

  • Works in 6 steps: Read the full contract. Use the Read… → Identify all material clauses. Break the… → Translate each clause to plain English.… → …
  • A user says explain this contract
  • SKILL.md covers Overview, Prerequisites, Instructions and Output, plus 3 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Plain English is an agent skill from jeremylongshore/tons-of-skills-marketplace. Translates every clause of a contract into plain language at an 8th-grade reading level and flags deliberately confusing language patterns. Use when a user says "explain this contract", "what does this mean", or needs a non-lawyer to understand an agreement. Trigger with "/plain-english" or "translate this contract to plain English".

Its SKILL.md is about 2.4k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts. Compatibility notes: Designed for Claude Code

It sits in Writing & Content, covering Plain language and style rules. The repository describes itself as: Model-agnostic agent-skills platform with a harness-free canonical layer, verified adapters, and the ccpi package manager. Explore at tonsofskills.com. The licence is MIT.

When your agent uses it

  • A user says explain this contract
  • What does this mean
  • Needs a non-lawyer to understand an agreement
  • With /plain-english

Example prompts

  • “explain this contract”
  • “what does this mean”
  • “/plain-english”
  • “/plain-english”

Requirements

  • Compatibility (from SKILL.md): Designed for Claude Code
  • Pre-approved tools (allowed-tools): Read, Glob, Grep

Workflow steps

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

  1. Read the full contract. Use the Read tool if a file path is provided.
  2. Identify all material clauses. Break the contract into individual
  3. Translate each clause to plain English. For every material clause
  4. Apply the 5 flag types. After translating each clause, check whether any
  5. Score overall readability. After translating all clauses, calculate
  6. Generate the quick-reference summary. Create a one-page "What You Are

What it can do on your machine

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

  • Tool permissions

    Pre-approves these tools, so the agent can use them without asking each time:

    • Read
    • Glob
    • Grep

    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

    Links to these hosts (documentation or services it may open):

    • plainlanguage.gov
    • govinfo.gov
    • readable.com
    • commonpaper.com
    • consumerfinance.gov

    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.

  • Compatibility

    Designed for Claude Code

    From compatibility in the SKILL.md frontmatter.

Context cost

Plain English loads about 2.4k tokens when it runs. Until then it costs about 87 tokens; SKILL.md has 1,084 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~87
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 jeremylongshore/tons-of-skills-marketplace at commit cfae287, republished under its MIT licence (© jeremylongshore). 1,084 words, ~2,355 tokens.

Download SKILL.mdSave it as .claude/skills/plain-english/SKILL.md (or your agent's skills folder).
name
plain-english
description
Translates every clause of a contract into plain language at an 8th-grade reading level and flags deliberately confusing language patterns. Use when a user says "explain this contract", "what does this mean", or needs a non-lawyer to understand an agreement. Trigger with "/plain-english" or "translate this contract to plain English".
allowed-tools
Read, Glob, Grep
compatibility
Designed for Claude Code
version
1.1.0
author
Intent Solutions <jeremy@intentsolutions.io>
license
MIT
tags
legal, contracts, plain-language, readability, translation, accessibility

Plain English — Legalese to Plain Language Translator

Translates every material clause in a contract into clear, jargon-free language that a non-lawyer can understand, while flagging clauses that appear to be deliberately confusing or that hide significant obligations behind complex wording.

Overview

Legal language exists for precision, but it is also routinely weaponized. Dense legalese discourages the other party from reading carefully, hides unfavorable terms behind jargon, and creates information asymmetry that favors the drafter.

This skill neutralizes that advantage by producing a clause-by-clause translation at an 8th-grade reading level (Flesch-Kincaid grade 8 or below), accompanied by flags that highlight where the original language is not just complex but strategically confusing.

The goal is not to replace legal review but to ensure the signer actually understands what they are agreeing to before deciding whether to consult an attorney.

Prerequisites

  • A contract must be provided as a file path or pasted text.
  • No special knowledge from the user is required — the entire point of this skill is to make the contract accessible to anyone.

Instructions

  1. Read the full contract. Use the Read tool if a file path is provided.

  2. Identify all material clauses. Break the contract into individual sections and clauses. Skip boilerplate headers, signature blocks, and formatting-only content.

  3. Translate each clause to plain English. For every material clause:

    • Rewrite in short, direct sentences (target: 8th-grade reading level).
    • Replace legal jargon with everyday equivalents:
      • "indemnify and hold harmless" -> "pay for any losses and protect from lawsuits"
      • "notwithstanding anything to the contrary" -> "even if other parts of this contract say differently"
      • "shall not be construed to" -> "does not mean"
      • "in the event of" -> "if"
      • "prior to" -> "before"
      • "pursuant to" -> "under" or "according to"
      • "herein", "hereof", "hereunder" -> "in this contract"
      • "mutatis mutandis" -> "with the necessary changes"
    • Preserve the legal meaning — do not simplify away obligations or rights.
    • State who must do what, by when, and what happens if they do not.
  4. Apply the 5 flag types. After translating each clause, check whether any of these flags apply:

    FlagIconWhen to Apply
    DELIBERATELY CONFUSING:no_entry:Language is unnecessarily complex in ways that obscure meaning; simpler alternatives exist and the drafter chose not to use them
    WATCH OUT:warning:Clause creates a significant obligation, cost, or restriction that a casual reader would likely miss
    SURPRISINGLY BROAD:mag:Scope is wider than what a reasonable person would expect from the section heading or context
    HIDDEN OBLIGATION:lock:An obligation is embedded inside a clause that appears to be about something else (e.g., a payment term hidden in a definitions section)
    CONTRADICTS EXPECTATIONS:boom:The clause says the opposite of what most people would assume based on the section title or common practice
  5. Score overall readability. After translating all clauses, calculate:

    • Estimated Flesch-Kincaid grade level of the original document
    • Number of jargon terms replaced
    • Number of flags raised (broken down by type)
    • Percentage of clauses flagged
  6. Generate the quick-reference summary. Create a one-page "What You Are Actually Agreeing To" summary covering:

    • What you must do (your obligations)
    • What you must not do (your restrictions)
    • What they must do (their obligations)
    • What happens if things go wrong (liability, termination, disputes)
    • What you give up (waivers, assignments, releases)
    • How long this lasts and how to get out

Output

Filename: PLAIN-ENGLISH-{contract-name-or-type}.md

# Plain English Translation
## Quick Reference: What You Are Actually Agreeing To
### Your Obligations
### Your Restrictions
### Their Obligations
### If Things Go Wrong
### What You Give Up
### Duration and Exit
## Readability Statistics
| Metric | Value |
## Clause-by-Clause Translation
### Section 1: [title]
**Original:** [quoted legalese]
**Plain English:** [translation]
**Flags:** [any applicable flags]
### Section 2: [title]
...
## Flag Summary
## Disclaimer

Error Handling

Failure ModeCauseResolution
Untranslatable jargonHighly specialized legal term with no plain equivalentProvide the best approximation with a parenthetical noting the term is specialized
Ambiguous clauseLanguage is genuinely ambiguous even to legal professionalsNote that the clause has multiple possible interpretations and explain each
Missing contextClause references external documents or schedules not providedNote the dependency and translate what is available
Foreign language termsLatin or other non-English legal phrasesTranslate to English with the original term in parentheses
Extremely long contractDocument exceeds practical analysis limitsPrioritize flagged clauses and high-risk sections; note sections skipped
Show full SKILL.md (435 more words)Show less

Examples

Example 1 — SaaS Terms of Service clause:

Original:

Notwithstanding anything to the contrary herein, Company shall not be liable for any indirect, incidental, special, consequential, or punitive damages, including without limitation loss of profits, data, business opportunities, or goodwill, arising out of or in connection with this Agreement, whether based on warranty, contract, tort, or any other legal theory, even if Company has been advised of the possibility of such damages.

Plain English:

Even if other parts of this contract seem to say differently: if something goes wrong because of this company's product or service, they will not pay for any losses beyond direct, immediate damage. They will not cover lost profits, lost data, missed business opportunities, or harm to your reputation — even if they knew these losses were possible.

Flags:

  • :warning: WATCH OUT — This means if their software deletes your data, they owe you nothing for the data itself or the business impact. Only direct damages (like a refund of fees paid) would apply.
  • :mag: SURPRISINGLY BROAD — "arising out of or in connection with" is broader than "caused by." This covers situations where their product was only tangentially related to the harm.

Example 2 — Hidden obligation in definitions:

Original (from Definitions section):

"Services" shall mean the software platform and any configurations, customizations, or integrations developed by Client using the platform tools.

Plain English:

"Services" means not just the software itself, but also anything you build using their tools. By defining your work as part of their "Services," other clauses about Services (like ownership, licensing, and liability) now apply to your custom work too.

Flags:

  • :lock: HIDDEN OBLIGATION — This definition makes your custom work subject to the vendor's terms about "Services" throughout the contract.
  • :boom: CONTRADICTS EXPECTATIONS — Most people would expect "Services" to mean what the vendor provides, not what the customer builds.

Resources


Legal Disclaimer: This skill provides AI-generated plain-language translations for informational and educational purposes only. Translations are approximations — they aim for clarity but may not capture every legal nuance of the original text. This does not constitute legal advice, create an attorney-client relationship, or substitute for consultation with a qualified attorney. The original contract language, not this translation, is what governs the legal relationship between the parties.

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

Files

Just SKILL.md in skills/.curated/plain-english of jeremylongshore/tons-of-skills-marketplace.

Open the folder on GitHubat commit cfae287

Compare with similar skills

Plain English 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 English compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Plain English this skilljeremylongshore/tons-of-skills-marketplace2.8k—~2.4kAutomated safety check: PassMIT
Asd Ste100danyuchn/asd-ste100-skill4.3k—~4.1kAutomated safety check: PassMIT
Technical Writing Standardcursor/plugins11k10 repos~2.3kAutomated safety check: PassNone
Ponytail AuditDietrichGebert/ponytail160k—~1.4kAutomated safety check: PassMIT
Natural Japanese Business Writingcoji/natural-japanese1.9k—~2.1kAutomated safety check: PassMIT
PgjevrealZachi/pg-jev1.1k—~2.9kAutomated safety check: PassCustom licence

Similar skills

  • Asd Ste100

    danyuchn/asd-ste100-skill

    A skill your agent uses when English text must be parsed without a human to resolve ambiguity — tool descriptions, error messages, inter-agent instructions, system prompts, status reports — and…

    4.3k GitHub stars~4.1k tokensUpdated 7 days ago
    Writing & ContentAuto-check passed
  • Official

    Applies four layers of technical-writing rules to docs, RFCs, readmes, PR descriptions and commit messages so a tired engineer follows them on the first read.

    11k GitHub starsUsed in 10 repos~2.3k tokens
    Writing & ContentAuto-check passed
  • Ponytail Audit

    DietrichGebert/ponytail

    Quality audit of a whole repo: bugs, security holes, what breaks under real load, risky code without tests, slow paths, and what to delete, merge or split.

    160k GitHub stars~1.4k tokensUpdated yesterday
    Writing & ContentAuto-check passed
  • Writes and edits Japanese business documents so they read clearly and naturally, removes AI-sounding phrasing and can score how AI-like a text reads.

    1.9k GitHub stars~2.1k tokensUpdated 1 mo ago
    Writing & ContentAuto-check passed
  • Pgjev

    realZachi/pg-jev

    Install, configure, query and explain pgjev (the jev PostgreSQL extension that filters, ranks and classifies rows with plain-language conditions via TypeSafe's Jev model).

    1.1k GitHub stars~2.9k tokensUpdated 5 days ago
    Writing & ContentAuto-check passed
  • Defensive Writing Editor

    lennney/stop-that-shit

    Cuts defensive disclaimers, stacked hedging and self-protective narration from proposals and summaries, keeping only limits that affect the reader's decision.

    2.5k GitHub starsUsed in 1 repo~1.2k tokens
    Writing & ContentAuto-check passed

More from jeremylongshore/tons-of-skills-marketplace

All 3,342 skills in this repo
  • Performing Security Code Review

    jeremylongshore/tons-of-skills-marketplace

    Execute this skill enables AI assistant to conduct a security-focused code review using the security-agent plugin.

    2.8k GitHub starsUsed in 2 repos~1.3k tokens
    Auto-check: notes
  • Adapting Transfer Learning Models

    jeremylongshore/tons-of-skills-marketplace

    Build this skill automates the adaptation of pre-trained machine learning models using transfer learning techniques.

    2.8k GitHub stars~1.1k tokensUpdated today
    Auto-check passed
  • Agent Context Loader

    jeremylongshore/tons-of-skills-marketplace

    Execute proactive auto-loading: automatically detects and loads agents.md files.

    2.8k GitHub stars~1.1k tokensUpdated today
    Auto-check passed
  • Aggregating Performance Metrics

    jeremylongshore/tons-of-skills-marketplace

    Aggregate and centralize performance metrics from applications, systems, databases, caches, and services.

    2.8k GitHub stars~1.2k tokensUpdated today
    Auto-check passed
  • Analyzing Capacity Planning

    jeremylongshore/tons-of-skills-marketplace

    Execute this skill enables AI assistant to analyze capacity requirements and plan for future growth.

    2.8k GitHub stars~947 tokensUpdated today
    Auto-check passed
  • Analyzing Database Indexes

    jeremylongshore/tons-of-skills-marketplace

    Process use when you need to work with database indexing. An agent skill from jeremylongshore/tons-of-skills-marketplace.

    2.8k GitHub stars~2k tokensUpdated today
    Auto-check passed

Questions about Plain English

What does Plain English do?

Translates every clause of a contract into plain language at an 8th-grade reading level and flags deliberately confusing language patterns. Plain English is an agent skill from jeremylongshore/tons-of-skills-marketplace. Translates every clause of a contract into plain language at an 8th-grade reading level and flags deliberately confusing language patterns.

When should I use Plain English?

Plain English fits situations like: A user says explain this contract; what does this mean; needs a non-lawyer to understand an agreement; with /plain-english.

How do I install Plain English in Claude Code?

Run `npx skills add jeremylongshore/tons-of-skills-marketplace --skill plain-english -a claude-code`. Or copy the skill folder (skills/.curated/plain-english in jeremylongshore/tons-of-skills-marketplace) into .claude/skills/plain-english in your project. Claude Code loads it when a task matches its description.

How do I install Plain English in Codex?

Run `npx skills add jeremylongshore/tons-of-skills-marketplace --skill plain-english -a codex`. Or copy the skill folder (skills/.curated/plain-english in jeremylongshore/tons-of-skills-marketplace) into .agents/skills/plain-english in your project. Codex loads it when a task matches its description.

Can I use Plain English 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 jeremylongshore/tons-of-skills-marketplace --skill plain-english -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/plain-english, .gemini/skills/plain-english, .github/skills/plain-english and .opencode/skills/plain-english in your project.

What does Plain English need to run?

SKILL.md names no scripts, command-line tools or credentials: Plain English is instructions for the agent only. Its frontmatter pre-approves these tools: Read, Glob, Grep. Compatibility (from SKILL.md): Designed for Claude Code.

Does Plain English access the network?

SKILL.md names 5 domains. As links in the text: plainlanguage.gov, govinfo.gov, readable.com, commonpaper.com and consumerfinance.gov. This is read from the text; nothing was executed.

Is Plain English 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 English use?

Plain English is published under the MIT licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Plain English use?

About 2.4k tokens (SKILL.md is roughly 9.4k 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 English?

Skills that share tags, products or a category with Plain English: Asd Ste100 (danyuchn/asd-ste100-skill, 4.3k stars), Technical Writing Standard (cursor/plugins, 11k stars), Ponytail Audit (DietrichGebert/ponytail, 160k stars) and Natural Japanese Business Writing (coji/natural-japanese, 1.9k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Plain English?

jeremylongshore (a GitHub user) maintains it in jeremylongshore/tons-of-skills-marketplace, which has 2,827 GitHub stars. The repository holds 3,342 skills in this directory. The repository was last updated on October 10, 2026.

Source: jeremylongshore/tons-of-skills-marketplace on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.