markdown-document-structurer

Reorganizes markdown documents into well-structured, consistent format while preserving content and improving readability. Use when Claude needs to: (1) Fix heading hierarchy issues (skipped levels, multiple h1s), (2) Generate or update table of contents, (3) Standardize formatting (lists, code blocks, emphasis, links), (4) Improve grammar and spelling, (5) Add missing standard sections (installation, usage, etc.), (6) Remove redundant or duplicate content, (7) Restructure technical docs, READMEs, or long-form content for better organization and flow.

Install with Tessl CLI

npx tessl i github:ArabelaTso/Skills-4-SE --skill markdown-document-structurer

What are skills?

Review — 85%

Does it follow best practices?

If you maintain this skill, you can automatically optimize it using the tessl CLI to improve its score:

npx tessl skill review --optimize ./path/to/skill

Learn more

Validation — 11 / 11 Passed

Validation for skill structure

SKILL.md

Review

Evals

Evaluation results

98%

-2%

Tidy Up the DataFlow Library README

README formatting standardization

Criteria

Without context

With context

Single h1 heading

100%

No skipped heading levels

100%

TOC added

100%

TOC placement

100%

TOC anchor format

100%

Dash list markers

100%

Code block languages

100%

Bold style consistency

100%

Italic style consistency

100%

Installation section

100%

Usage section

100%

71%

License section

100%

Change summary provided

100%

Without context: $0.2986 · 1m 26s · 18 turns · 25 in / 4,168 out tokens

With context: $0.7406 · 3m 59s · 23 turns · 3,371 in / 11,651 out tokens

100%

17%

Overhaul the CloudSync API Documentation

Duplicate section consolidation and content preservation

Criteria

Without context

With context

Duplicates merged

100%

Most complete version kept

100%

Code examples preserved

100%

Links preserved

100%

Prerequisites section added

100%

TOC added

100%

TOC uses dash markers

100%

Code blocks have languages

71%

100%

Dash list markers

100%

Single h1

100%

Change summary provided

100%

Notes about changes

100%

Without context: $0.2282 · 1m 5s · 12 turns · 19 in / 3,508 out tokens

With context: $0.7357 · 3m 38s · 26 turns · 1,608 in / 9,121 out tokens

96%

12%

Fix the Docker Deployment Tutorial

Tutorial restructuring with analysis script

Criteria

Without context

With context

Analysis script used

100%

Heading hierarchy fixed

100%

Single h1

100%

Prerequisites section

100%

Step-by-step structure

37%

50%

Verification section

100%

Next Steps section

42%

100%

TOC added

100%

Italic style uses asterisk

100%

Bold style uses asterisk

100%

Dash list markers

100%

Change summary provided

100%

Without context: $0.6088 · 3m 20s · 26 turns · 30 in / 9,803 out tokens

With context: $0.6219 · 2m 24s · 25 turns · 28 in / 6,599 out tokens

Evaluated: about 18 hours ago
Agent: Claude Code

Table of Contents

Tidy Up the DataFlow Library README Overhaul the CloudSync API Documentation Fix the Docker Deployment Tutorial

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.