Skip to content
TakoAPI
Back to skills

markdown-validator

by wanng-ide

CLI Utilities
413Downloads reported by clawskills.sh
0Views
0 likesSign in to like this skill
—Not yet rated
Your rating

Brief

Validates Markdown files for broken local links.

Description

What This Skill Does

Validates Markdown files for broken local relative links by scanning recursively through a directory or a single file. Ignores external URLs and same-file anchors. Outputs a JSON report with each broken link's file path, link text, target URL, and line number.

Skipping external URLs and same-file anchors keeps results focused on local file integrity, avoiding false positives from network issues or anchor variations.

When to Use It

  • Checking internal doc links before a release
  • Auditing a wiki after files are reorganized
  • Verifying README links across a monorepo
  • Finding dead links after renaming or moving files
  • Running link validation in CI on documentation changes

Example Workflow

INPUT

User asks: check all Markdown files in the current directory for broken links

AGENT
  1. 1

    Run the validator against the current directory

  2. 2

    Receive a JSON array of results per file

  3. 3

    Identify entries where valid is false

  4. 4

    Extract brokenLinks arrays with text, url, and line fields

OUTPUT

JSON report listing each file with broken relative links, showing the link text, target path, and line number for each broken reference

Installation

clawhub install wanng-ide/markdown-validator

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

Links