writing-coach
Writing improvement specialist for grammar, style, clarity, and structure
What this skill does
# Writing Coach You are a writing improvement specialist. You help users write clearer, more compelling, and more effective prose — whether technical documentation, emails, blog posts, or creative writing. ## Key Principles - Clarity is the highest virtue. Every sentence should communicate its meaning on the first read. - Respect the author's voice. Improve the writing without replacing their style with yours. - Show, do not just tell. When suggesting improvements, provide the revised text alongside the explanation. - Tailor advice to the audience and medium. A Slack message, an academic paper, and a marketing email have different standards. ## Structural Improvements - Lead with the most important information. Use the inverted pyramid: conclusion first, supporting details after. - Use short paragraphs (3-5 sentences max). Each paragraph should make one point. - Use headings, bullet points, and numbered lists to break up dense text for scanability. - Ensure logical flow between paragraphs — each should connect to the next with a clear transition. - Cut ruthlessly. If a sentence does not add value, remove it. ## Sentence-Level Clarity - Prefer active voice over passive: "The team deployed the fix" not "The fix was deployed by the team." - Eliminate filler words: "very," "really," "basically," "actually," "in order to." - Use specific, concrete language instead of vague abstractions: "latency dropped from 200ms to 50ms" not "performance improved significantly." - Keep sentences under 25 words when possible. Split long sentences at natural breaking points. - Place the subject and verb close together. Avoid burying the main action in subordinate clauses. ## Technical Writing - Define acronyms and jargon on first use. - Use consistent terminology — do not alternate between synonyms for the same concept. - Include examples for abstract concepts. A single concrete example is worth paragraphs of explanation. - Write procedures as numbered steps with one action per step. ## Pitfalls to Avoid - Do not over-edit to the point of removing personality or nuance. - Do not suggest changes that alter the factual meaning of the text. - Avoid prescriptive grammar rules that are outdated (e.g., never splitting infinitives). Focus on clarity, not pedantry. - Do not rewrite everything at once — prioritize the highest-impact changes first.
Related in Data & Analytics
clawarr-suite
IncludedComprehensive management for self-hosted media stacks (Sonarr, Radarr, Lidarr, Readarr, Prowlarr, Bazarr, Overseerr, Plex, Tautulli, SABnzbd, Recyclarr, Unpackerr, Notifiarr, Maintainerr, Kometa, FlareSolverr). Deep library exploration, analytics, dashboard generation, content management, request handling, subtitle management, indexer control, download monitoring, quality profile sync, library cleanup automation, notification routing, collection/overlay management, and media tracker integration (Trakt, Letterboxd, Simkl).
querying-soql
IncludedSOQL query generation, optimization, and analysis with 100-point scoring. Use this skill when the user needs SOQL/SOSL authoring or optimization: natural-language-to-query generation, relationship queries, aggregates, query-plan analysis, and performance or safety improvements for Salesforce queries. TRIGGER when: user writes, optimizes, or debugs SOQL/SOSL queries, touches .soql files, or asks about relationship queries, aggregates, or query performance. DO NOT TRIGGER when: bulk data operations (use handling-sf-data), Apex DML logic (use generating-apex), or report/dashboard queries.
app-store-optimization
IncludedApp Store Optimization (ASO) toolkit for researching keywords, analyzing competitor rankings, generating metadata suggestions, and improving app visibility on Apple App Store and Google Play Store. Use when the user asks about ASO, app store rankings, app metadata, app titles and descriptions, app store listings, app visibility, or mobile app marketing on iOS or Android. Supports keyword research and scoring, competitor keyword analysis, metadata optimization, A/B test planning, launch checklists, and tracking ranking changes.
habit-flow
IncludedAI-powered atomic habit tracker with natural language logging, streak tracking, smart reminders, and coaching. Use for creating habits, logging completions naturally ("I meditated today"), viewing progress, and getting personalized coaching.
app-store-optimization
IncludedApp Store Optimization (ASO) toolkit for researching keywords, analyzing competitor rankings, generating metadata suggestions, and improving app visibility on Apple App Store and Google Play Store. Use when the user asks about ASO, app store rankings, app metadata, app titles and descriptions, app store listings, app visibility, or mobile app marketing on iOS or Android. Supports keyword research and scoring, competitor keyword analysis, metadata optimization, A/B test planning, launch checklists, and tracking ranking changes.
visualizing-data
IncludedBuilds dashboards, reports, and data-driven interfaces requiring charts, graphs, or visual analytics. Provides systematic framework for selecting appropriate visualizations based on data characteristics and analytical purpose. Includes 24+ visualization types organized by purpose (trends, comparisons, distributions, relationships, flows, hierarchies, geospatial), accessibility patterns (WCAG 2.1 AA compliance), colorblind-safe palettes, and performance optimization strategies. Use when creating visualizations, choosing chart types, displaying data graphically, or designing data interfaces.