sembr-reformat

Reformat prose into Semantic Line Breaks while preserving rendered output and meaning.

5.5k|746|Updated Jan 24, 2020
One-click install
npx skills add https://github.com/grafana/tempo --skill sembr-reformat
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: sembr-reformat
Source: https://github.com/grafana/tempo/tree/main/.claude/skills/sembr-reformat
Command: npx skills add https://github.com/grafana/tempo --skill sembr-reformat

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Long prose paragraphs in Markdown, AsciiDoc, LaTeX, and similar formats produce noisy diffs and poor editorial readability when wrapped arbitrarily. This Skill reflows text using the Semantic Line Breaks (SemBr) specification so each line carries one thought, making version control diffs and reviews cleaner without changing what readers see.

Core Features & Use Cases

  • SemBr Rule Application: Breaks lines after sentences, clauses, and before lists according to the sembr.org specification, targeting 80 columns.
  • Rendering-Safe Rewriting: Skips code blocks, tables, YAML frontmatter, and URLs so only line wrapping changes, never content or structure.
  • Quality Verification: Checks rendering-equivalence, meaning-equivalence, and structure-equivalence before returning output.
  • Use Case: A documentation maintainer pastes a long Markdown paragraph and receives it back with one sentence per line, producing minimal, reviewable diffs in future edits.

Quick Start

Reformat the following Markdown paragraph using Semantic Line Breaks while preserving its meaning and rendered output.

Frequently Asked Questions about sembr-reformat

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

FAQPage Schema
How do I reformat Markdown with Semantic Line Breaks?

Provide the prose and ask for SemBr reformatting. The text is rewritten so each sentence starts on a new line, with optional breaks after clauses, while wording, punctuation, and rendered output stay identical.

What is Semantic Line Breaks formatting used for?

Semantic Line Breaks place one thought per line so version control diffs show only changed sentences instead of entire rewrapped paragraphs. It improves editorial readability and code review of documentation without altering rendered output.

Does SemBr reformatting work with LaTeX and AsciiDoc files?

Yes, the reformatting supports Markdown, AsciiDoc, reStructuredText, LaTeX, Org, and MediaWiki. Regions where line breaks are syntactically significant, such as code blocks and tables, are left unchanged.

Will reformatting prose change how my document renders?

No, only line wrapping is rewritten. The process verifies rendering-equivalence, meaning-equivalence, and structure-equivalence, so headings, lists, punctuation, and block boundaries remain unchanged.

When should Semantic Line Breaks not be applied?

Avoid applying it inside fenced or indented code blocks, tables, YAML frontmatter, and URLs or markup tokens that must stay contiguous. These regions are skipped automatically, and unsafe segments are left unchanged with a note.