Plain Words

Use when an explanation did not land. Re-pitch it plainly.

44 starsOther

Install

skills CLI (Claude Code, Cursor, Codex and more)
npx skills add SamueleBassoli/hermes-fleet-apps --skill plain-words
Manual install
git clone --depth 1 https://github.com/SamueleBassoli/hermes-fleet-apps.git /tmp/hermes-fleet-apps
mkdir -p ~/.claude/skills
cp -r /tmp/hermes-fleet-apps/roles/coder/skills/plain-words ~/.claude/skills/plain-words

Personal skills live in ~/.claude/skills. Use .claude/skills in a project folder to share a skill with your team.

From the SKILL.md

# Plain Words

Trigger: the owner says "wait, what", "I don't follow", "in English", "explain that again",
or goes quiet after a technical answer. Also fires on your own judgement: if the
last message leaned on a term the owner has not met, re-pitch before they have to ask.

The last message did not land. That is a writing failure, not a comprehension failure.
Do not repeat it louder or add detail. **Re-pitch it.**

## How to re-pitch

1. **Give the context first.** One line: what we were doing and why this came up.
   A definition with no frame is just a different set of unfamiliar words.

2. **Write in constrained technical English** (the ASD-STE100 discipline used for
   aircraft manuals, because a mechanic must not misread a step):
   - One idea per sentence. Under 20 words.
   - Active voice. "The script reads the file", not "the file is read".
   - Present tense.
   - One word, one meaning. Pick a word for a thing and never swap in a synonym:
     synonyms make the reader wonder whether it is a second thing.
   - No noun stacks. "The timeout for the connection", not "connection timeout config".
   - Say what to do, not what not to do.

3. **Spend one concrete analogy** on the hard idea. Physical, everyday, not another
   piece of computing. A queue is a line at a bakery. A cache is a note on the fridge
   so you don't re-check the shelf.

4. **Land on what it means for the owner.** What changes for them, in one line: what
Read the full skill on GitHub

Details

Skill name
plain-words
Path
roles/coder/skills/plain-words/SKILL.md
License
MIT
Repo updated
31 October 2026

FAQ

What does the Plain Words skill do?

Use when an explanation did not land. Re-pitch it plainly.

How do I install the Plain Words skill?

skills CLI (Claude Code, Cursor, Codex and more): npx skills add SamueleBassoli/hermes-fleet-apps --skill plain-words. Skills go in ~/.claude/skills (personal) or .claude/skills (project), and Claude loads them automatically when a task matches the description.

Is Plain Words popular?

It lives in SamueleBassoli/hermes-fleet-apps, which has 44 GitHub stars and 0 forks.

Related skills

Browse the most popular Claude skills, all other skills, or write your own with the skills generator.