skilld
All skills
softaworks avatar

/writing-clearly-and-concisely

@1c0662a
by softaworkssoftaworks/agent-toolkit2.5k stars
230

Use when writing prose humans will read—documentation, commit messages, error messages, explanations, reports, or UI text. Applies Strunk's timeless rules for clearer, stronger, more professional writing.

Ask your Agent

Use this Skill: https://skilld.dev/gh/softaworks/agent-toolkit/writing-clearly-and-concisely

This session only. Nothing lands on disk.

elements-of-style01-introductory.md

≈76 tokens on demand. Your agent reads this file only when SKILL.md points to it.

I. Introductory

This handbook summarizes the essentials of plain English style. It focuses on the rules of usage and principles of composition most often broken, offering a compact alternative to exhaustive manuals. Master the guidance here, then look to the best authors for finer points of style.

Source: SKILL.md on GitHub

Third-party checks

No alerts16d5 checks · Risk SAFE
  • Gen Agent Trust Hub16d

    The skill is completely safe. It contains documentation and reference materials based on William Strunk Jr.'s 'The Elements of Style' and Wikipedia guidelines to help the AI agent write clearer, more concise prose and avoid generic AI writing patterns.

  • Socket16d

    No alerts

  • Snyk16d

    Risk: LOW · No issues

  • Runlayer7mo

    1/8 files flagged

  • ZeroLeaks5mo

    Score: 93/100 · 2 sections analyzed

Provenance

Signed by skilld at 1c0662a. This ties the file your Agent reads to that commit on GitHub. It does not review the instructions.

Last checked against GitHub 2 months ago.

Dormantupdated 9 months ago

Topics

  • Documentation
  • writing
  • copyediting
  • prose
  • commit-messages
  • error-messages
  • ui-text
  • clarity
  • strunk

README badge

README badge for softaworks/agent-toolkit/writing-clearly-and-concisely

What it does

Applies Strunk's timeless grammar and composition rules to prose written for humans—documentation, commit messages, error messages, UI text. Includes sections on active voice, concrete language, concision, and patterns to avoid in AI-generated writing.

Generated from the current SKILL.md.

Frequently asked

When should I use this skill versus general writing advice?
Use this skill when writing prose for humans to read: documentation, commit messages, error messages, UI copy, reports, or any explanation. It applies Strunk's timeless grammar and composition rules plus patterns to avoid in AI-generated text.
Does this skill help with code comments?
Yes. The skill applies to any prose humans will read, including comments. The rules for active voice, concrete language, and omitting needless words improve technical explanations in code.
What if I have limited context and can't load the entire skill?
Load a single section file instead. The skill provides a limited-context strategy: dispatch a subagent with your draft and the relevant section (e.g., `03-elementary-principles-of-composition.md` for most tasks), which costs ~1,000-4,500 tokens instead of loading everything.
Does this skill catch grammar errors or focus on style?
Both. It covers elementary grammar and punctuation rules (commas, possessives, independent clauses) plus composition principles like active voice, concrete language, and word placement. It also flags AI writing patterns like puffery and empty phrases.

Generated from the current SKILL.md. These answers refresh after source changes.