validate-links

Identifies structural and semantic errors in Storybook |text|.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/amplitude/amplitude-docs --skill validate-links-amplitude
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: validate-links
Source: https://github.com/amplitude/amplitude-docs/tree/main/.claude/skills/validate-links
Command: npx skills add https://github.com/amplitude/amplitude-docs --skill validate-links-amplitude

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Check documentation files for incorrect internal link formats and suggest corrections.

Core Features & Use Cases

  • Extracts all markdown links and categorizes them as internal, external, images, or anchors.
  • Validates internal links against Statamic routing rules and reports issues with line numbers.
  • Suggests corrections and can auto-fix issues to align with the /docs/ routing scheme.

Quick Start

Scan a file to produce a report of invalid internal links and recommended fixes in one go.

Frequently Asked Questions about validate-links

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

FAQPage Schema
How do I find and fix broken internal links in Statamic documentation?▼

Validate internal links by scanning Markdown files to ensure they begin with /docs/ and follow Statamic routing rules. It categorizes links as internal, external, images, or anchors, providing line-numbered reports and optional auto-fixes for broken paths.

How do I check Markdown files for invalid relative paths like ../ or ./?▼

Check Markdown files for invalid relative paths by validating links against routing rules that disallow ../ or ./ syntax. The scanner flags these paths and recommends corrections to ensure consistent routing across documentation.

Does the link validation process remove .md extensions from internal documentation links?▼

Yes, the link validation process removes .md extensions from internal documentation links. It enforces Statamic routing rules by ensuring links begin with /docs/, disallowing relative paths, and stripping .md extensions for consistent routing.

What is the best way to automate routing corrections for analytics and admin docs?▼

Automate routing corrections by scanning Markdown files across analytics, data, admin, and guides docs to apply suggested fixes. This ensures all internal links align with the /docs/ routing scheme and Statamic rules defined in CLAUDE.md.

Can I generate a line-numbered report of broken links in my documentation?▼

Yes, you can generate a line-numbered report of broken links by scanning Markdown documentation files. The validation process identifies incorrect internal link formats and outputs a report with line numbers and recommended fixes for consistent routing.

Why do my Statamic documentation links break after removing .md extensions?▼

Documentation links break after removing .md extensions if they do not begin with /docs/ or use disallowed relative paths like ../ or ./. The validation process enforces Statamic routing rules defined in CLAUDE.md to prevent broken internal links.