writing-skills 0.5.0 → 0.6.0

package/.claude-plugin/marketplace.json

@@ -5,14 +5,14 @@
     "url": "https://github.com/surendranb"
   },
   "metadata": {
-    "description": "15 production writing-style skills and character frameworks for AI agents with dynamic GitHub skill loading.",
-    "version": "0.5.0"
+    "description": "16 production writing-style skills for AI agents: 9 measurable frameworks (plain language, ASD-STE100, AP journalism, GOV.UK, Orwell's rules) and 7 character voices, as portable SKILL.md files.",
+    "version": "0.6.0"
   },
   "plugins": [
     {
       "name": "writing-skills",
       "source": "./",
-      "description": "15 production writing-style skills and character frameworks for AI agents with dynamic GitHub skill loading.",
+      "description": "16 production writing-style skills for AI agents: 9 measurable frameworks (plain language, ASD-STE100, AP journalism, GOV.UK, Orwell's rules) and 7 character voices, as portable SKILL.md files.",
       "strict": false
     }
   ]

package/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "writing-skills",
-  "version": "0.5.0",
-  "description": "14 production writing-style skills and character frameworks for AI agents with dynamic GitHub skill loading.",
+  "version": "0.6.0",
+  "description": "16 production writing-style skills for AI agents: 9 measurable frameworks (plain language, ASD-STE100, AP journalism, GOV.UK, Orwell's rules) and 7 character voices, as portable SKILL.md files.",
   "author": {
     "name": "Surendran B",
     "url": "https://github.com/surendranb"
@@ -10,11 +10,14 @@
   "repository": "https://github.com/surendranb/writing-skills",
   "license": "MIT",
   "keywords": [
-    "mcp",
-    "mcp-server",
-    "model-context-protocol",
-    "claude",
-    "cursor",
-    "ai-agents"
+    "agent-skills",
+    "skills",
+    "writing",
+    "writing-style",
+    "voice",
+    "claude-code",
+    "codex",
+    "opencode",
+    "gemini-cli"
   ]
 }

package/README.md

@@ -4,7 +4,7 @@
 
 # writing-skills
 
-**15 writing-style skills for AI agents: 8 measurable frameworks, 7 character voices.**
+**16 writing-style skills for AI agents: 9 measurable frameworks, 7 character voices.**
 Plain `SKILL.md` files. Works in any agent that reads skills
 (Claude Code, opencode, Codex, Cursor, Kiro, Gemini).
 
@@ -41,12 +41,26 @@ Ask for the style. The skill loads itself.
 
 Every skill ends with a `Verify` checklist the agent must pass before it delivers.
 
+### Examples
+
+| You say | Skill that fires | What you get |
+| :--- | :--- | :--- |
+| "Simplify this insurance letter so anyone can read it" | `plain-language` | Sentences ≤25 words, passive voice stripped, jargon replaced — checked against the Plain Writing Act rules |
+| "Turn these notes into an update for my VP" | `business-writing` | BLUF first line, the ask and deadline explicit, buzzwords deleted |
+| "Write the release notes for v2.0" | `google-dev-docs` | Active voice, present tense, verb-first headings |
+| "Draft the outage announcement" | `corporate-communication` | News in line one, reader impact named, zero euphemism |
+| "Make this maintenance manual usable by non-native speakers" | `asd-ste100` | Simplified Technical English: one instruction per sentence, no idioms |
+| "Press release for the funding round, AP style" | `journalism-ap` | AP Stylebook attribution and number rules, no editorializing |
+| "Explain recursion like Bob Ross" | `bob-ross` | A happy little explanation — calm, encouraging, and technically correct |
+| "Rejection email, but make it Paddington" | `paddington` | Firm news delivered with unfailing politeness |
+
 ## The skills
 
 ### Frameworks — real standards, enforced
 
 | Skill | Enforces |
 | :--- | :--- |
+| `orwells-rules` | Orwell's 6 rules. Zero dead metaphors, short Saxon words, prune verbal limbs, active voice, barbarism override. |
 | `plain-language` | Plain Writing Act. Sentences ≤25 words, passive ≤10%, jargon ban list. |
 | `business-writing` | BLUF first line, explicit ask + deadline, buzzword ban list. |
 | `corporate-communication` | News first, reader impact named, zero euphemism. |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "writing-skills",
-  "version": "0.5.0",
+  "version": "0.6.0",
   "description": "Procedural writing-style skills for agents — measurable standards, voice craft, and character voices as SKILL.md instructions.",
   "license": "MIT",
   "repository": {

package/plugin.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
   "name": "writing-skills",
-  "version": "0.5.0",
+  "version": "0.6.0",
   "description": "Procedural writing-style skills for agents \u2014 measurable standards, voice craft, and character voices as SKILL.md instructions.",
   "author": "Surendran",
   "homepage": "https://github.com/surendranb/writing-skills",

package/skills/orwells-rules/SKILL.md

@@ -0,0 +1,54 @@
+---
+name: orwells-rules
+description: Apply George Orwell's 6 rules for clear, honest, and unpretentious writing from "Politics and the English Language" (1946). Use when the user asks for Orwell's rules, George Orwell style, cutting dead metaphors and clichés, eliminating jargon and Latinate words, converting passive to active voice, or ruthless cutting of verbal false limbs to clarify thought.
+compatibility: Requires standard Markdown parser and agent context
+---
+
+# Orwell's Rules for Writing
+
+Clarity over pretension, truth over ornament. Never let ready-made phrases think for you.
+
+## The core rule
+
+**Choose words for exact meaning and fresh imagery: cut stale metaphors, replace long Latinate words with short Saxon terms, strip every useless syllable, use active voice, and break any rule sooner than write barbarous prose.**
+
+Workflow: `decide the exact thought` → `visualize concrete images` → `prune verbal false limbs and clichés` → `convert passive to active` → `run the Verify checklist`.
+
+## Mechanics
+
+1. **Ban dead metaphors.** Never use a metaphor, simile, or figure of speech you are used to seeing in print (e.g., *ring the changes*, *Achilles' heel*, *swan song*, *hotbed*, *stand shoulder to shoulder*, *toe the line*, *play into the hands of*, *no stone unturned*, *silver lining*). Use fresh, visual images or plain statements.
+2. **Short Saxon words over long Latinates.** Never use a long word where a short one will do. Replace Latinate and polysyllabic terms with plain English (e.g., *help* not *facilitate*, *end* not *terminate*, *show* not *demonstrate*, *start* not *commence*, *try* not *endeavor*, *use* not *utilize*).
+3. **Ruthless word-cutting (prune verbal false limbs).** If it is possible to cut a word out, always cut it out. Strip operator phrases that eliminate simple verbs (e.g., *render inoperative* → *break*, *make contact with* → *meet/call*, *give rise to* → *cause*, *have the effect of* → *do*, *in view of the fact that* → *because*).
+4. **Active voice by default.** Never use the passive where you can use the active. Put the actor before the action ("The committee approved the budget" not "The budget was approved by the committee"). Eliminate bureaucratic evasions ("mistakes were made").
+5. **Everyday English over foreign phrases and jargon.** Never use a foreign phrase, scientific word, or jargon if you can think of an everyday English equivalent (e.g., *status quo* → *current state*, *vis-à-vis* → *compared to*, *ad hoc* → *special/unplanned*, *synergy* → *cooperation*, *methodology* → *method*).
+6. **The barbarism override (Rule 6).** Break any of these rules sooner than say anything outright barbarous. Clarity, honesty, and natural rhythm always override dogma.
+
+## Verify
+
+- Zero dead metaphors or prefabricated clichés from the ban list
+- Long and Latinate words replaced with short Saxon equivalents
+- Verbal false limbs pruned (no "render inoperative", "give rise to", "with regard to")
+- Passive voice under 10% of total sentences; actors explicitly named
+- Zero unneeded foreign phrases (*status quo*, *vis-à-vis*, *ad hoc*) or buzzwords
+- Scrupulous writer self-check applied: (1) What am I trying to say? (2) What words express it? (3) Could I put it more shortly? (4) Is anything avoidably ugly?
+
+## Do not
+
+- Let ready-made phrases construct sentences or conceal your meaning
+- Pad sentences with symmetrical extra syllables to sound authoritative
+- Use vague euphemisms to sanitize unpleasant facts
+- Enforce rules 1–5 so rigidly that prose becomes stiff, ungrammatical, or barbarous
+
+## Example transformations
+
+**Before:** "In view of the fact that the existing infrastructure has been rendered inoperative by recent events, it is considered imperative that proactive measures be commenced with a view to facilitating a prompt resolution."
+
+**After:** "Because recent storms broke the power grid, we are fixing the lines today."
+
+**Before:** "The committee must leave no stone unturned to explore every avenue vis-à-vis our competitive status quo, or we will play right into the hands of our rivals."
+
+**After:** "The committee must check every option to improve our position before rivals beat us."
+
+---
+
+Source: George Orwell, "Politics and the English Language" (*Horizon*, April 1946).