One-click install
npx skills add https://github.com/46ki75/skills --skill markdown-46ki75
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: markdown
Source: https://github.com/46ki75/skills/tree/main/public/markdown
Command: npx skills add https://github.com/46ki75/skills --skill markdown-46ki75

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Markdown documents often suffer from inconsistent formatting, style violations, and structural errors, leading to poor readability and extra manual review time. This Skill automates the detection and correction of these issues, ensuring your markdown is always clean, consistent, and professional.

Core Features & Use Cases

  • Automated Linting & Fixing: Automatically identifies and corrects common markdown style issues using markdownlint-cli2.
  • Structural Issue Guidance: Provides clear instructions and examples for manually fixing complex structural problems like multiple H1 headers or emphasis used as headings.
  • Customizable Rules: Easily adapt to specific project style guides by configuring rules in a .markdownlint.json file.
  • Use Case: Before publishing a blog post or updating project documentation, use this Skill to automatically clean up formatting and ensure it adheres to best practices, saving you from tedious manual proofreading.

Quick Start

Please lint and auto-fix the attached 'my_document.md' file. After the auto-fix, report any remaining issues and suggest how I can manually resolve them.

Frequently Asked Questions about markdown

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

FAQPage Schema
How do I automatically fix markdown formatting issues in my documentation?

Markdown linting automatically detects and corrects formatting and style violations using markdownlint-cli2. Run the Skill with the --fix flag on your .md files to resolve common issues like inconsistent spacing, heading structure, and emphasis formatting, then review any remaining structural problems that require manual fixes.

Can I apply markdown linting to multiple files across directories at once?

Yes, markdown linting processes single files or batches of .md files across directories in one workflow. The Skill scans your entire directory structure, auto-fixes compatible issues, and generates before/after summaries so you can verify changes across all documents.

What markdown style issues can be automatically fixed versus manually fixed?

Auto-fix resolves formatting violations like line breaks, list indentation, and code block markers. Structural issues—multiple H1 headers, emphasis misused as headings, or custom style violations—require manual correction. The Skill provides clear guidance and examples for each.

How do I customize markdown linting rules for my project's style guide?

Configure rules by creating a .markdownlint.json file in your project. This lets you enable, disable, or adjust linting rules to match your specific documentation standards, then the Skill applies your custom configuration when running auto-fix and validation checks.

Does markdown linting help enforce consistency before publishing documentation?

Yes, markdown linting ensures your documents meet formatting and structural best practices before publication. Run it on blog posts or project documentation to catch style inconsistencies, eliminate manual proofreading, and guarantee professional, readable output across all .md files.

What happens if markdown linting can't auto-fix an issue?

The Skill reports remaining issues after auto-fix and provides specific instructions for manual resolution. It identifies the problem type, shows examples, and explains the fix so you can resolve complex structural errors without guessing.