writing-skills
14 writing-style skills for AI agents: 7 measurable frameworks, 7 character voices.
Plain SKILL.md files — no code, no server. Works in any agent that reads skills
(Claude Code, opencode, Codex, Cursor, Kiro, Gemini).
Install
npx skills add writing-skills
One command, every agent on your machine.
Other install methods
| 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 |
Use
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.
The skills
Frameworks — real standards, enforced
| Skill | Enforces |
|---|---|
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. |
Voices — characters, rate-limited against caricature
ted-lasso · jack-sparrow · shrek · yoda · winnie-the-pooh · paddington · bob-ross
MCP server — unlimited skills, live from GitHub
uvx writing-skills-mcp
The plugin ships 14 skills statically. The MCP server is the living registry
on top: it discovers styles from the full catalog on GitHub (search_styles),
returns any skill's full SKILL.md (get_skill), and installs it into a
harness skills directory (install_skill). A new skill is just a commit —
no package update, no re-install, at any scale.
uvx --from writing-skills writing-skills-mcp
Contribute
Copy template/SKILL.md, fill it, run
python3 scripts/validate_skills.py. CI enforces the contract — see
CONTRIBUTING.md.
License
MIT — Surendran B
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file writing_skills-0.3.1.tar.gz.
File metadata
- Download URL: writing_skills-0.3.1.tar.gz
- Upload date:
- Size: 51.0 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/7.0.0 CPython/3.12.13
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
80e54ddbea5b9e6a14c0566fcf5feffe15e99b297be73f7f360ea5d07718e47e
|
|
| MD5 |
0ac3201b1e31b330fa6787d896966c40
|
|
| BLAKE2b-256 |
8479845449af61ade6a3e6d1440c79fee1f491755bcc706c654bf06ce8ea9394
|
File details
Details for the file writing_skills-0.3.1-py3-none-any.whl.
File metadata
- Download URL: writing_skills-0.3.1-py3-none-any.whl
- Upload date:
- Size: 52.7 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/7.0.0 CPython/3.12.13
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
64d1bda783eca9183b158affc72fc08f8a5587ee943242c68bc71cf13808560c
|
|
| MD5 |
190223a70490d4050d4d44e9fa3cc6c9
|
|
| BLAKE2b-256 |
24c76219d2d29c1f2913e16a7899dc91c1d1315ba9745bd2838b7210795237eb
|
