← ClaudeAtlas

agent-ruleslisted

Rewrites or audits text so it reads plainly: answer first, no preamble, no hype adjectives, no marketing voice, sentences short enough to read once. Applies a named ruleset plus ASD-STE100 Simplified Technical English. Use when asked to clean up, tighten, de-slop, or humanise a draft, a README, a release note, a commit message, a PR description, or any AI-generated prose. Also use when asked to check text against the rules without changing it. Do not use for code changes, and do not use to shorten something the user asked to be thorough.
tornikegomareli/agent-rules · ★ 11 · AI & Automation · score 77
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