easyenlisted
Install: claude install-skill zhangxiangliang/easyen
# easyen
See how easy a piece of English is to read, by running `npx easyen`.
It gives you two simple signals — you decide what to change:
1. **Words** — how many of the words are in a chosen word list, and which words
are too hard.
2. **Sentences** — the average sentence length, and which sentences are long.
easyen only reports. It does not change your text. You decide which hard words
to make simpler and which long sentences to break up.
## When to use
- You wrote some English and want it to stay simple for the reader.
- You want to find the hard words or long sentences in a text.
- You want to keep your writing at a level (everyday, academic, or technical).
## How to run
No install needed — `npx easyen` gets the package on first run. It reads text
from stdin and prints JSON. Pipe the text in, using whatever your shell offers
(this follows the Unix convention, and works on macOS, Linux, and Windows
PowerShell / cmd). `everyday` is the default word list.
```bash
cat your-doc.md | npx easyen # macOS / Linux
Get-Content your-doc.md | npx easyen # Windows PowerShell
```
If piping is hard on your system, read a file directly instead:
```bash
npx easyen --file your-doc.md --dict everyday,tech
```
**For Markdown (a README, docs, a skill file), add `--markdown`.** Without it,
code blocks, URLs and HTML count as words, and the result is mostly noise —
on this project's own README that alone moved the ratio from 0.94 to 0.83.
```bash
npx easyen