surendranb/writing-skills

View on GitHub ↗

Procedural writing-style skills for AI agents: official frameworks (plain language, business writing, GOV.UK, AP style, STE-100, developer docs) + character voices. Agent Plugins 1.0.0, works in opencode, Claude Code, Codex.

19 ★0 forksPythonUpdated 19d ago

What you need to know

A pack of 14 candidate-writing Agent Skills (7 writing frameworks + 7 role-based voices) shipped as pure SKILL.md files that any agent able to read skills can use — published to npm and PyPI, installable into Claude Code, Codex, and other skill-capable tools.

Install

npx skills add writing-skills
Claude Code: /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 install writing-skills, or for Python: uv add writing-skills / pip install writing-skills

Usage

  • Enable/install the skills in your agent, then ask for writing in one of the supported styles.
  • Each skill ends with a Verify checklist so the agent self-checks output before returning it.
  • Examples in the README include "Rewrite this in plain language" and per-voice rewrites.

Key features

  • 14 skills organized as frameworks and role-based voices.
  • Pure SKILL.md; works in any agent that reads skill files, with no server or runtime needed.
  • Published on both npm and PyPI; Claude Code plugin marketplace entry included.
  • Cross-agent config: Claude Code plugin, Codex/Kiro auto-discovery, npm and Python package installs.

Best for

Teams that want consistent, prompt-level writing workflows available to coding agents without standing up an MCP server.

Caveats

  • This is an Agent Skills pack, not an MCP server — there is no transport and no remote endpoint.
  • Effectiveness depends on the host agent's skill loading (Claude Code, Codex, Kiro, etc.); Codex needs >=0.147 for auto-discovery.
Platforms: Local

Reviewed 2026-08-18

Topics

agent-skillsai-agentsbusiness-writingclaudeclaude-codecopywritingcursorlanguage-modelmcpmcp-servermodel-context-protocolopencodeplain-languageprompt-engineeringtechnical-writingwriting
Stars
19★
Forks
0
Language
Python
License
MIT
Created
2026-08-14
Last push
2026-08-17