writing-prose_skill

Overview

This skill enforces a concise, readable approach for any prose writing or editing task. It focuses on direct phrasing, active voice, and avoiding predictable or formulaic patterns to keep readers engaged.

How this skill works

Apply the rules when generating or revising prose. After drafting, run the text through the dedicated prose editor subagent for a scored review and follow its feedback until the work meets the required quality threshold.

When to use it

• Drafting articles, essays, stories, or blog posts
• Editing or polishing existing prose for clarity and flow
• Rewriting text to remove clichés, filler, and passive constructions
• Preparing copy that must engage readers quickly and directly
• Never use for agent context files, tool descriptions, READMEs, or other functional documentation

Best practices

• Write directly: prefer active voice and specific verbs over stacked adjectives
• Avoid formulaic openings, binary contrasts, and predictable dramatic beats
• Run every draft through the prose editor subagent and act on its feedback
• Do not self-score; iterate until the editor gives a passing score (≥ 32/40)
• Keep revisions focused on the exact issues the editor identifies

Example use cases

• Polishing a blog post to improve reader engagement and reduce fluff
• Rewriting a short story opening to create clearer momentum
• Editing a product narrative to remove jargon and boost clarity
• Refining marketing copy to be punchier and avoid cliches