`writing-skills` is a set of reusable style instructions for agent writing. Each skill lives in its own `SKILL.md`, so you can ask for plain language, business writing, GOV.UK style, AP style, or a character voice and have the agent apply the right rules. The repo also includes plugin metadata for Claude Code, Codex, and Gemini, plus a validation script that checks the skills before release.
Builders who want their agent to write in a consistent style across docs, updates, and messages.
You can ask for a style once and get writing that follows the same rules every time.
Includes 9 framework skills and 7 voice skills, each as a separate `SKILL.md` file.
Covers plain language, business writing, corporate communication, GOV.UK style, Simplified Technical English, Google developer docs, AP style, Orwell's rules, and Scott Adams style.
Adds voice skills like `bob-ross`, `jack-sparrow`, `paddington`, `shrek`, `ted-lasso`, `winnie-the-pooh`, and `yoda`.
Includes plugin files for Claude Code, Codex, and Gemini so the same skill pack can be installed through those workflows.
`scripts/validate_skills.py` checks that the skills follow the repo's contract before you ship them.
npx skills add writing-skills
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).
npx skills add writing-skills
One command, every agent on your machine.
| Harness | Command |
|---|---|
| Claude Code plugin | /plugin marketplace add surendranb/writing-skills then /plugin install writing-skills@writing-skills |
| Codex ≥ 0.147 / Kiro | git clone https://github.com/surendranb/writing-skills.git — plugin.json is auto-discovered |
| npm | npm install writing-skills |
| Python | uv add writing-skills or pip install writing-skills |
Ask for the style. The skill loads itself.
"rewrite this in plain language" · "make this a BLUF business update" · "press release in AP style" · "say it like Yoda"
Every skill ends with a Verify checklist the agent must pass before it delivers.
| 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 |
| 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. |
gov-uk-style | GOV.UK guide. Keyword-first headings, ≤5-sentence paragraphs. |
asd-ste100 | Simplified Technical English. One instruction per sentence, no idioms. |
google-dev-docs | Google style. Active voice, present tense, verb-first headings. |
journalism-ap | AP Stylebook. Attribution, number rules, zero editorializing. |
scott-adams | Simplicity-is-persuasion. Curiosity-hook openers, ≤15-word sentences, prune "very/really". |
ted-lasso · jack-sparrow · shrek · yoda · winnie-the-pooh · paddington · bob-ross
Copy template/SKILL.md, fill it, run
python3 scripts/validate_skills.py. CI enforces the contract — see
CONTRIBUTING.md.
MIT — Surendran B
Sign in to join the discussion.
No comments yet. Be the first to say what this is good for.
Turn any codebase, with its docs, SQL schemas, configs, and PDFs, into a queryable knowledge graph. A /graphify skill for Claude Code, Cursor, Codex, and Gemini CLI: local deterministic AST parsing, every edge explained, no vector store.
Topic in, narrated explainer video out. A Claude Code / Codex skill that turns any topic into a black-canvas motion-graphics explainer video with TTS voiceover, subtitles and a chapter progress bar. Chinese or English; every frame drawn in code with Remotion.
Public repository for Agent Skills
Open-source AI job search: scan job portals, evaluate listings into a structured A-H report with a global 1-5 score, tailor your CV, track applications — runs locally in your AI coding CLI (Claude Code, Codex, OpenCode, Antigravity…)
Agent skill for beautiful, verifiable architecture, workflow, sequence, data-flow, and lifecycle diagrams—self-contained HTML with motion and crisp export.
A skill to stop your coding agent from burying the answer. ADHD-friendly output.