Agent skill

Writing Clearly And Concisely

by Xe in Xe/site

Apply Strunk's timeless writing rules to ANY prose humans will read—documentation, commit messages, error messages, explanations, reports, or UI text.

ZlibAuto-check passedDevelopment

Install Writing Clearly And Concisely

skills CLI
$ npx skills add Xe/site --skill writing-clearly-and-concisely -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install Xe/site writing-clearly-and-concisely --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/Xe/site.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/writing-clearly-and-concisely .claude/skills/writing-clearly-and-concisely && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
writing-clearly-and-concisely
GitHub stars
732
Used in
1 other repo
Token cost
~555 tokens
SKILL.md length
278 words
Files
2
Skills in repo
12
Repo updated
First seen
Licence
Zlib

At a glance

Apply Strunk's timeless writing rules to ANY prose humans will read—documentation, commit messages, error messages, explanations, reports, or UI text.

  • Works in 3 steps: Write your draft using judgment → Dispatch a subagent with your draft and… → Have the subagent copyedit and return…
  • Tasks that involve Commit messages
  • SKILL.md covers Overview, When to Use This Skill, Limited Context Strategy and All Rules, plus 1 more section
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Writing Clearly And Concisely is an agent skill from Xe/site. Apply Strunk's timeless writing rules to ANY prose humans will read—documentation, commit messages, error messages, explanations, reports, or UI text. Makes your writing clearer, stronger, and more professional.

Its SKILL.md is about 560 tokens, which your agent loads only when the skill is triggered. The skill folder holds 1 other file (for example `elements-of-style.md`).

It sits in Development, covering Commit messages and Brand voice and tone. The repository describes itself as: The new frontend/backend code for https://xeiaso.net. The licence is Zlib.

When your agent uses it

  • Tasks that involve Commit messages
  • Tasks that involve Brand voice and tone

Example prompts

  • “/writing-clearly-and-concisely”

Workflow steps

3 steps, taken from the first numbered list in SKILL.md.

  1. Write your draft using judgment
  2. Dispatch a subagent with your draft and elements-of-style.md
  3. Have the subagent copyedit and return the revision

What it can do on your machine

Read from SKILL.md and the folder at commit ca51680. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Writing Clearly And Concisely loads about 555 tokens when it runs. Until then it costs about 60 tokens; SKILL.md has 278 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~60
When it runs · the whole SKILL.md, loaded when a task matches
~555

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from Xe/site at commit ca51680, republished under its Zlib licence (© Xe). 278 words, ~555 tokens.

Download SKILL.mdSave it as .claude/skills/writing-clearly-and-concisely/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
writing-clearly-and-concisely
description
Apply Strunk's timeless writing rules to ANY prose humans will read—documentation, commit messages, error messages, explanations, reports, or UI text. Makes your writing clearer, stronger, and more professional.

Writing Clearly and Concisely

Overview

William Strunk Jr.'s The Elements of Style (1918) teaches you to write clearly and cut ruthlessly.

WARNING: elements-of-style.md consumes ~12,000 tokens. Read it only when writing or editing prose.

When to Use This Skill

Use this skill whenever you write prose for humans:

  • Documentation, README files, technical explanations
  • Commit messages, pull request descriptions
  • Error messages, UI copy, help text, comments
  • Reports, summaries, or any explanation
  • Editing to improve clarity

If you're writing sentences for a human to read, use this skill.

Limited Context Strategy

When context is tight:

  1. Write your draft using judgment
  2. Dispatch a subagent with your draft and elements-of-style.md
  3. Have the subagent copyedit and return the revision

All Rules

Elementary Rules of Usage (Grammar/Punctuation)
  1. Form possessive singular by adding 's
  2. Use comma after each term in series except last
  3. Enclose parenthetic expressions between commas
  4. Comma before conjunction introducing co-ordinate clause
  5. Don't join independent clauses by comma
  6. Don't break sentences in two
  7. Participial phrase at beginning refers to grammatical subject
Elementary Principles of Composition
  1. One paragraph per topic
  2. Begin paragraph with topic sentence
  3. Use active voice
  4. Put statements in positive form
  5. Use definite, specific, concrete language
  6. Omit needless words
  7. Avoid succession of loose sentences
  8. Express co-ordinate ideas in similar form
  9. Keep related words together
  10. Keep to one tense in summaries
  11. Place emphatic words at end of sentence
Section V: Words and Expressions Commonly Misused

Alphabetical reference for usage questions

Bottom Line

Writing for humans? Read elements-of-style.md and apply the rules. Low on tokens? Dispatch a subagent to copyedit with the guide.

© Xe, Zlib. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 1 other file in .agents/skills/writing-clearly-and-concisely of Xe/site.

  • SKILL.md
  • elements-of-style.md

Open the folder on GitHubat commit ca51680

Used in 1 other repository

We found 1 copy of this SKILL.md (exact, near-identical or edited) in other folders, from 1 other GitHub owner. This page covers the copy in Xe/site, which our catalogue first saw on October 7, 2026.

Compare with similar skills

Writing Clearly And Concisely next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Writing Clearly And Concisely compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Writing Clearly And Concisely this skillXe/site7321 repos~555Automated safety check: PassZlib
Writing Styletimmo001/system-bridge356—~3.3kAutomated safety check: PassApache-2.0
Writing Stylepydantic/monty8.6k—~3.2kAutomated safety check: PassMIT
Agent Stylepchalasani/claude-code-tools2k—~1.4kAutomated safety check: PassMIT
Writing Styleumputun/cc-thingz484—~1.3kAutomated safety check: PassMIT
Writing Styleopen-thoughts/OpenThoughts-Agent301—~1.3kAutomated safety check: PassApache-2.0

Similar skills

  • Writing Style

    timmo001/system-bridge

    Write commit messages, PR and issue text and comments, docs (README), code comments, and user-facing strings (notifications, UI labels, toasts, error messages) in the project owner's voice: concise…

    356 GitHub stars~3.3k tokensUpdated yesterday
    DevelopmentAuto-check passed
  • Writing Style

    pydantic/monty

    Official

    How to write prose that reads like human technical documentation rather than LLM output.

    8.6k GitHub stars~3.2k tokensUpdated yesterday
    DevelopmentAuto-check passed
  • Agent Style

    pchalasani/claude-code-tools

    Literature-backed English technical-prose writing rules (agent-style, 21 rules).

    2k GitHub stars~1.4k tokensUpdated yesterday
    DevelopmentAuto-check passed
  • Writing Style

    umputun/cc-thingz

    A skill your agent uses for technical communication - GitHub/GitLab tickets, PR/MR descriptions, issue comments, code review comments, commit messages.

    484 GitHub stars~1.3k tokensUpdated 4 days ago
    DevelopmentAuto-check passed
  • Writing Style

    open-thoughts/OpenThoughts-Agent

    Marin house writing style. An agent skill from open-thoughts/OpenThoughts-Agent.

    301 GitHub stars~1.3k tokensUpdated 11 days ago
    Writing & ContentAuto-check passed
  • Write

    waynesutton/markdown-site

    Writing style guide for technical content, social media, blog posts, READMEs, git commits, and developer documentation.

    628 GitHub stars~3k tokensUpdated 4 mo ago
    Writing & ContentAuto-check passed
  • Stop Slop

    Xe/site

    Remove AI writing patterns from prose. An agent skill from Xe/site.

    732 GitHub starsUsed in 8 repos~423 tokens
    Auto-check passed
  • Choose and create the right Neon branch type for testing and development.

    732 GitHub starsUsed in 3 repos~2.4k tokens
    Auto-check: notes
  • Guides and best practices for working with Neon Serverless Postgres.

    732 GitHub starsUsed in 2 repos~1.8k tokens
    Auto-check passed
  • A skill your agent uses when creating git commits, writing commit messages, or following version control workflows

    732 GitHub stars~1.3k tokensUpdated yesterday
    Auto-check passed
  • A skill your agent uses when asked to generate a "no way to prevent this" / no-way-to-prevent-this satire post for a memory-safety CVE (out-of-bounds write/read, buffer/heap overflow…

    732 GitHub stars~816 tokensUpdated yesterday
    Auto-check passed
  • Create reusable templ UI components with props, children, and composition patterns.

    732 GitHub stars~552 tokensUpdated yesterday
    Auto-check passed

Categories

Questions about Writing Clearly And Concisely

What does Writing Clearly And Concisely do?

Apply Strunk's timeless writing rules to ANY prose humans will read—documentation, commit messages, error messages, explanations, reports, or UI text. Writing Clearly And Concisely is an agent skill from Xe/site. Apply Strunk's timeless writing rules to ANY prose humans will read—documentation, commit messages, error messages, explanations, reports, or UI text.

When should I use Writing Clearly And Concisely?

Writing Clearly And Concisely fits situations like: tasks that involve Commit messages; tasks that involve Brand voice and tone.

How do I install Writing Clearly And Concisely in Claude Code?

Run `npx skills add Xe/site --skill writing-clearly-and-concisely -a claude-code`. Or copy the skill folder (.agents/skills/writing-clearly-and-concisely in Xe/site) into .claude/skills/writing-clearly-and-concisely in your project. Claude Code loads it when a task matches its description.

How do I install Writing Clearly And Concisely in Codex?

Run `npx skills add Xe/site --skill writing-clearly-and-concisely -a codex`. Or copy the skill folder (.agents/skills/writing-clearly-and-concisely in Xe/site) into .agents/skills/writing-clearly-and-concisely in your project. Codex loads it when a task matches its description.

Can I use Writing Clearly And Concisely in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add Xe/site --skill writing-clearly-and-concisely -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/writing-clearly-and-concisely, .gemini/skills/writing-clearly-and-concisely, .github/skills/writing-clearly-and-concisely and .opencode/skills/writing-clearly-and-concisely in your project.

What does Writing Clearly And Concisely need to run?

SKILL.md names no scripts, command-line tools or credentials: Writing Clearly And Concisely is instructions for the agent only.

Does Writing Clearly And Concisely access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Writing Clearly And Concisely safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Writing Clearly And Concisely use?

Writing Clearly And Concisely is published under the Zlib licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Writing Clearly And Concisely use?

About 555 tokens (SKILL.md is roughly 2.2k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Writing Clearly And Concisely?

Skills that share tags, products or a category with Writing Clearly And Concisely: Writing Style (timmo001/system-bridge, 356 stars), Writing Style (pydantic/monty, 8.6k stars), Agent Style (pchalasani/claude-code-tools, 2k stars) and Writing Style (umputun/cc-thingz, 484 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Writing Clearly And Concisely?

Xe (a GitHub user) maintains it in Xe/site, which has 732 GitHub stars. The repository holds 12 skills in this directory. The repository was last updated on October 8, 2026.

Source: Xe/site on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.