Plain Words
Use when an explanation did not land. Re-pitch it plainly.
Install
npx skills add SamueleBassoli/hermes-fleet-apps --skill plain-wordsgit 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-wordsPersonal 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: whatDetails
- Skill name
plain-words- Repository
- SamueleBassoli/hermes-fleet-apps
- 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
Agent Facing CLI
44SamueleBassoli/hermes-fleet-apps
Use when an agent will drive a CLI. Contract test first.
Agent Fleet Design
44SamueleBassoli/hermes-fleet-apps
Use when adding, backing up, or driving the agent fleet.
Agent Identity Setup
44SamueleBassoli/hermes-fleet-apps
Use when setting up or resetting agent SOUL, memory, skills.
Production Install
44SamueleBassoli/hermes-fleet-apps
Use when a dev tool meets the owner's real data. Pin, isolate.
First Publication
44SamueleBassoli/hermes-fleet-apps
Use before a repo's first push. It is irreversible.
Setup Walkthrough
44SamueleBassoli/hermes-fleet-apps
Use when the owner must do a setup by hand: walk them through it one step at a time, never a wall.
Browse the most popular Claude skills, all other skills, or write your own with the skills generator.