writing-skills
15 writing-style skills for AI agents: 8 measurable frameworks, 7 character voices.
Plain SKILL.md files. 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. |
scott-adams |
Simplicity-is-persuasion. Curiosity-hook openers, ≤15-word sentences, prune "very/really". |
Voices — characters, rate-limited against caricature
ted-lasso · jack-sparrow · shrek · yoda · winnie-the-pooh · paddington · bob-ross
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.5.0.tar.gz.
File metadata
- Download URL: writing_skills-0.5.0.tar.gz
- Upload date:
- Size: 33.2 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
bbcd628672e1af4e7d86c125847166e5f8df840dfd3df5567170599b29085bd6
|
|
| MD5 |
ff2928cce02c377bbc517a1f9506f88d
|
|
| BLAKE2b-256 |
3cd7b5841ebe18f88acf4c2be2cf5967796c7dd1075057b0c66ff741725066da
|
Provenance
The following attestation bundles were made for writing_skills-0.5.0.tar.gz:
Publisher:
release.yml on surendranb/writing-skills
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
writing_skills-0.5.0.tar.gz -
Subject digest:
bbcd628672e1af4e7d86c125847166e5f8df840dfd3df5567170599b29085bd6 - Sigstore transparency entry: 2501001018
- Sigstore integration time:
-
Permalink:
surendranb/writing-skills@0be064a8d665350dd0b622db1921496aac5d546e -
Branch / Tag:
refs/tags/v0.5.0 - Owner: https://github.com/surendranb
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
release.yml@0be064a8d665350dd0b622db1921496aac5d546e -
Trigger Event:
release
-
Statement type:
File details
Details for the file writing_skills-0.5.0-py3-none-any.whl.
File metadata
- Download URL: writing_skills-0.5.0-py3-none-any.whl
- Upload date:
- Size: 35.5 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
83d89c3bca418f294ba39e58f5fc31b5f4455d33b8c33afc1f0b50b4937baf9f
|
|
| MD5 |
feb14bc67c4318be39167a4db41134ae
|
|
| BLAKE2b-256 |
4328ac9c67b9cee74cd2580492140cb912d8f2f811bbfb58ec73d297823ccabf
|
Provenance
The following attestation bundles were made for writing_skills-0.5.0-py3-none-any.whl:
Publisher:
release.yml on surendranb/writing-skills
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
writing_skills-0.5.0-py3-none-any.whl -
Subject digest:
83d89c3bca418f294ba39e58f5fc31b5f4455d33b8c33afc1f0b50b4937baf9f - Sigstore transparency entry: 2501001036
- Sigstore integration time:
-
Permalink:
surendranb/writing-skills@0be064a8d665350dd0b622db1921496aac5d546e -
Branch / Tag:
refs/tags/v0.5.0 - Owner: https://github.com/surendranb
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
release.yml@0be064a8d665350dd0b622db1921496aac5d546e -
Trigger Event:
release
-
Statement type:
