markdown-mode-router

Route markdown writing tasks to teaching or general formatting modes.

1|Updated Apr 9, 2026
One-click install
npx skills add https://github.com/droxey/skills --skill markdown-mode-router
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: markdown-mode-router
Source: https://github.com/droxey/skills/tree/main/markdown-mode-router
Command: npx skills add https://github.com/droxey/skills --skill markdown-mode-router

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Prevents markdown files from being reformatted with the wrong course vs non-course structure, reducing formatting drift and broken section contracts.

Core Features & Use Cases

  • Teaching vs general routing: Selects teaching when the repo name starts with ACS or the file appears to be a lesson artifact (plan, lab, tip, assignment, slides, speaker notes, quiz); otherwise selects general.
  • Minimum-necessary structural normalization: Applies the lightest correct structure while preserving stable headings and existing meaning/order.
  • Conditional TOC insertion: Adds a TOC only when the file has exactly one H2 and at least two H3 headings, with the specified linking rules.

Quick Start

Use markdown-mode-router to rewrite your markdown file with the minimum necessary changes while keeping it in the correct teaching or general formatting mode.

Frequently Asked Questions about markdown-mode-router

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

FAQPage Schema
How do I normalize markdown formatting without breaking heading structure?

Markdown normalization applies minimum-necessary structural changes while preserving stable headings and existing meaning or order. This prevents formatting drift and keeps section contracts intact during document normalization rewrites.

When should I generate a table of contents in my markdown files?

Generate a table of contents in markdown files only when the document has exactly one H2 heading and at least two H3 headings. This conditional TOC insertion ensures linking rules apply correctly without cluttering simpler documents.

How do I format course lesson artifacts differently from general markdown notes?

Formatting course lesson artifacts differently from general notes requires routing markdown to teaching or general strategies based on repo identity. Teaching mode applies when repo names start with ACS or files are lesson plans, labs, or quizzes.

Does this markdown router work with non-course documentation?

Yes, this markdown router works with non-course documentation by selecting general formatting mode. When the repo name does not start with ACS and the file is not a lesson artifact, it applies general formatting strategies with light structural normalization.

What is the best way to prevent formatting drift in markdown repositories?

Preventing formatting drift in markdown repositories requires deterministic routing that applies the lightest correct structure based on repo identity and file purpose. This stops files from being reformatted with the wrong course versus non-course structure.