markdown-rhythm-refiner

Refine Markdown prose rhythm while preserving citations, code blocks, and equations.

Updated Feb 2, 2026
One-click install
npx skills add https://github.com/SALTYf1SH/md-sci-skill --skill markdown-rhythm-refiner
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: markdown-rhythm-refiner
Source: https://github.com/SALTYf1SH/md-sci-skill/tree/main/.claude/skills/markdown-rhythm-refiner
Command: npx skills add https://github.com/SALTYf1SH/md-sci-skill --skill markdown-rhythm-refiner

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Post-process Markdown prose to improve readability through varied sentence and paragraph lengths, removing filler phrases and unnecessary transitions while preserving all citations and semantic meaning.

Core Features & Use Cases

  • Preserve citations and syntax: Every [@key] remains attached to its original claim; equations and images are not altered.
  • Vary rhythm and structure: Mix short, medium, and long sentences; control paragraph length to emphasize key ideas.
  • Remove academic fillers: Eliminate phrases like "in order to" or "due to the fact that" for tighter prose.
  • Tighten prose: Prefer active voice and concise transitions; ensure one idea per paragraph.
  • Use cases: Final polish after drafting chapters or sections, technical docs, or research articles that rely on citations.

Quick Start

Run the Markdown Rhythm Refiner on your drafted Markdown file to tighten rhythm while preserving citations.

Frequently Asked Questions about markdown-rhythm-refiner

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

FAQPage Schema
How do I polish markdown prose rhythm without breaking citation anchors?

To polish markdown prose rhythm without breaking citations, the refiner preserves all [@key] anchors, code blocks, and equations while varying sentence lengths and removing filler phrases. This ensures semantic meaning and citation syntax remain completely intact during the flow improvement process.

What is the best way to remove academic filler phrases from markdown research articles?

The best way to remove academic filler phrases from markdown research articles is to apply automated prose tightening that targets phrases like "in order to" or "due to the fact that," replacing them with concise transitions and active voice to achieve tighter, more readable text.

Can I refine markdown readability while preserving code blocks and equations?

Yes, you can refine markdown readability while preserving code blocks and equations. The refinement process enforces strict constraints to vary paragraph lengths and tighten prose without altering technical syntax, ensuring equations and images remain completely unchanged.

How do I vary sentence and paragraph lengths in drafted markdown chapters?

To vary sentence and paragraph lengths in drafted markdown chapters, the refiner mixes short, medium, and long sentences while controlling paragraph length to emphasize key ideas. It enforces constraints to ensure one idea per paragraph for improved readability.

Does markdown prose polishing work for technical docs with citations?

Markdown prose polishing works effectively for technical docs with citations. It is designed for final polish after drafting chapters, technical documentation, or research articles, tightening rhythm while ensuring every citation remains attached to its original claim.

Why does markdown prose refinement preserve semantic meaning during text polishing?

Markdown prose refinement preserves semantic meaning during text polishing because it enforces constraints to maintain citation anchors and tighten prose without altering the underlying claims. It removes unnecessary transitions while strictly preserving the original semantic intent.