Agent skill

Writing Clearly And Concisely

by JanDeDobbeleer in JanDeDobbeleer/oh-my-posh

Apply whenever writing content a human will read — emails, documents, reports, documentation, messages, UI copy, commit messages, explanations, or any other prose.

MITAuto-check passedDevelopment

Install Writing Clearly And Concisely

skills CLI
$ npx skills add JanDeDobbeleer/oh-my-posh --skill writing-clearly-and-concisely -a claude-code

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

GitHub CLI
$ gh skill install JanDeDobbeleer/oh-my-posh 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/JanDeDobbeleer/oh-my-posh.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
24k
Token cost
~1k tokens
SKILL.md length
461 words
Files
8
Skills in repo
11
Repo updated
First seen
Licence
MIT

At a glance

Apply whenever writing content a human will read — emails, documents, reports, documentation, messages, UI copy, commit messages, explanations, or any other prose.

  • 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 Elements of Style, plus 2 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Writing Clearly And Concisely is an agent skill from JanDeDobbeleer/oh-my-posh. Apply whenever writing content a human will read — emails, documents, reports, documentation, messages, UI copy, commit messages, explanations, or any other prose. Applies Strunk's timeless rules for clearer, stronger, more professional writing.

Its SKILL.md is about 1k tokens, which your agent loads only when the skill is triggered. The skill folder holds 8 other files (for example `README.md`, `elements-of-style/01-introductory.md` and `elements-of-style/02-elementary-rules-of-usage.md`).

It sits in Development, covering Commit messages. It works with Bash. The repository describes itself as: The most customisable and low-latency cross platform/shell prompt renderer. The licence is MIT.

When your agent uses it

  • Tasks that involve Commit messages

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 the relevant section file
  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 85386c0. 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 1k tokens when it runs. Until then it costs about 69 tokens; SKILL.md has 461 words of instructions outside code blocks.

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

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 JanDeDobbeleer/oh-my-posh at commit 85386c0, republished under its MIT licence (© JanDeDobbeleer). 461 words, ~1,047 tokens.

Download SKILL.mdSave it as .claude/skills/writing-clearly-and-concisely/SKILL.md (or your agent's skills folder). This skill also uses 7 other files; get the full folder from GitHub.
name
writing-clearly-and-concisely
description
Apply whenever writing content a human will read — emails, documents, reports, documentation, messages, UI copy, commit messages, explanations, or any other prose. Applies Strunk's timeless rules for clearer, stronger, more professional writing.

Writing Clearly and Concisely

Overview

Write with clarity and force. This skill covers what to do (Strunk) and what not to do (AI patterns).

When to Use This Skill

Use this skill whenever you write content a human will read:

  • Emails, messages, and any direct communication
  • Documents, reports, summaries, proposals
  • Documentation, README files, technical explanations
  • Commit messages, pull request descriptions
  • Error messages, UI copy, help text, comments
  • Any other prose meant for human eyes

If a human will read it, this skill applies — no exceptions.

Limited Context Strategy

When context is tight:

  1. Write your draft using judgment
  2. Dispatch a subagent with your draft and the relevant section file
  3. Have the subagent copyedit and return the revision

Loading a single section (~1,000-4,500 tokens) instead of everything saves significant context.

Elements of Style

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

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
Show full SKILL.md (185 more words)Show less
Reference Files

The rules above are summarized from Strunk's original text. For complete explanations with examples:

SectionFile~Tokens
Grammar, punctuation, comma rules02-elementary-rules-of-usage.md2,500
Paragraph structure, active voice, concision03-elementary-principles-of-composition.md4,500
Headings, quotations, formatting04-a-few-matters-of-form.md1,000
Word choice, common errors05-words-and-expressions-commonly-misused.md4,000

Most tasks need only 03-elementary-principles-of-composition.md — it covers active voice, positive form, concrete language, and omitting needless words.

AI Writing Patterns to Avoid

LLMs regress to statistical means, producing generic, puffy prose. Avoid:

  • Puffery: pivotal, crucial, vital, testament, enduring legacy
  • Empty "-ing" phrases: ensuring reliability, showcasing features, highlighting capabilities
  • Promotional adjectives: groundbreaking, seamless, robust, cutting-edge
  • Overused AI vocabulary: delve, leverage, multifaceted, foster, realm, tapestry
  • Em dashes: never use em dashes (— or --); restructure the sentence instead
  • Formatting overuse: excessive bullets, emoji decorations, bold on every other word

Be specific, not grandiose. Say what it actually does.

For comprehensive research on why these patterns occur, see signs-of-ai-writing.md. Wikipedia editors developed this guide to detect AI-generated submissions — their patterns are well-documented and field-tested.

Bottom Line

Writing for humans? Load the relevant section from elements-of-style/ and apply the rules. For most tasks, 03-elementary-principles-of-composition.md covers what matters most.

© JanDeDobbeleer, MIT. 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 7 other files in .agents/skills/writing-clearly-and-concisely of JanDeDobbeleer/oh-my-posh.

  • SKILL.md
  • README.md
  • elements-of-style/01-introductory.md
  • elements-of-style/02-elementary-rules-of-usage.md
  • elements-of-style/03-elementary-principles-of-composition.md
  • elements-of-style/04-a-few-matters-of-form.md
  • elements-of-style/05-words-and-expressions-commonly-misused.md
  • signs-of-ai-writing.md

Open the folder on GitHubat commit 85386c0

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 skillJanDeDobbeleer/oh-my-posh24k—~1kAutomated safety check: PassMIT
CommitTypedDevs/bashunit434—~781Automated safety check: NotesMIT
Commitalex35mil/dotfiles301—~438Automated safety check: WarnNone
Commitmeain/dotfiles285—~723Automated safety check: PassMIT
Mole Bug Patternstw93/Mole70k—~2kAutomated safety check: PassGPL-3.0
Contextual Commit Messagesyamadashy/repomix29k1 repos~2.7kAutomated safety check: PassMIT

Similar skills

  • Commit

    TypedDevs/bashunit

    Stage and commit changes using conventional commits format. An agent skill from TypedDevs/bashunit.

    434 GitHub stars~781 tokensUpdated yesterday
    DevelopmentAuto-check: notes
  • Commit

    alex35mil/dotfiles

    Creates a git commit for the current repository using this repo's commit style.

    301 GitHub stars~438 tokensUpdated 1 mo ago
    DevelopmentAuto-check: warnings
  • Commit

    meain/dotfiles

    Create git commits for dotfiles changes, grouping by component with conventional prefix style

    285 GitHub stars~723 tokensUpdated 2 days ago
    DevelopmentAuto-check passed
  • A catalog of recurring bug shapes in the Mole Mac cleaner, used to review safety-sensitive diffs for deletion safety, unbounded commands, shell traps and weak tests.

    70k GitHub stars~2k tokensUpdated today
    DevelopmentAuto-check passed
  • Writes Conventional Commits whose bodies carry action lines recording the intent, decisions and constraints behind a change, not only what changed.

    29k GitHub starsUsed in 1 repo~2.7k tokens
    DevelopmentAuto-check passed
  • React Router Release Notes Prep

    remix-run/react-router

    Polishes pending React Router change files before the versioning scripts run, and decides whether a long-form What's Changed section is warranted.

    57k GitHub stars~1.1k tokensUpdated yesterday
    DevelopmentAuto-check passed

More from JanDeDobbeleer/oh-my-posh

All 11 skills in this repo
  • Segment Docs

    JanDeDobbeleer/oh-my-posh

    Reference mapping between Oh My Posh Go segment source code and MDX documentation.

    24k GitHub stars~1.1k tokensUpdated today
    Auto-check passed
  • Segment Create

    JanDeDobbeleer/oh-my-posh

    Full scaffolding workflow for creating a new Oh My Posh segment.

    24k GitHub stars~1.2k tokensUpdated today
    Auto-check passed
  • Architecture

    JanDeDobbeleer/oh-my-posh

    Cross-language architecture and clean-code principles for this project: Clean Code, Object Calisthenics, SOLID, guard clauses, hot-path cost, and the code review checklist.

    24k GitHub stars~1.5k tokensUpdated today
    Auto-check passed
  • Conventional Commit

    JanDeDobbeleer/oh-my-posh

    Workflow for generating conventional commit messages following the Conventional Commits specification.

    24k GitHub stars~1.2k tokensUpdated today
    Auto-check: notes
  • Golang

    JanDeDobbeleer/oh-my-posh

    Go coding standards and conventions for this project. An agent skill from JanDeDobbeleer/oh-my-posh.

    24k GitHub stars~4.3k tokensUpdated today
    Auto-check passed
  • Markdown

    JanDeDobbeleer/oh-my-posh

    Markdown formatting rules for this project. An agent skill from JanDeDobbeleer/oh-my-posh.

    24k GitHub stars~754 tokensUpdated today
    Auto-check passed

Works with

Categories

Questions about Writing Clearly And Concisely

What does Writing Clearly And Concisely do?

Apply whenever writing content a human will read — emails, documents, reports, documentation, messages, UI copy, commit messages, explanations, or any other prose. Writing Clearly And Concisely is an agent skill from JanDeDobbeleer/oh-my-posh. Apply whenever writing content a human will read — emails, documents, reports, documentation, messages, UI copy, commit messages, explanations, or any other prose.

When should I use Writing Clearly And Concisely?

Writing Clearly And Concisely fits situations like: tasks that involve Commit messages.

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

Run `npx skills add JanDeDobbeleer/oh-my-posh --skill writing-clearly-and-concisely -a claude-code`. Or copy the skill folder (.agents/skills/writing-clearly-and-concisely in JanDeDobbeleer/oh-my-posh) 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 JanDeDobbeleer/oh-my-posh --skill writing-clearly-and-concisely -a codex`. Or copy the skill folder (.agents/skills/writing-clearly-and-concisely in JanDeDobbeleer/oh-my-posh) 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 JanDeDobbeleer/oh-my-posh --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 MIT 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 1k tokens (SKILL.md is roughly 4.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: Commit (TypedDevs/bashunit, 434 stars), Commit (alex35mil/dotfiles, 301 stars), Commit (meain/dotfiles, 285 stars) and Mole Bug Patterns (tw93/Mole, 70k 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?

JanDeDobbeleer (a GitHub user) maintains it in JanDeDobbeleer/oh-my-posh, which has 23,567 GitHub stars. The repository holds 11 skills in this directory. The repository was last updated on October 10, 2026.

Source: JanDeDobbeleer/oh-my-posh on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.