broken-refs

You can find broken file references in SKILL.md documents by running a validator that parses YAML frontmatter, resolves relative paths, and reports missing files with actionable remediation steps.

Broken links to scripts and assets occur when SKILL.md files reference paths that have been moved, renamed, or deleted, causing runtime failures and documentation breakage in local repositories and CI pipelines.

Yes, you can validate missing references in a CI pipeline before deployment by integrating the validator to automatically catch broken links to scripts, references, and assets directories.

To resolve mislinked references in skill documentation, run the validator on your skill directory to identify missing files and generate a remediation plan that provides actionable steps to repair the links.

Yes, the broken reference validator parses YAML frontmatter to extract linked paths and resolves relative file paths to validate the existence of referenced files in scripts, references, and assets directories.