Writing Skills 🖋️
Procedural writing-style skills for AI agents — official frameworks, not vibes.
Ready-made SKILL.md packages: plain language, business writing, corporate
communication, GOV.UK, AP style, STE-100, dev docs — each with numbered mechanics
and a verifiable checklist the agent must pass. Compatible with any agent that
reads SKILL.md (opencode, Claude Code, Codex, Kiro, Gemini).
Skills
Frameworks
| Skill | What it enforces |
|---|---|
plain-language |
Plain Writing Act clarity. Sentences ≤25 words, passive ≤10%, jargon ban list. |
business-writing |
Executive comms. BLUF in the first line, explicit ask + deadline, buzzword ban list. |
corporate-communication |
Company announcements. News first, reader impact explicit, zero euphemism. |
gov-uk-style |
Public-sector readability. Keyword-first headings, ≤25-word sentences, ≤5-sentence paragraphs. |
asd-ste100 |
Safety-critical technical prose. One instruction per sentence, controlled vocabulary, no idioms. |
google-dev-docs |
Developer documentation. Active voice, present tense, verb-first headings, runnable examples. |
journalism-ap |
Factual reporting. AP attribution and number rules, zero editorializing. |
Voices
ted-lasso · jack-sparrow · shrek · yoda · winnie-the-pooh · paddington · bob-ross
Install
| Harness | Command |
|---|---|
| Any agent (recommended) | npx skills add writing-skills — detects and installs into every agent on your machine |
| 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 (Agent Plugins 1.0) |
| npm | npm install writing-skills |
| Python | uv add writing-skills or pip install writing-skills |
Use
Ask for a style and the skill loads automatically:
"rewrite this in plain language" "make this a BLUF business update" "write the press release in AP style" "say it like Ted Lasso"
Every framework skill ends with a Verify checklist (sentence caps, passive-voice
scans, ban lists, readability targets) the agent must pass before delivering.
Contribute
Start from template/SKILL.md and see CONTRIBUTING.md.
Every skill must pass python3 scripts/validate_skills.py — frontmatter, verifiable
mechanics, a Verify checklist, and two transform examples are enforced by CI.
License
MIT — Surendran B. See LICENSE.
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.2.0.tar.gz.
File metadata
- Download URL: writing_skills-0.2.0.tar.gz
- Upload date:
- Size: 27.7 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: uv/0.5.31
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
469cc2fd66e9e7900668259fb704e7263e4fb4d9e9c5bb70d0ce514d9d5a4389
|
|
| MD5 |
fc30e123ebd6bd77a184a92f622f850e
|
|
| BLAKE2b-256 |
fcbd872bccce806375c9a43893e05568be0c3accf0159bca3e72d3dacba5ec58
|
File details
Details for the file writing_skills-0.2.0-py3-none-any.whl.
File metadata
- Download URL: writing_skills-0.2.0-py3-none-any.whl
- Upload date:
- Size: 30.1 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: uv/0.5.31
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
a087b036f4ecf8f21ccf6012bba65fdbf382c3ad460ab6c92c0400a3b6ac2f17
|
|
| MD5 |
b1153b2b9c5056e48f59a8a9761d72ad
|
|
| BLAKE2b-256 |
9228c74f01fb4d1f55f46499eba03651fa7385b31d4366564fa21b8d5b3b13eb
|
