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.