\n\n# writing-skills\n\n**16 writing-style skills for AI agents: 9 measurable frameworks, 7 character voices.**\nPlain `SKILL.md` files. Works in any agent that reads skills\n(Claude Code, opencode, Codex, Cursor, Kiro, Gemini).\n\n[](https://www.npmjs.com/package/writing-skills)\n[](https://pypi.org/project/writing-skills/)\n[](LICENSE)\n\n## Install\n\n```bash\nnpx skills add writing-skills\n```\n\nOne command, every agent on your machine.\n\n\nOther install methods\n\n| Harness | Command |\n| :--- | :--- |\n| Claude Code plugin | `/plugin marketplace add surendranb/writing-skills` then `/plugin install writing-skills@writing-skills` |\n| Codex ≥ 0.147 / Kiro | `git clone https://github.com/surendranb/writing-skills.git` — `plugin.json` is auto-discovered |\n| npm | `npm install writing-skills` |\n| Python | `uv add writing-skills` or `pip install writing-skills` |\n\n\n\n## Use\n\nAsk for the style. The skill loads itself.\n\n> \"rewrite this in plain language\" · \"make this a BLUF business update\" ·\n> \"press release in AP style\" · \"say it like Yoda\"\n\nEvery skill ends with a `Verify` checklist the agent must pass before it delivers.\n\n### Examples\n\n| You say | Skill that fires | What you get |\n| :--- | :--- | :--- |\n| \"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 |\n| \"Turn these notes into an update for my VP\" | `business-writing` | BLUF first line, the ask and deadline explicit, buzzwords deleted |\n| \"Write the release notes for v2.0\" | `google-dev-docs` | Active voice, present tense, verb-first headings |\n| \"Draft the outage announcement\" | `corporate-communication` | News in line one, reader impact named, zero euphemism |\n| \"Make this maintenance manual usable by non-native speakers\" | `asd-ste100` | Simplified Technical English: one instruction per sentence, no idioms |\n| \"Press release for the funding round, AP style\" | `journalism-ap` | AP Stylebook attribution and number rules, no editorializing |\n| \"Explain recursion like Bob Ross\" | `bob-ross` | A happy little explanation — calm, encouraging, and technically correct |\n| \"Rejection email, but make it Paddington\" | `paddington` | Firm news delivered with unfailing politeness |\n\n## The skills\n\n### Frameworks — real standards, enforced\n\n| Skill | Enforces |\n| :--- | :--- |\n| `orwells-rules` | Orwell's 6 rules. Zero dead metaphors, short Saxon words, prune verbal limbs, active voice, barbarism override. |\n| `plain-language` | Plain Writing Act. Sentences ≤25 words, passive ≤10%, jargon ban list. |\n| `business-writing` | BLUF first line, explicit ask + deadline, buzzword ban list. |\n| `corporate-communication` | News first, reader impact named, zero euphemism. |\n| `gov-uk-style` | GOV.UK guide. Keyword-first headings, ≤5-sentence paragraphs. |\n| `asd-ste100` | Simplified Technical English. One instruction per sentence, no idioms. |\n| `google-dev-docs` | Google style. Active voice, present tense, verb-first headings. |\n| `journalism-ap` | AP Stylebook. Attribution, number rules, zero editorializing. |\n| `scott-adams` | Simplicity-is-persuasion. Curiosity-hook openers, ≤15-word sentences, prune \"very/really\". |\n\n### Voices — characters, rate-limited against caricature\n\n`ted-lasso` · `jack-sparrow` · `shrek` · `yoda` · `winnie-the-pooh` · `paddington` · `bob-ross`\n\n## Contribute\n\nCopy [template/SKILL.md](template/SKILL.md), fill it, run\n`python3 scripts/validate_skills.py`. CI enforces the contract — see\n[CONTRIBUTING.md](CONTRIBUTING.md).\n\n## License\n\nMIT — [Surendran B](https://github.com/surendranb)\n",
"bytes": 3913,
"sha": "821c7dd9bb4409ed793b61ec7573f81b4739840b5de96b84e1f08e46c0760504",
"repo_slug": "surendranb/writing-skills",
"fonte": "repo",
"truncated": false,
"api": "https://agentalog.com/api/listings/plg_surendranb_writing_skills_8e8b556a/readme"
}
![\"writing-skills](\"logo.svg\")
\n