Back to Writing
PLAYBOOKai-skillmarkdowncursorclaude-codedocument-editingopen-source

MaraudersMapMD Skill — Teach Your AI to Rewrite Documents Like an Editor

February 17, 2026•Updated Feb 17, 2026

You know that moment when you ask your AI assistant to "improve this document" and it just... shuffles some words around? Maybe adds a header here, reformats a list there, but doesn't really transform the readability?

The MaraudersMapMD Skill fixes that by giving your AI a proper editorial procedure to follow.

What Is It?

It's an AI agent skill — a set of structured instructions that your AI assistant loads and follows when you ask it to improve a document's readability. Instead of generic rewriting, the AI executes a 5-phase editorial procedure:

  1. Baseline Capture: Snapshot the original document state
  2. Working Copy: Create a safe working copy to iterate on
  3. Skeleton: Extract the document's structural outline
  4. Section Rewrite: Rewrite each section for clarity, following strict formatting rules
  5. Verification & Cleanup: Run a checklist to confirm everything is correct

This isn't a vague "make it better" prompt. It's a deterministic pipeline that produces consistent, high-quality results every time.

Sharded Markdown Architecture

The skill works with MaraudersMapMD's artifact system. When your AI processes a document, it generates and manages:

  • Section Pack: Individual markdown files split by heading
  • Search Index: index.json with keywords and AI Hint Blocks
  • AI Map: Full document structure and section summaries
  • Rewritten Document: The final output in .rewritten.md format

One critical rule: if the rewritten document changes, all shards and the index are regenerated immediately to stay in sync.

Installation

The quickest way is to paste the automated setup prompt into Cursor's chat. The AI handles the rest.

Or via command line:

For Cursor:

mkdir -p .cursor/rules && curl -fsSL https://raw.githubusercontent.com/mandarange/MaraudersMapMD-skill/main/SKILL.md -o .cursor/rules/maraudersmapmd-skill.mdc

For Claude Code:

mkdir -p .claude/skills && curl -fsSL https://raw.githubusercontent.com/mandarange/MaraudersMapMD-skill/main/SKILL.md -o .claude/skills/maraudersmapmd-skill.md

What's New (v9.0.0 — Feb 2026)

Recent updates have been focused on robustness and visual content handling:

  • HTML Screenshot Rendering: Replaced Mermaid diagram conversions with direct HTML screenshot rendering for deterministic results
  • Parallel Execution: New rules to optimize document processing across multiple sections
  • ASCII-to-Mermaid Conversion: Automatic detection and conversion of ASCII art diagrams
  • Artifact Hygiene: Strict temp file cleanup and duplicate shard prevention
  • Repository Safety: New guardrails to prevent accidental modification of source files

Why Give It a Try?

If you're writing documentation, READMEs, technical specs, or any long-form Markdown content, this skill turns your AI assistant into a proper editor. Not the kind that suggests "consider rephrasing this sentence" — the kind that restructures your document for maximum clarity while preserving every detail.

The difference is immediately noticeable. Your first rewrite will show you what your AI was always capable of — it just needed the right instructions.

MIT-licensed. Open source. One command to install.

GitHub Repository