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
npx skills add writing-skills # installs into every detected agent (Claude Code, opencode, Codex, ...)
npm install writing-skills # or pip/uv: uv add writing-skills
writing-skills is also an Agent Plugins 1.0.0 package — Claude Code, Codex ≥ 0.147
and Kiro discover plugin.json when you point them at the repo:
git clone https://github.com/surendranb/writing-skills.git
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
Add a skill as a folder under skills/ with a SKILL.md:
namein frontmatter matching the folder; trigger-richdescriptionstarting with "Use when"## The core rule,## Mechanics(numbered, verifiable),## Do not, and at least two before/after## Transform examples
License
MIT — Surendran B. See LICENSE.
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.1.1.tar.gz.
File metadata
- Download URL: writing_skills-0.1.1.tar.gz
- Upload date:
- Size: 32.8 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: uv/0.11.7 {"installer":{"name":"uv","version":"0.11.7","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
8bd41d281b4f87dec15d2a6d1fb5c57079aa529fa6389c9564f5607ac6035749
|
|
| MD5 |
319781300f84ad91b343929d4d0b7432
|
|
| BLAKE2b-256 |
44d540ab4b3ceea59da4c206c986ce3bfdb944991200defb444343c104a1ad5f
|
File details
Details for the file writing_skills-0.1.1-py3-none-any.whl.
File metadata
- Download URL: writing_skills-0.1.1-py3-none-any.whl
- Upload date:
- Size: 29.5 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: uv/0.11.7 {"installer":{"name":"uv","version":"0.11.7","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
be1bce9eae5df7dff535a8c17fb54ba4cedfbdd4c6ee34e42fd795fe89650a79
|
|
| MD5 |
58d9279aa36d9d5edc3480834d6dfb3c
|
|
| BLAKE2b-256 |
c6ca1b222adafcebaf7751339c8280d15a484884c5df87a1d1633e6c463f800a
|