Browse / Learning Documentation / Link Validator

Link Validator

Validates markdown links within Claude Code skills and plugins to ensure cross-installation portability.

SkillLearning DocumentationSkill AuthoringDocs Standards

The source repository doesn't declare a license. Check its terms before reusing the code.

Key features

  • Offers clear exit codes for CI/CD integration
  • Provides task templates for validating single skills or entire plugins
  • Validates markdown links for portability across different installation locations
  • Identifies and reports absolute repository paths as violations
  • Supports relative paths, external URLs, and anchor links

Use cases

  • Running automated checks in a CI/CD pipeline to prevent broken links
  • Preparing a skill or plugin for public distribution
  • Auditing an existing skill repository for portability and documentation issues

FAQ

What kind of links does this skill flag as violations?

The skill flags absolute repository paths as violations because they are not portable. It correctly allows relative paths (e.g., `./doc.md`), full external URLs, and internal anchor links.

When is the best time to use this skill?

Use it before sharing or distributing your skills, as part of an automated CI/CD pipeline, or anytime you've added new documentation links to ensure they won't break for other users.

How does this skill improve my development workflow?

It automates the tedious task of manually verifying links, preventing errors and saving time. With clear exit codes for CI/CD, it acts as an automated quality gate for your skill and plugin distributions.

What does the Link Validator skill do?

It automatically scans your Claude Code skills and plugins for absolute markdown links (e.g., `/skills/foo.md`) that can break when installed in different locations, ensuring your projects are portable and reliable.