How do I install the Lint Markdown skill?

Run npx skillmds@latest add aibot88/lint-markdown in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Lint Markdown safe to use?

This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. Capability flags: docs only. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Lint Markdown?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Lint Markdown free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Lint Markdown?

aibot88 (@aibot88) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Lint Markdown by aibot88 — Agent Skill

Name: Lint Markdown
Rating: 4.5 (4 reviews)
Author: aibot88

File contents

Purpose

Execute Python-based markdown validation with three-tier classification based on taxonomy-rfc.md: STRICT files require full compliance with LLM-facing standards, MODERATE files apply governance rules, and LIGHT files receive basic validation.

IO Semantics

Input: File paths, directories, or global workspace scope with optional parameters.

Output: Structured linting reports with issue categorization, severity levels, and auto-fix suggestions when applicable.

Side Effects: Updates target files when using --fix parameter, generates structured reports in JSON or human-readable format.

Deterministic Steps

1. Environment Validation

Verify Python 3 availability.
Confirm validator script exists at skills/llm-governance/scripts/validator.py.
Validate config.yaml exists and loads properly.

2. File Classification

Apply STRICT classification to LLM-facing files: commands//*.md, skills//SKILL.md, agents//AGENT.md, rules//*.md, AGENTS.md, CLAUDE.md
Apply MODERATE classification to governance files: governance//*.md, config-sync//.md, agent-ops/**/.md
Apply LIGHT classification to remaining markdown files.
Exclude human-facing docs: docs/, examples/, tests/, ide/

3. Validation Execution

Run Python validator based on requested mode: python3 skills/llm-governance/scripts/validator.py for standard validation python3 skills/llm-governance/scripts/validator.py for JSON output (future)
Parse validator output and categorize issues by severity and type.

4. Report Generation

Aggregate results by file classification and issue type.
Generate structured summary with:
- Total issue count and severity breakdown
- Classification-specific compliance metrics
- Auto-fix success rate where applicable
Provide actionable recommendations organized by priority.

5. Validation Compliance

Ensure all processing respects skills/llm-governance/rules/99-llm-prompt-writing-rules.md constraints.
Apply imperative communication patterns in all output.
Maintain 100-character line limits in generated reports.

Safety Constraints

Never modify files without explicit --fix parameter.
Preserve original file content through backup mechanisms when fixing.
Respect file exclusions and never scan excluded directories.
Validate tool chain compatibility before executing validator.

---name: lint-markdowndescription: Execute markdown validation with taxonomy-based classification and custom rules. Use when validating markdown compliance with LLM-facing writing standards or when generating structured validation reports.--- ## Purpose Execute Python-based markdown validation with three-tier classification based on taxonomy-rfc.md: STRICT files require full compliance with LLM-facing standards, MODERATE files apply governance rules, and LIGHT files receive basic validation. ## IO Semantics Input: File paths, directories, or global workspace scope with optional parameters. Output: Structured linting reports with issue categorization, severity levels, and auto-fix suggestions when applicable. Side Effects: Updates target files when using --fix parameter, generates structured reports in JSON or human-readable format. ## Deterministic Steps ### 1. Environment Validation - Verify Python 3 availability. - Confirm validator script exists at `skills/llm-governance/scripts/validator.py`. - Validate config.yaml exists and loads properly. ### 2. File Classification - Apply STRICT classification to LLM-facing files: commands/**/*.md, skills/**/SKILL.md, agents/**/AGENT.md, rules/**/*.md, AGENTS.md, CLAUDE.md - Apply MODERATE classification to governance files: governance/**/*.md, config-sync/**/*.md, agent-ops/**/*.md - Apply LIGHT classification to remaining markdown files. - Exclude human-facing docs: docs/, examples/, tests/, ide/ ### 3. Validation Execution - Run Python validator based on requested mode: python3 skills/llm-governance/scripts/validator.py <directory> for standard validation python3 skills/llm-governance/scripts/validator.py <directory> for JSON output (future) - Parse validator output and categorize issues by severity and type. ### 4. Report Generation - Aggregate results by file classification and issue type. - Generate structured summary with: - Total issue count and severity breakdown - Classification-specific compliance metrics - Auto-fix success rate where applicable - Provide actionable recommendations organized by priority. ### 5. Validation Compliance - Ensure all processing respects skills/llm-governance/rules/99-llm-prompt-writing-rules.md constraints. - Apply imperative communication patterns in all output. - Maintain 100-character line limits in generated reports. ## Safety Constraints - Never modify files without explicit --fix parameter. - Preserve original file content through backup mechanisms when fixing. - Respect file exclusions and never scan excluded directories. - Validate tool chain compatibility before executing validator.

Frequently asked questions

Lint Markdown