agent-ruleslisted
Install: claude install-skill tornikegomareli/agent-rules
Edit prose so it reads once. Report what changed and why.
The full ruleset is in `references/rules.md`. Read it before editing. Part 1
covers writing. Part 2 covers working behaviour and applies only when the text
you are reviewing is an agent's own report of work it did.
## Two modes
**Edit** is the default. Rewrite the text to follow the rules, then say what you
changed.
**Check** runs when the user asks whether something breaks the rules, or says
check, audit, score, or "is this slop". Report violations. Do not rewrite.
## Workflow
1. Score the text first, so you have a number rather than an impression:
```bash
python3 scripts/score.py --text draft.md
```
It reports word count, average sentence length, the share of sentences over
20 words, a Flesch score, and every violation with its line number.
2. Read `references/rules.md`.
3. In check mode, report the violations and stop.
4. In edit mode, fix them in this order, because the early ones remove the most
text:
- Cut preamble. The first sentence must answer the question.
- Cut the closing pleasantry and any unrequested offer to help further.
- Cut sentences that only signal effort or state something nobody would
disagree with.
- Replace banned words with the plain word that was meant. Keep the word when
it is the precise technical term.
- Split every sentence over 20 words. One instruction per sentence.
- Remove decorative em dashes. Use a comma, a period, or parenth