write-well

Analyzes Quarto .qmd manuscripts and outputs a sectioned Markdown report.

14|2|Updated Feb 26, 2026
One-click install
npx skills add https://github.com/christopherkenny/skills --skill write-well
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: write-well
Source: https://github.com/christopherkenny/skills/tree/main/skills/write-well
Command: npx skills add https://github.com/christopherkenny/skills --skill write-well

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Prose quality checker for Quarto (.qmd) files, grounded in William Zinsser's On Writing Well, helping editors and researchers tighten writing, remove clutter, and improve clarity without altering the source document.

Core Features & Use Cases

  • Detect clutter, hollow qualifiers, weak verbs, and clichés to improve precision and readability.
  • Enforce unity, structure, and clear argument flow across sections; suitable for manuscript sections, figures captions, and method descriptions.
  • Generate a structured markdown report that accompanies the original file and can be shared with collaborators or reviewers.

Quick Start

Run the write-well skill on a .qmd file to generate a prose-quality report without changing the original document.

Frequently Asked Questions about write-well

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I check prose quality in a Quarto manuscript?

Checking prose quality in a Quarto manuscript involves analyzing the .qmd file to detect clutter, weak verbs, and hedging, producing a structured markdown report without modifying the original source document.

What is clutter and hedging in academic writing?

Clutter and hedging in academic writing are unnecessary words and hollow qualifiers that reduce precision. Detecting these issues helps tighten prose, enforce structural unity, and improve overall sentence rhythm and clarity.

Can I limit prose checks to a specific section of a .qmd file?

Yes, you can limit prose checks to a specific section of a .qmd file by providing an optional @sec-label. This restricts the analysis to that section and outputs a targeted markdown report.

Does the prose quality checker edit my Quarto source file?

No, the prose quality checker never modifies your Quarto source file. It analyzes the .qmd manuscript and produces a separate, section-organized markdown report to guide your manual edits.

What is the best way to improve sentence rhythm in academic reports?

The best way to improve sentence rhythm in academic reports is applying Zinsser-inspired checks to flag weak verbs and clichés. This generates a report highlighting areas to tighten writing and increase precision.