umbraco-skill-validator

Checking for broken markdown links involves scanning SKILL.md files to extract external URLs, internal relative paths, and cross-skill references. The validator checks URLs via HTTP HEAD requests with retries and verifies internal paths on disk with structured reporting.

Yes, you can gate CI pipelines using the exit codes returned by the validator. It performs deterministic repository-wide scanning of SKILL.md files and returns structured failure codes suitable for blocking deployments when broken links or missing targets are detected.

Path resolution for Umbraco-CMS references verifies targets using local environment hints first, then falls back to the GitHub contents API. This ensures documentation QA accurately identifies whether referenced Umbraco-CMS paths exist within the repository structure.

The best way to fix invalid internal markdown paths and external URLs is to use the structured JSON report to generate a diff-style fix plan. This workflow guides targeted corrections with line numbers for human approval before editing.

Yes, you need a Node.js environment because the validator depends on the cockatiel, glob, and tsx packages. These dependencies enable TypeScript script execution, file pattern matching, and resilient HTTP retry logic for link checking.