Orwell writing
Skill tamdogood/builder-essential-skills/skills/orwell-writing
A repository for skills that are essential to my daily work
npx -y skills add tamdogood/builder-essential-skills --skill orwell-writingAssembled from the repository path, not quoted from the project. Check it against their README if it does not work.
One thing to look at
- 25 days oldThe repository was created 25 days ago. New is not bad, but a brand new repository carrying a familiar-sounding name is the shape a typosquat arrives in, and there has been no time for anyone else to find a problem with it.
What its author says it does
Copied from the file, not written here
Use when an agent is asked to draft, rewrite, edit, review, polish, copyedit, simplify, humanize, or create written prose, including creative writing, essays, posts, scripts, speeches, emails, documentation, product copy, and other style-sensitive text. Apply George Orwell's six rules and ASD-STE100 Simplified Technical English as a plain-English discipline while preserving the user's intended meaning, audience, tone, and explicit constraints.
SKILL.md
4.4 KB, as published. Nobody here has run it
Orwell Writing
Overview
Use Orwell's rules and ASD-STE100 Simplified Technical English (STE) as practical filters for clear, direct, and honest prose. Use STE by default for technical, instructional, business, and product prose. Apply the rules to both drafting and revision, but do not erase deliberate voice, character, rhythm, humor, or genre when the user clearly wants them.
STE has writing rules and a controlled dictionary. Use an approved word with its approved meaning when the dictionary is available. Do not claim strict STE conformance without checking the current ASD-STE100 issue and dictionary.
Core Rules
Remember these rules from "Politics and the English Language":
- Never use a metaphor, simile, or other figure of speech which you are used to seeing in print.
- Never use a long word where a short one will do.
- If it is possible to cut a word out, always cut it out.
- Never use the passive where you can use the active.
- Never use a foreign phrase, a scientific word, or a jargon word if you can think of an everyday English equivalent.
- Break any of these rules sooner than say anything outright barbarous.
ASD-STE100 baseline
For technical and instructional prose:
- Use short sentences. Put one main action or statement in each sentence.
- Use a clear subject and an active verb. Name the actor when the actor matters.
- Use the same term for the same thing. Do not change a term only to avoid repetition.
- Use familiar words with one precise meaning. Avoid idioms, slang, figurative language, and vague verbs.
- Use a specific technical term when it is necessary for accuracy. Define it or link to its definition.
- Keep noun groups short. Use prepositions to show relationships between terms.
- Write procedures as direct instructions. State the condition, action, and expected result.
- Use positive instructions when they are clear. State what the reader must do.
- Use consistent American English spelling unless the user's style guide requires another variety.
- Preserve code, commands, identifiers, product names, legal text, and required quotations. Do not simplify them silently.
When strict STE is not possible, keep the text clear and mark the terms or passages that need a domain-specific exception.
Workflow
When writing from scratch:
- Identify the audience, purpose, and promised tone from the user's request.
- Draft in concrete, direct English.
- Remove stock phrases, dead metaphors, filler, pompous diction, needless abstraction, and avoidable jargon.
- Prefer active verbs and clear subjects unless passive voice better serves emphasis, tact, suspense, or technical accuracy.
- Keep necessary nuance; do not make prose crude, false, or flat just to make it short.
- Apply the ASD-STE100 baseline. Check terms, sentence structure, instructions, and technical exceptions.
When revising existing text:
- Preserve the user's meaning and any explicit tone or format constraints.
- Cut words, clauses, and sentences that do no work.
- Replace stale figures of speech with plain phrasing or a fresh, specific image.
- Replace long, foreign, scientific, or jargon terms with everyday English when accuracy permits.
- Convert passive constructions to active ones when the actor matters and is known.
- Flag any remaining jargon, passive voice, or ornate phrasing that is necessary rather than silently removing important precision.
- Run a final STE pass. Check that each technical term is consistent, each instruction states the required action, and each exception is intentional.
Creative Writing
For fiction, poetry, memoir, scripts, and lyrical prose, treat STE as a clarity aid, not a requirement that overrides the user's form. Keep intentional ambiguity, cadence, dialogue style, imagery, and character voice when they create a real effect. Remove only language that feels inherited, inflated, evasive, or lazy. Use strict STE when the user explicitly requests it, and note when that request conflicts with a creative effect.