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.

1.10x

Quality

85%

Does it follow best practices?

Impact

98%

1.10x

Average score across 3 eval scenarios

Securityby

Risky

Do not use without reviewing

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%

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%

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%

Repository: ArabelaTso/Skills-4-SE
Commit: 0f00a4f

Evaluated: 29 days ago
Agent: Claude Code
Model: Claude Sonnet 4.6

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.