Agent skill

Plain Language

by prapaa-ai in prapaa-ai/agav

Rewrite text to be clear and understandable for any reader. An agent skill from prapaa-ai/agav.

Apache-2.0Auto-check passedWriting & Content

Install Plain Language

skills CLI
$ npx skills add prapaa-ai/agav --skill plain-language -a claude-code

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

GitHub CLI
$ gh skill install prapaa-ai/agav plain-language --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/prapaa-ai/agav.git skills-src && mkdir -p .claude/skills && cp -r skills-src/source/skills/bundled/plain-language .claude/skills/plain-language && 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-language
GitHub stars
152
Token cost
~426 tokens
SKILL.md length
238 words
Files
1
Skills in repo
12
Repo updated
First seen
Licence
Apache-2.0

At a glance

Rewrite text to be clear and understandable for any reader. An agent skill from prapaa-ai/agav.

  • Works in 7 steps: Identify the source text and the… → Rewrite applying these rules, in… → Preserve meaning exactly. Never drop… → …
  • Tasks that involve Plain language and style rules
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Plain Language is an agent skill from prapaa-ai/agav. Rewrite text to be clear and understandable for any reader

Its SKILL.md is about 430 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Writing & Content, covering Plain language and style rules. The repository describes itself as: Terminal-native AI coding assistant for real repositories. Inspect code, edit files, run tests, and verify changes from the CLI. The licence is Apache-2.0.

When your agent uses it

  • Tasks that involve Plain language and style rules

Example prompts

  • “/plain-language”

Requirements

  • Pre-approved tools (allowed-tools): read_file, find_files

Workflow steps

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

  1. Identify the source text and the audience. If unknown, assume an intelligent reader with no specialist knowledge of the subject.
  2. Rewrite applying these rules, in priority order
  3. Preserve meaning exactly. Never drop conditions, exceptions, dates, amounts, or obligations to simplify — move them into a clearly visible…
  4. Keep legal or technical terms of art that have no plain equivalent (e.g. "escrow", "force majeure") but explain them in a brief parenthesis.
  5. Present: the rewritten text, then an optional short "What changed" list of the biggest edits. Do not show a full diff unless asked.
  6. If the text is a notice, contract, or policy, add one line: "This is a readability rewrite, not legal advice."
  7. Offer a version at a target reading level if the user names one (e.g. "explain like I'm new to this").

What it can do on your machine

Read from SKILL.md and the folder at commit 9e9582a. 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_file
    • find_files

    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 loads about 426 tokens when it runs. Until then it costs about 18 tokens; SKILL.md has 238 words of instructions outside code blocks.

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

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 prapaa-ai/agav at commit 9e9582a, republished under its Apache-2.0 licence (© prapaa-ai). 238 words, ~426 tokens.

Download SKILL.mdSave it as .claude/skills/plain-language/SKILL.md (or your agent's skills folder).
name
plain-language
description
Rewrite text to be clear and understandable for any reader
allowed-tools
read_file, find_files
version
1.0.0
invocation
both
tags
writing, communication

Plain Language

Rewrite jargon-heavy or confusing text so any reader can understand it on first pass.

Instructions

  1. Identify the source text and the audience. If unknown, assume an intelligent reader with no specialist knowledge of the subject.
  2. Rewrite applying these rules, in priority order:
    • Lead with the point: the reader should know the conclusion or request in the first sentence.
    • Short sentences: split anything over ~25 words. One idea per sentence.
    • Common words: "use" not "utilize", "before" not "prior to", "start" not "commence".
    • Active voice: "we will review your application", not "your application will be reviewed".
    • No unexplained acronyms; expand on first use.
    • Turn dense paragraphs into bullets when there are 3+ parallel items.
  3. Preserve meaning exactly. Never drop conditions, exceptions, dates, amounts, or obligations to simplify — move them into a clearly visible list if needed. A simplification that hides a deadline is a bug.
  4. Keep legal or technical terms of art that have no plain equivalent (e.g. "escrow", "force majeure") but explain them in a brief parenthesis.
  5. Present: the rewritten text, then an optional short "What changed" list of the biggest edits. Do not show a full diff unless asked.
  6. If the text is a notice, contract, or policy, add one line: "This is a readability rewrite, not legal advice."
  7. Offer a version at a target reading level if the user names one (e.g. "explain like I'm new to this").

© prapaa-ai, Apache-2.0. 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 source/skills/bundled/plain-language of prapaa-ai/agav.

Open the folder on GitHubat commit 9e9582a

Compare with similar skills

Plain Language 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 compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Plain Language this skillprapaa-ai/agav152—~426Automated safety check: PassApache-2.0
Asd Ste100danyuchn/asd-ste100-skill4.2k—~4.1kAutomated safety check: PassMIT
Simple Issue Descriptionevery-app/open-seo23k1 repos~1.2kAutomated safety check: PassMIT
Ponytail AuditDietrichGebert/ponytail159k—~1.4kAutomated safety check: PassMIT
Technical Writing Standardcursor/plugins10k10 repos~2.4kAutomated safety check: PassNone
Natural Japanese Business Writingcoji/natural-japanese1.9k—~2.1kAutomated safety check: PassMIT

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.2k GitHub stars~4.1k tokensUpdated 5 days ago
    Writing & ContentAuto-check passed
  • Simple Issue Description

    every-app/open-seo

    Turn a rough bug report, feature request, support note, or pull request into a short, plain-language issue focused on the problem and desired behavior.

    23k GitHub starsUsed in 1 repo~1.2k 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.

    159k GitHub stars~1.4k tokensUpdated today
    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.

    10k GitHub starsUsed in 10 repos~2.4k tokens
    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 3 days ago
    Writing & ContentAuto-check passed

More from prapaa-ai/agav

All 12 skills in this repo
  • Skill Creator

    prapaa-ai/agav

    Guide for authoring a new agav skill (SKILL.md). An agent skill from prapaa-ai/agav.

    152 GitHub stars~792 tokensUpdated today
    Auto-check passed
  • Git Commit

    prapaa-ai/agav

    Generate a commit message from staged changes. An agent skill from prapaa-ai/agav.

    152 GitHub stars~358 tokensUpdated today
    Auto-check passed
  • Data Clean

    prapaa-ai/agav

    Clean up and analyze CSV/Excel data for non-analysts. An agent skill from prapaa-ai/agav.

    152 GitHub stars~479 tokensUpdated today
    Auto-check passed
  • File Organizer

    prapaa-ai/agav

    Clean up a messy folder with a dry-run plan before moving anything

    152 GitHub stars~460 tokensUpdated today
    Auto-check passed
  • XLSX

    prapaa-ai/agav

    Create, read, and edit Excel .xlsx spreadsheets and CSV files

    152 GitHub stars~486 tokensUpdated today
    Auto-check passed
  • Code Review

    prapaa-ai/agav

    Review code changes for bugs, security issues, and improvements

    152 GitHub stars~384 tokensUpdated today
    Auto-check passed

Questions about Plain Language

What does Plain Language do?

Rewrite text to be clear and understandable for any reader. An agent skill from prapaa-ai/agav. Plain Language is an agent skill from prapaa-ai/agav.

When should I use Plain Language?

Plain Language fits situations like: tasks that involve Plain language and style rules.

How do I install Plain Language in Claude Code?

Run `npx skills add prapaa-ai/agav --skill plain-language -a claude-code`. Or copy the skill folder (source/skills/bundled/plain-language in prapaa-ai/agav) into .claude/skills/plain-language in your project. Claude Code loads it when a task matches its description.

How do I install Plain Language in Codex?

Run `npx skills add prapaa-ai/agav --skill plain-language -a codex`. Or copy the skill folder (source/skills/bundled/plain-language in prapaa-ai/agav) into .agents/skills/plain-language in your project. Codex loads it when a task matches its description.

Can I use Plain Language 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 prapaa-ai/agav --skill plain-language -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-language, .gemini/skills/plain-language, .github/skills/plain-language and .opencode/skills/plain-language in your project.

What does Plain Language need to run?

SKILL.md names no scripts, command-line tools or credentials: Plain Language is instructions for the agent only. Its frontmatter pre-approves these tools: read_file, find_files.

Does Plain Language 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 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 use?

Plain Language is published under the Apache-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Plain Language use?

About 426 tokens (SKILL.md is roughly 1.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?

Skills that share tags, products or a category with Plain Language: Asd Ste100 (danyuchn/asd-ste100-skill, 4.2k stars), Simple Issue Description (every-app/open-seo, 23k stars), Ponytail Audit (DietrichGebert/ponytail, 159k stars) and Technical Writing Standard (cursor/plugins, 10k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Plain Language?

prapaa-ai (a GitHub organization) maintains it in prapaa-ai/agav, which has 152 GitHub stars. The repository holds 12 skills in this directory. The repository was last updated on October 9, 2026.

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