writing SKILL.md skillA

writing from agentic-community/mcp-gateway-registry is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add agentic-community/mcp-gateway-registry/writing@v1.2

Pins v1.2 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
agentic-community/mcp-gateway-registry
Path
.claude/skills/writing/SKILL.md
Versions recorded
3
Latest version
v1.2, committed Oct 31, 2026
First version recorded
Oct 2, 2026
Size
16,646 bytes
Repository stars
1,038
License
Apache-2.0

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.

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# 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.
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add agentic-community/mcp-gateway-registry/writing@sha256:adc1facdf7ff3324

The line at the top of this page pins the label v1.2, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_jcctvtmlbqzzt6eq.svg)](https://markdownregistry.com/a/art_jcctvtmlbqzzt6eq)

3 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 3 versions of this file, between Oct 2, 2026 and Oct 31, 2026, about one every 15 days.

versioncommittedcommitsizeaudit
v1.2 latest2026-10-31 7c64a2d 16,646 BA view · diff
v1.22026-10-02 792c000 13,365 BA view · diff
v1.22026-10-02 e699306 13,945 BA view

Audit of the latest version

A  17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (16646 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

agentic-community/mcp-gateway-registry · 1,038 stars · license Apache-2.0 · pushed 2026-11-07 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_jcctvtmlbqzzt6eq
GET https://markdownregistry.com/api/v1/resolve?ref=agentic-community/mcp-gateway-registry/writing
GET https://markdownregistry.com/api/v1/blob/adc1facdf7ff332414a17b1a0348f247cc36915326dafeb847557b9a72ec90aa

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from agentic-community/mcp-gateway-registry

agentcore-register SKILL.md skill
agentic-community/mcp-gateway-registry · .claude/skills/agentcore-register/SKILL.md · Given an MCP server URL, probe the server via curl to discover its metadata and tools, then generate a markdown file…
git:20260412.d73bd64 · audit A · 1,038 stars
benchmark-report SKILL.md skill
agentic-community/mcp-gateway-registry · .claude/skills/benchmark-report/SKILL.md · Generate a benchmark report from stress test results (registration, API performance, search concurrency). Reads JSON…
v1.0 · audit A · 1,038 stars
create-milestone SKILL.md skill
agentic-community/mcp-gateway-registry · .claude/skills/create-milestone/SKILL.md · Create a GitHub milestone for an upcoming release. Suggests the next version based on the latest release, gathers all…
v2.0 · audit A · 1,038 stars
debug SKILL.md skill
agentic-community/mcp-gateway-registry · .claude/skills/debug/SKILL.md · Debug issues in the MCP Gateway Registry using first-principles thinking. Invoke when something is broken, timing out…
v1.0 · audit A · 1,038 stars
explainer SKILL.md skill
agentic-community/mcp-gateway-registry · .claude/skills/explainer/SKILL.md · Explain a GitHub issue or pull request at 100, 200, and 300 level. Verifies every claim against the code, then writes a…
v1.1 · audit B · 1,038 stars
generate-agent-card SKILL.md skill
agentic-community/mcp-gateway-registry · .claude/skills/generate-agent-card/SKILL.md · Generate an A2A agent card JSON by analyzing agent source code in a folder or GitHub URL. Studies the code to detect…
git:20260406.3e0708d · audit A · 1,038 stars
generate-server-card SKILL.md skill
agentic-community/mcp-gateway-registry · .claude/skills/generate-server-card/SKILL.md · Generate an MCP server card JSON (mcp-gateway-registry format) by analyzing server source code in a folder or GitHub…
git:20260406.3e0708d · audit A · 1,038 stars
infra-sync SKILL.md skill
agentic-community/mcp-gateway-registry · .claude/skills/infra-sync/SKILL.md · Keep Terraform and CDK infrastructure in sync. Compares terraform/aws-ecs/ and infra/ to identify discrepancies in ECS…
v1.0 · audit A · 1,038 stars
macos-setup SKILL.md skill
agentic-community/mcp-gateway-registry · .claude/skills/macos-setup/SKILL.md · Complete macOS setup and teardown for MCP Gateway & Registry (AI-registry). Clones the repository, installs all…
v2.0 · audit B · 1,038 stars
new-feature-design SKILL.md skill
agentic-community/mcp-gateway-registry · .claude/skills/new-feature-design/SKILL.md · Design and document new features with GitHub issue, low-level design (LLD), expert review, and testing plan. Creates…
v1.6 · audit C · 1,038 stars
pr-review SKILL.md skill
agentic-community/mcp-gateway-registry · .claude/skills/pr-review/SKILL.md · Review a GitHub pull request using multiple expert personas. Takes a PR URL as input, analyzes the changes, and…
v1.1 · audit C · 1,038 stars
release-notes SKILL.md skill
agentic-community/mcp-gateway-registry · .claude/skills/release-notes/SKILL.md · Create release notes for a new version tag. Gathers all commits, PRs, issues fixed, and breaking changes since a…
v1.0 · audit A · 1,038 stars

Every file in agentic-community/mcp-gateway-registry

Other files named writing

writing SKILL.md skill
notque/vexjoy-agent · skills/content/writing/SKILL.md · Writing: voice creation and validation, prose editing, anti-AI cleanup, professional communication, translation.
git:20260926.15ab152 · audit A · 446 stars
writing SKILL.md skill
damianvtran/local-operator · local_operator/skills/builtin/writing/SKILL.md · Writing that sounds human: strip AI tells (em dashes, filler, hype, tacked-on tricolons), plain language, active voice…
git:20261010.ee06e2b · audit A · 229 stars
writing SKILL.md skill
iliaal/ai-skills · skills/writing/SKILL.md · Prose editing, rewriting, and humanizing text for natural tone, or auditing a draft for AI tells without rewriting. Use…
git:20261019.5dcf8a9 · audit A · 45 stars
writing SKILL.md skill
iliaal/whetstone · distillery/generated-skills/writing/SKILL.md · Prose editing, rewriting, and humanizing text for natural tone. Use when asked to "write", "rewrite", "edit"…
git:20260227.215f429 · audit A · 35 stars
writing SKILL.md skill
byronxlg/skillfold · library/skills/writing/SKILL.md · Produce clear, structured prose and documentation.
git:20260320.3db1caf · audit A · 15 stars
writing SKILL.md skill
jhostalek/dotclaude · skills/writing/SKILL.md · Rewrite slop, or a reply that did not land, into text a person would write.
git:20261015.21e288c · audit A · 11 stars
writing SKILL.md skill
madarauchiha-314/the-loop · skills/writing/SKILL.md · How the-loop writes for a human reader. Use when authoring or revising any artifact a person will read —…
git:20260912.2726e25 · audit A · 8 stars

Browse by kind, by grade A, or by owner.