lint-markdown

Lint Markdown files against taxonomy-based governance and writing standards.

10|Updated Oct 18, 2025
One-click install
npx skills add https://github.com/CsHeng/dot-claude --skill lint-markdown
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: lint-markdown
Source: https://github.com/CsHeng/dot-claude/tree/main/skills/lint-markdown
Command: npx skills add https://github.com/CsHeng/dot-claude --skill lint-markdown

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill executes Markdown validation with taxonomy-based classification and custom rules to ensure content aligns with governance and writing standards.

Core Features & Use Cases

  • Taxonomy-Based Validation: Classify files as STRICT, MODERATE, or LIGHT and apply appropriate checks.
  • Structured Reporting: Produce lint reports with issues, severities, and suggested fixes.
  • Automation Readiness: Integrate with CI to enforce Markdown quality across projects.

Quick Start

Run lint-markdown on a Markdown file or directory to generate a validation report and recommended fixes.

Frequently Asked Questions about lint-markdown

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

FAQPage Schema
How do I validate Markdown files against governance rules?

Markdown validation enforces taxonomy-based writing standards by classifying files as STRICT, MODERATE, or LIGHT and applying custom governance rules. Run lint-markdown on your Markdown files to generate structured reports with issues, severities, and suggested fixes.

Can I automate Markdown linting in CI/CD pipelines?

Yes. Lint-markdown integrates with CI to enforce Markdown quality across projects. It produces structured JSON or human-readable reports and supports optional auto-fix with the --fix flag to update target files automatically.

What Markdown directories and files does this Skill validate?

Lint-markdown validates Markdown assets across skills/**/SKILL.md, AGENTS.md, agents/**, rules/**, governance/**, and related directories while excluding non-target directories specified in your configuration.

What are the prerequisites for running Markdown linting?

Lint-markdown requires Python 3 and a validator script at skills/llm-governance/scripts/validator.py. It loads config.yaml to define taxonomy classifications and custom rules for validation.

Does lint-markdown support auto-fixing Markdown violations?

Yes. Use the --fix flag to automatically update target files with corrections. Without --fix, lint-markdown generates validation reports only without modifying files.