Check Code Block Highlights

What problem does it solve?

This Skill helps authors and reviewers ensure that hl_lines attributes in Markdown code blocks correctly highlight intended lines, preventing misinterpretation of examples in documentation.

Core Features & Use Cases

• Validate snippet-relative highlighting: hl_lines values are checked against the actual lines in the code block.
• Detect off-by-one errors, including blank lines, and ensure headers or comments are not incorrectly highlighted.
• Generate a concise report with suggested fixes for code blocks in Markdown documentation and tutorials.

Quick Start

Run the check-highlights skill on a sample.md file to verify all hl_lines highlight the intended snippet lines.