Agent Md Refactor

What it does

This skill helps AI agents refactor Markdown files, improving structure, formatting, and readability. It can reorganize headers, clean up lists, fix code blocks, and ensure consistent styling across documents.

When to use it

• You need to standardize a large collection of Markdown files for documentation or publishing.
• Your Markdown content has inconsistent formatting that needs correction.
• You want to improve the readability of technical documentation before sharing with others.
• You're preparing Markdown files for version control and want them cleaned up beforehand.

Key capabilities

• Reorganizes headers and subheaders for better hierarchy.
• Cleans up unordered and ordered lists for consistency.
• Fixes formatting issues in code blocks and inline syntax.
• Ensures consistent use of markdown elements like bold, italics, and links.

Example prompts

• "Refactor this Markdown file to improve readability."
• "Clean up the headers and lists in this document."
• "Ensure all code blocks are properly formatted with triple backticks."

Tips & gotchas

• This skill works best on well-formed Markdown files; highly unstructured content may require manual review.
• Always make a backup of your original file before running a refactor to avoid unintended changes.