Skip to main content

Writing Skills Logo

Writing Skills 🖋️

License: MIT PyPI npm

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:

  • name in frontmatter matching the folder; trigger-rich description starting 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

writing_skills-0.1.1.tar.gz (32.8 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

writing_skills-0.1.1-py3-none-any.whl (29.5 kB view details)

Uploaded Python 3

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

Hashes for writing_skills-0.1.1.tar.gz
Algorithm Hash digest
SHA256 8bd41d281b4f87dec15d2a6d1fb5c57079aa529fa6389c9564f5607ac6035749
MD5 319781300f84ad91b343929d4d0b7432
BLAKE2b-256 44d540ab4b3ceea59da4c206c986ce3bfdb944991200defb444343c104a1ad5f

See more details on using hashes here.

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

Hashes for writing_skills-0.1.1-py3-none-any.whl
Algorithm Hash digest
SHA256 be1bce9eae5df7dff535a8c17fb54ba4cedfbdd4c6ee34e42fd795fe89650a79
MD5 58d9279aa36d9d5edc3480834d6dfb3c
BLAKE2b-256 c6ca1b222adafcebaf7751339c8280d15a484884c5df87a1d1633e6c463f800a

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page