18f-content

Agent Stylebooks

Pick the writing system before the model picks one for you.

Stop asking AI to “write better.” Give it an editorial system.

Portable Agent Skills based on established editorial systems.

npx skills add Neeeophytee/agent-stylebooks

Browse stylebooks · Installation · Examples · Provenance

Each stylebook defines what to lead with, how to order information, which distinctions must survive editing, what ambiguity is unacceptable, and how to check the result. These are community-maintained Agent Skills derived from publicly documented editorial guidance, not official vendor or agency products.

Which stylebook should I use?

Choose by the reader's task and the artifact—not by the organization named in the draft.

Compare all 16 stylebooks →

Prompt vs stylebook

See the difference

These original examples illustrate the systems; they are not quotations or claimed outputs from the source organizations.

Generic technical prose

To successfully initiate configuration, authentication credentials must first be appropriately established.

$google-developer-docs

Before you configure the integration, set up your authentication credentials.

Generic error

An error occurred while processing your request. Please try again later.

$microsoft-writing-style

We couldn't save your changes. Check your connection and try again.

Generic risk statement

Unfavorable market conditions may adversely affect our results.

$sec-plain-english

If borrowing costs rise, our interest expense may increase and reduce our net income.

Install

The portable installer currently requires Node.js 22.20 or newer.

# List the catalog
npx skills add Neeeophytee/agent-stylebooks --list

# Install one stylebook
npx skills add Neeeophytee/agent-stylebooks --skill cdc-clear-communication

# Install all 16
npx skills add Neeeophytee/agent-stylebooks

Claude Code and Codex can also install the repository as a plugin. Manual, project-level, and agent-specific routes are in INSTALL.md.

Use

Use $google-developer-docs to turn these notes into a setup guide.
Use $govuk to rewrite this eligibility page around the user's decision.
Use $apple-interface-writing to tighten these labels and error messages.

Use one primary stylebook unless the task explicitly needs a hybrid. A product terminology guide still governs product names; the stylebook governs structure and prose. Every skill must preserve supplied facts, code behavior, legal meaning, and domain constraints.

Compatibility

Every stylebook uses the open SKILL.md format and remains an immediate child of skills/. That flat layout supports Codex, Claude Code, Kimi Code CLI, Cursor, Hermes Agent, GitHub Copilot, Gemini CLI, and other compatible loaders.

Compatibility means the repository follows each documented discovery shape. It does not imply that the source organizations created or tested these stylebooks. See COMPATIBILITY.md for test evidence and INSTALL.md for the exact routes.

Provenance and limits

PROVENANCE.md records the authoritative source and reuse decision for every stylebook. Openly licensed and public-domain sources still use independently written rules. Restricted or unclear sources are reference-only interpretations.

The repository's original text and scripts are MIT licensed. Third-party guides retain their own terms. No source organization endorses this project. A stylebook does not provide legal, medical, regulatory, standards, or publication approval. See NOTICE.md.

Validate and contribute

python3 scripts/validate_repo.py

CI checks structure, names, frontmatter, manifests, provenance, links, duplicate inventory, and the byte integrity of the original 11 skills. Read CONTRIBUTING.md before proposing another editorial system or use the stylebook request form.