ReddRadar
Agent skill
clear-writing
Use when writing or editing any prose humans will read — documentation, commit messages, error messages, UI text, reports, or explanations. Also use when user says "write clearly", "clear writing", or "improve writing".
Install this agent skill to your Project
npx add-skill https://github.com/l-lin/dotfiles/tree/main/home-manager/modules/share/ai/.config/ai/skills/clear-writing
SKILL.md
Writing Clearly and Concisely
Overview
Apply William Strunk Jr.'s The Elements of Style: write clearly, cut ruthlessly, say exactly what you mean.
Rules
Elementary Rules of Usage (Grammar/Punctuation)
- Form possessive singular by adding 's
- Use comma after each term in series except last
- Enclose parenthetic expressions between commas
- Comma before conjunction introducing co-ordinate clause
- Don't join independent clauses by comma
- Don't break sentences in two
- Participial phrase at beginning refers to grammatical subject
Elementary Principles of Composition
- One paragraph per topic
- Begin paragraph with topic sentence
- Use active voice
- Put statements in positive form
- Use definite, specific, concrete language
- Omit needless words
- Avoid succession of loose sentences
- Express co-ordinate ideas in similar form
- Keep related words together
- Keep to one tense in summaries
- Place emphatic words at end of sentence
Custom rules
- Preserve every idea and fact unless clarity demands a change
- Keep paragraphs short (no more than three brief sentences)
- Vary sentence length to avoid monotony
- Replace jargon and complex words with plain, direct language; use contractions
- Remove clichés, filler adverbs, and stock metaphors (e.g., "navigate," "journey," "roadmap")
- Avoid bullet points unless essential for scan-ability
- Never add a summary or recap at the end—finish on a crisp, final line
- Do not use em dashes; use commas, periods, or rewrite as needed
- Add dry humor or an idiom if it fits, but never sound like an infomercial
- After rewriting, review and fix any sentence that still feels machine-made
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
l-lin/dotfiles
napkin
Maintain a per-repo napkin as a continuously curated runbook (not a session log). Activates EVERY session. Read and curate it before work, keep only recurring high-value guidance, organize by priority-sorted categories, and cap each category at top 10 items..
l-lin/dotfiles
datadog-pup
Use when interacting with Datadog resources using the `pup` CLI, especially for APM traces, metrics, monitors, notebooks, and synthetic tests.
l-lin/dotfiles
tmux
Use when you need a persistent terminal environment for long-running processes, programs requiring a TTY, REPLs, debuggers, TUI apps, or concurrent terminals — while the agent continues executing other commands.
l-lin/dotfiles
writing-skill
Use when creating new skills, editing existing skills, or verifying skills work before deployment
l-lin/dotfiles
clarifying-intent
Use when user asks to create, build, design, add, or generate something — especially when the request is vague, underspecified, or the scope is unclear. Use before starting creative work, features, components, or any new functionality.
l-lin/dotfiles
code-simplifier
Simplifies and refines code for clarity, consistency, and maintainability while preserving all functionality. Use when asked to "simplify code", "clean up code", "refactor for clarity", "improve readability", or review recently modified code for elegance. Focuses on project-specific best practices.
Didn't find tool you were looking for?