Skip to content
Back to skills

Restate Plainly

ASecurity

Restates a dense answer or a named markdown document in plain language, cutting jargon and keeping only what changes a decision. Use when asked to "restate that in plain language", "say that plainly", "what does this actually mean", "cut the jargon", "give me the plain version", or "restate this document". Do NOT use to draft or revise prose, which is `write-human`, and do NOT fire on the model's own judgment that its own output was dense.

  • 2 stars
  • 0 votes
  • 0 copies
  • 2 views
  • Added September 2, 2026
developmentgo

Security analysis

A100/100

Pro scans all 2 files and shows the line behind each finding

Scanned October 5, 2026

npx -y skills add erclx/canon --skill restate-plainly --agent claude-code

Installs into .claude/skills of the current project.

Are you the author of Restate Plainly?

Add the live security badge to your README. It updates with every re-scan.

Security grade badge for Restate Plainly
[![Security: A — Skills Directory](https://www.skillsdirectory.com/api/skills/erclx-restate-plainly/badge)](https://www.skillsdirectory.com/skills/erclx-restate-plainly)

More formats (shields.io, HTML) on the badges page. Keep it an A: scan every change in CI with Pro.

Download with Pro
SKILL.md
---
name: restate-plainly
description: Restates a dense answer or a named markdown document in plain language, cutting jargon and keeping only what changes a decision. Use when asked to "restate that in plain language", "say that plainly", "what does this actually mean", "cut the jargon", "give me the plain version", or "restate this document". Do NOT use to draft or revise prose, which is `write-human`, and do NOT fire on the model's own judgment that its own output was dense.
metadata:
  family: answer
---

# Restate plainly

Return the plain version of something already written. The reader asked because they stopped to decode rather than to decide, so the restatement earns its place by getting them to the decision.

## What to restate

- Restate the file when the request names a markdown path, and the preceding answer in the conversation when it names none. A named path wins over an answer sitting in the same turn.
- Stop when the request names a path that does not resolve: `❌ No file at <path>. Name a path that exists, or ask for the preceding answer instead.`
- Stop when nothing precedes the request and no path is named: `❌ Nothing to restate. Name a markdown path, or ask right after the answer you want in plain words.`
- Refuse a request to restate output on the model's own initiative. A person asks for this by name.

## What survives

- Keep every point that changes a decision, and cut every point that only supports one. A reader who acts on the restatement and is surprised by the original has been given the wrong half.
- Name the thing the source names. Replace a term of art with its plain equivalent, and keep the term where the reader has to search for it later.
- Say what is uncertain where the source hedges, and say it plainly. Dropping a hedge invents a certainty the source does not carry.
- Introduce no fact, number, or name the source lacks. A restatement changes wording and never claims.
- Report the reasoning, not the metaphor. An abstraction standing in for a mechanism is what made the source dense.

## How it reads

Load the `write-human` skill before writing the restatement. Compression is where a plain version turns into a list of verbless fragments, and that skill states the rhythm and density rules this one does not copy.

## Output

Answer in chat. Write no file, since a restatement is read once to reach a decision.

Lead with the plain version in prose. Close with one line naming what was cut and why, so the reader can go back for it:

```plaintext
Cut: <what left, and why it changes no decision>
```

Name the source path on its own line when the restatement came from a file.

Files in this skill

  • REQUIREMENT.md2.9 KB
  • SKILL.md2.6 KB

Attribution

Is this your skill, or is something wrong with this listing? Request removal or report an issue. Author removals are honored within 72 hours.

Comments

Loading comments…