Writing

Write prose people will actually read. Use for any prose you produce - docs, READMEs, release notes, blog posts, PR descriptions, issue text, commit bodies, design docs, emails, chat answers. Applies Orwell's six rules and strips the LLM tells - passive voice, dead metaphors, and -ly padding.

1,052 stars 263 forksWriting & Content

Install

skills CLI (Claude Code, Cursor, Codex and more)
npx skills add agentic-community/mcp-gateway-registry --skill writing
Manual install
git clone --depth 1 https://github.com/agentic-community/mcp-gateway-registry.git /tmp/mcp-gateway-registry
mkdir -p ~/.claude/skills
cp -r /tmp/mcp-gateway-registry/.claude/skills/writing ~/.claude/skills/writing

Personal skills live in ~/.claude/skills. Use .claude/skills in a project folder to share a skill with your team.

From the SKILL.md

# Writing Skill

If you want people to read your stuff, follow Orwell's rules.

LLMs are not your friends. They write in passive voice, mix figures of speech that do not fit together, and pad every sentence with -ly words. Cut all of it.

## Orwell's rules

1. Never use a metaphor, simile, or other figure of speech which you are used to seeing in print.
2. Never use a long word where a short one will do.
3. If it is possible to cut a word out, always cut it out.
4. Never use the passive where you can use the active.
5. Never use a foreign phrase, a scientific word, or a jargon word if you can think of an everyday English equivalent.
6. Break any of these rules sooner than say anything outright barbarous.

Rule 6 outranks the other five. A stiff sentence that obeys rules 1-5 is worse than a plain one that breaks one of them.

## How to apply each rule

### 1. No stock figures of speech

Kill any phrase you have read a hundred times. If two images sit in one sentence, they will clash and the reader sees nothing.

Ban list, not exhaustive: game changer, at the end of the day, low-hanging fruit, moving the needle, paradigm shift, deep dive, unlock value, seamless, robust, journey, landscape, ecosystem (unless you mean living things), leverage as a verb, delve, tapestry, testament to, navigate the complexities.

Use a plain statement, or invent an image that fits the thing you are describing.

- Bad: This release is a game changer that unlocks seamless value across the ecosystem.
Read the full skill on GitHub

Details

Skill name
writing
Path
.claude/skills/writing/SKILL.md
License
Apache-2.0
Repo updated
18 November 2026

FAQ

What does the Writing skill do?

Write prose people will actually read. Use for any prose you produce - docs, READMEs, release notes, blog posts, PR descriptions, issue text, commit bodies, design docs, emails, chat answers. Applies Orwell's six rules and strips the LLM tells - passive voice, dead metaphors, and -ly padding.

How do I install the Writing skill?

skills CLI (Claude Code, Cursor, Codex and more): npx skills add agentic-community/mcp-gateway-registry --skill writing. Skills go in ~/.claude/skills (personal) or .claude/skills (project), and Claude loads them automatically when a task matches the description.

Is Writing popular?

It lives in agentic-community/mcp-gateway-registry, which has 1,052 GitHub stars and 263 forks.

Related skills

Agentcore Register

1.1k

agentic-community/mcp-gateway-registry

Given an MCP server URL, probe the server via curl to discover its metadata and tools, then generate a markdown file with copy-pasteable content for each field in the Amazon Bedrock AgentCore "Create record" form.

AI, LLMs & Agents263

Benchmark Report

1.1k

agentic-community/mcp-gateway-registry

Generate a benchmark report from stress test results (registration, API performance, search concurrency). Reads JSON result files and produces a markdown report suitable for docs/benchmarks/.

Testing & QA263

Create Milestone

1.1k

agentic-community/mcp-gateway-registry

Create a GitHub milestone for an upcoming release. Suggests the next version based on the latest release, gathers all merged PRs and closed issues since that release, presents a draft with two tables (Issues and PRs) for user approval, then creates the milestone and assigns all approved items.

Git & Code Review263

Article Illustrations

2k

rmyndharis/antigravity-skills

Generate hand-drawn 16:9 article illustrations featuring the Grav character IP. Turns article concepts into memorable whiteboard-sketch explanations with a recurring floating character, sparse annotations, and absurd metaphors.

Writing & Content295

Usage Report V0

1.1k

agentic-community/mcp-gateway-registry

ARCHIVED - LLM-driven usage report generation (pre-deterministic refactor). Kept as a reference for comparing prose, structure, and content philosophy against the current /usage-report skill. NOT MEANT TO BE INVOKED.

Writing & Content263

Code Documentation Doc Generate

2k

rmyndharis/antigravity-skills

Generate API docs, architecture diagrams, user guides, and technical references from code, keeping documentation comprehensive and maintainable. Use when creating or updating documentation for a codebase.

Writing & Content295

Browse the most popular Claude skills, all writing & content skills, or write your own with the skills generator.