Skip to content
TakoAPI
Back to skills

markdown-linter

by wanng-ide

Web & Frontend Development
527Downloads reported by clawskills.sh
0Views
0 likesSign in to like this skill
—Not yet rated
Your rating

Brief

Validates Markdown files in the workspace for broken local links, missing file references, and basic syntax issues.

Description

What This Skill Does

Validates Markdown files in a workspace by scanning for broken local links, missing file references, and structural issues like header hierarchy and unlabeled code blocks. Outputs a structured JSON report with file locations and error details.

Catches broken internal links and structural issues in bulk across an entire workspace, rather than requiring manual inspection of each file.

When to Use It

  • Checking MEMORY.md for broken file references before a commit
  • Validating SKILL.md links after reorganizing a project directory
  • Scanning a docs folder for missing image references
  • Verifying header hierarchy in a project README
  • Finding unlabeled code blocks across documentation files

Example Workflow

INPUT

User asks: scan my workspace for broken links and syntax issues

AGENT
  1. 1

    Calls linter.scan('.') on the workspace root

  2. 2

    Recursively traverses all .md files

  3. 3

    Checks each [link](path) reference against the local filesystem

  4. 4

    Validates header hierarchy and code block language tags

  5. 5

    Returns a structured JSON report listing broken links and syntax errors by file and line number

OUTPUT

JSON report showing totalFiles scanned, an array of brokenLinks with file path, line number, and error message, and any syntaxErrors found

Installation

clawhub install wanng-ide/markdown-linter

Run the CLI command, or paste the prompt into Claude Code, Cursor, Codex or whichever coding agent you use.

Links