cyberneticlibrary

Rewrite article sections for clarity

edit-articleskillsetup L184,074
mattpocock/skills
What it does

Rewrite article sections for clarity and conciseness

Best for

Writers and editors who want rapid paragraph-level clarity improvements while preserving the article structure and information flow.

Inputs
  • · Article text (divided into sections by headings)
  • · User confirmation of sections
Outputs
  • · Rewritten sections (each paragraph max 240 characters)
  • · Improved clarity and coherence
  • · Improved flow within and between sections
Preconditions
  • · Article has clear heading structure (H2/H3 hierarchy)
  • · User has approved section divisions before rewriting
  • · Information dependencies are identified (DAG model)
Failure modes
  • · Loses nuance by enforcing 240-character limit per paragraph
  • · Oversimplifies complex technical arguments
  • · Section approval step may be slow (requires user interaction)
  • · Cannot add information if section division already decided
Trust signals
  • · Respects information dependencies (no circular dependencies in DAG model)
  • · Explicit confirmation step (user approves section divisions before rewriting)
  • · Uniform constraint (max 240 characters per paragraph across all sections)
  • · Flow improvement explicit in goal (not just clarity)