writing-clearly-and-concisely

Overview

Writing Clearly and Concisely is a skill from softaworks/agent-toolkit that applies Strunk's timeless writing rules alongside AI-specific antipatterns to produce clearer, stronger, more professional prose. It activates whenever the agent writes documentation, commit messages, error messages, explanations, reports, UI text, or any prose intended for human readers.

Key Features

• Strunk's Elements of Style - Implements 18 core rules covering grammar, punctuation, active voice, positive form, concrete language, and omitting needless words for consistently clear writing
• AI Writing Antipatterns - Explicitly identifies and avoids common LLM writing failures including puffery words (pivotal, crucial), empty "-ing" phrases, and generic statistical-mean prose
• Context-Efficient Design - Provides a limited context strategy using subagents with individual reference files (~1,000-4,500 tokens each) instead of loading everything at once
• Comprehensive Reference Library - Includes sectioned reference files for grammar/punctuation, composition principles, formatting matters, and commonly misused words/expressions
• Universal Writing Coverage - Applies to README files, technical docs, commit messages, PR descriptions, error messages, UI copy, help text, comments, reports, and summaries

Who is this for?

This skill is designed for developers and technical writers who want their AI-generated prose to be clear, concise, and professional rather than bloated with LLM-typical filler language. It is ideal for teams that care about documentation quality, commit message clarity, and overall communication professionalism in their codebases.