🎁 Get the FREE AI Skills Starter GuideSubscribe →
BytesAgainBytesAgain
🦀 ClawHub

Prose Clarity Reviser

by @quochungto

Revise dense, unclear prose into clear, readable sentences by applying four diagnostic principles — characters-as-subjects, actions-as-verbs, old-before-new...

Versionv1.0.0
When to Use
TriggerAction
- User pastes a paragraph and says "this is confusing" or "make this clearer"
- User shares a draft section and asks for a style pass or readability revision
- A supervisor, editor, or reviewer has flagged the writing as dense, abstract, or hard to follow
- The user says their writing sounds too "academic," too stiff, or too indirect
- The user asks why their sentences don't "flow" or why readers keep re-reading them
**Do not apply these principles as the user writes new text.** These are revision tools — apply them only after a draft exists. Applying them during drafting causes paralysis.
**Scope:** This skill handles sentence-level and paragraph-level style revision only. It does not restructure arguments, reorganize sections, or evaluate evidence. For those concerns, use a different skill.
💡 Examples

Example 1: Heavy Nominalization + Abstract Subject

Before: > The standardization of indices for the measurement of mood disorders has now made possible the quantification of patient response as a function of treatment differences.

After: > Having standardized indices for measuring mood disorders, we now can quantify patients' responses to different treatments.

Annotations:

  • [P2] *standardization* → *standardized*, *measurement* → *measuring*, *quantification* → *quantify*, *response* → *responses*
  • [P1] Subject changed from the abstract nominalized phrase to *we*
  • [P2] Vague verb *made possible* replaced by specific verb *can quantify*

  • Example 2: Information Flow Broken Across Sentences

    Before: > Locke frequently repeated himself because he did not trust the power of words to name things accurately. Seventeenth-century theories of language, especially Wilkins's scheme for a universal language involving the creation of countless symbols for countless meanings, had centered on this naming power. A new era in the study of language that focused on the ambiguous relationship between sense and reference begins with Locke's distrust.

    After: > Locke often repeated himself because he distrusted the naming power of words. This naming power had been central to seventeenth-century theories of language, especially Wilkins's scheme for a universal language involving the creation of countless symbols for countless meanings. Locke's distrust begins a new era in the study of language, one that focused on the ambiguous relationship between sense and reference.

    Annotations:

  • [P3] Sentence 2 rewritten to open with *This naming power* — picks up the phrase from sentence 1's end
  • [P3] Sentence 3 rewritten to open with *Locke's distrust* — picks up the concept from sentence 2's end
  • [P2] *distrust of* → *distrusted* (minor nominalization)
  • [P4] New technical concept (*ambiguous relationship between sense and reference*) moved to sentence 3's end

  • Example 3: Complexity at the Front, Technical Term Placement

    Before: > The monoamine hypothesis has been the leading biological account of depression for over three decades.

    After: > For over three decades, the leading biological account of depression has been the monoamine hypothesis.

    Annotation:

  • [P4] Technical term *monoamine hypothesis* moved to sentence end, where new technical terms belong when first introduced. The familiar framing (*for over three decades*) now anchors the sentence's opening.

  • View on ClawHub
    TERMINAL
    clawhub install bookforge-prose-clarity-reviser

    🧪 Use this skill with your agent

    Most visitors already have an agent. Pick your environment, install or copy the workflow, then run the smoke-test prompt above.

    🔍 Can't find the right skill?

    Search 60,000+ AI agent skills — free, no login needed.

    Search Skills →