broken-reference

Detect missing or invalid Markdown links in skill documents.

33|Updated Jan 5, 2026
One-click install
npx skills add https://github.com/lvlup-sw/exarchos --skill broken-reference-lvlup-sw
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: broken-reference
Source: https://github.com/lvlup-sw/exarchos/tree/main/skills/test-fixtures/broken-reference
Command: npx skills add https://github.com/lvlup-sw/exarchos --skill broken-reference-lvlup-sw

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill helps identify and surface broken cross-file references within skill documentation, preventing broken links from weakening the skill's reliability.

Core Features & Use Cases

  • Reference validation: Detects missing or invalid links to other files referenced in SKILL.md or in referenced sections, ensuring integrity of documentation.
  • Link health reporting: Provides clear error messages and status for broken references to guide fixes during discovery and validation.
  • Use Case: When reviewing a new skill, run this to quickly surface any missing references before activation.

Quick Start

Validate the skill's references by running a lightweight scan against SKILL.md and the references directory.

Frequently Asked Questions about broken-reference

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

FAQPage Schema
How do I check for broken references in Markdown documentation?

To check for broken references in Markdown documentation, you can run a lightweight scan against SKILL.md to identify missing or invalid links and validate that referenced targets exist.

What does YAML frontmatter integrity validation do for skill packages?

YAML frontmatter integrity validation ensures the structural completeness of skill packages, alerting on missing references during the discovery phase to prevent broken links from weakening documentation reliability.

Can I detect missing cross-file links in SKILL.md before activation?

Yes, you can detect missing cross-file links in SKILL.md before activation by running a reference validation scan that surfaces invalid links to external files and provides clear error messages.

How do I validate external file targets referenced in skill documents?

You validate external file targets by scanning the skill documents and referenced sections, confirming that the referenced targets exist and generating a link health report for any broken references.

Why does link health reporting matter for documentation quality?

Link health reporting matters for documentation quality because it provides clear status and error messages for broken references, guiding necessary fixes during skill review and ensuring overall reliability.