check-markdown-style

Detect Markdown style violations and generate a remediation report.

16|8|Updated Apr 15, 2026
One-click install
npx skills add https://github.com/GliteTech/glite-arf --skill check-markdown-style
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: check-markdown-style
Source: https://github.com/GliteTech/glite-arf/tree/main/arf/skills/check-markdown-style
Command: npx skills add https://github.com/GliteTech/glite-arf --skill check-markdown-style

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Markdown style violations slip through reviews and degrade readability. This Skill detects deviations from the project's Markdown style guide and generates an actionable report.

Core Features & Use Cases

  • Line length and wrapping: enforces Flowmark-aligned wrapping and 100-character line limits with allowed exceptions.
  • Structural correctness: validates heading hierarchy, blank lines around blocks, and proper list formatting.
  • Reporting: outputs a clear list of violations with locations and suggested fixes for immediate remediation.

Quick Start

Run the skill on a markdown file to get a violation report and remediation guidance.

Frequently Asked Questions about check-markdown-style

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

FAQPage Schema
How do I check my markdown formatting for style violations?

To check markdown formatting, the Skill applies a project's markdown style guide to target files, identifying deviations like improper heading hierarchy, trailing whitespace, and list formatting errors. It then outputs a clear report with violation locations and suggested fixes for immediate remediation.

What is a markdown style guide and how does it enforce line length?

A markdown style guide defines documentation formatting rules for consistency. This Skill enforces line length by applying Flowmark-aligned wrapping and a 100-character limit, while allowing specific exceptions, ensuring clean and readable documentation across README files and inline repository docs.

How do I fix heading hierarchy and blank line issues in markdown docs?

To fix heading hierarchy and blank line issues, run the Skill on your markdown file to validate structural correctness. It detects missing blank lines around blocks and improper heading levels, generating an actionable report with locations and suggested fixes to correct the formatting.

Can I lint markdown table formatting and code blocks in README files?

Yes, you can lint markdown table formatting and code blocks in README files. The Skill validates structural correctness across typical documentation tasks, detecting deviations from the style guide and providing remediation guidance to ensure clean, consistent documentation.

Why does my markdown documentation fail quality reviews?

Markdown documentation often fails quality reviews because style violations slip through and degrade readability. This Skill detects deviations from the project's style guide, such as trailing whitespace and list formatting errors, generating an actionable violation report for immediate remediation.

What is the best way to enforce markdown lint rules across a repository?

The best way to enforce markdown lint rules is to apply a markdown style guide to target files within the repository. This Skill identifies violations across line-length, heading hierarchy, and table formatting, outputting an actionable list of deviations with suggested fixes for clean documentation.