{"enrichment":{"faq":[{"a":"writing-clearly-and-concisely teaches you to strip away excess and prioritize force over length. Start by identifying your core message, then apply Strunk's rules: use active voice, omit needless words, and replace vague phrases with concrete language. Load the relevant reference section for your documentation type\u2014whether README, API docs, or guides\u2014and revise ruthlessly to remove jargon, redundancy, and filler that obscures meaning.","q":"How to write clear concise documentation with writing-clearly-and-concisely?"},{"a":"writing-clearly-and-concisely applies William Strunk Jr.'s timeless principles: use active voice instead of passive constructions, choose specific words over generic ones, omit needless words without sacrificing meaning, and structure sentences for clarity. The skill also covers punctuation discipline and paragraph organization to ensure your prose flows logically and every sentence earns its place on the page.","q":"What grammar and composition rules does this skill teach?"},{"a":"writing-clearly-and-concisely identifies common AI traps: empty marketing language, overused adjectives, vague hedging phrases, and repetitive vocabulary. The skill teaches you to recognize these patterns and replace them with direct, honest language grounded in specifics. Strip superlatives, eliminate filler like 'truly' or 'actually,' and let your actual content speak instead of relying on inflated phrasing.","q":"How do I avoid AI writing patterns and puffery in my prose?"},{"a":"Yes. writing-clearly-and-concisely covers writing effective commit messages by applying the same clarity principles: use imperative mood ('Add feature' not 'Added feature'), omit needless context, and lead with the change's purpose. The skill teaches you to write error messages and UI copy with the same discipline\u2014every word must serve the reader's understanding, not pad the message.","q":"Can writing-clearly-and-concisely help me write better commit messages?"},{"a":"writing-clearly-and-concisely teaches active voice as the default: 'The function returns a value' instead of 'A value is returned by the function.' Structure paragraphs around one main idea, place the topic sentence first, and support it with concrete examples. Remove passive constructions that hide the actor, and choose specific verbs that show exactly what happens rather than generic ones that obscure action.","q":"How should I structure paragraphs and use active voice effectively?"},{"a":"writing-clearly-and-concisely combines Strunk's proven grammar and composition rules with practical defense against modern AI writing patterns. It's built for technical and professional contexts\u2014documentation, commit messages, error messages, UI copy\u2014where clarity directly impacts usability. The skill teaches you to edit ruthlessly, eliminate jargon, and write with force by removing everything that doesn't serve your reader's understanding.","q":"What makes writing-clearly-and-concisely different from other writing guides?"}],"shadow_tags":["prose-editing","strunk-rules","active-voice","anti-puffery","technical-writing","clarity-first","concision","ai-detection","style-guide"],"summary_rewrite":"This skill teaches you to write with clarity and force by applying William Strunk Jr.'s timeless rules for grammar, composition, and word choice. It covers active voice, concrete language, omitting needless words, and identifies common AI writing patterns to avoid\u2014puffery, empty phrases, and overused vocabulary. Load the relevant reference section for your task and apply the rules directly to documentation, commit messages, error messages, or any prose meant for human readers."},"files":[{"bytes":3768,"path":"skills/writing-clearly-and-concisely/SKILL.md","sha256":"c5f4ecc8bfa7984d0df70d30cea3bfeb824f7b24d31db111d5a1a9a959880575","url":"https://skillfed.io/files/softaworks/agent-toolkit/writing-clearly-and-concisely/7ccf6114/SKILL.md"}],"id":"softaworks/agent-toolkit/writing-clearly-and-concisely","links":{"html":"https://skillfed.io/softaworks/agent-toolkit/writing-clearly-and-concisely","md":"https://skillfed.io/softaworks/agent-toolkit/writing-clearly-and-concisely.md","repo":"https://github.com/softaworks/agent-toolkit"},"meta":{"agents_supported":[],"first_seen":"2026-07-28","forks":214,"language":"Python","last_updated":"2026-03-05","license":"MIT","name":"writing-clearly-and-concisely","publisher":"softaworks","stars":2243},"relations":{"similar":[{"id":"jjmartres/opencode/writing-clearly-and-concisely"},{"id":"pedronauck/skills/writing-clearly-and-concisely"},{"id":"obra/the-elements-of-style/writing-clearly-and-concisely"},{"id":"neurofoo/agent-skills/eos-composition"},{"id":"neurofoo/agent-skills/eos-usage"},{"id":"NeoLabHQ/context-engineering-kit/write-concisely"},{"id":"ratacat/claude-skills/writing-documentation"},{"id":"softaworks/agent-toolkit/web-to-markdown"},{"id":"softaworks/agent-toolkit/react-useeffect"},{"id":"softaworks/agent-toolkit/crafting-effective-readmes"}]},"slug":{"owner":"softaworks","repo":"agent-toolkit","skill":"writing-clearly-and-concisely"},"version":"7ccf6114"}