umbraco-skill-validator

Validate links, references, and file paths in SKILL.md files.

26|13|Updated Nov 30, 2025
One-click install
npx skills add https://github.com/umbraco/Umbraco-CMS-Backoffice-Skills --skill umbraco-skill-validator
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: umbraco-skill-validator
Source: https://github.com/umbraco/Umbraco-CMS-Backoffice-Skills/tree/main/.claude/skills/umbraco-skill-validator
Command: npx skills add https://github.com/umbraco/Umbraco-CMS-Backoffice-Skills --skill umbraco-skill-validator

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires cockatiel, glob, tsx, and includes scripts (resource) components.

What problem does it solve?

This Skill automates the tedious and error-prone process of manually checking all links, references, and file paths within your SKILL.md documentation, ensuring accuracy and preventing broken documentation.

Core Features & Use Cases

  • Deterministic Validation: Runs a fast, consistent script to check all links and references.
  • Structured Reporting: Generates a clear JSON report detailing all issues found.
  • AI-Powered Fixes: Spawns a sub-agent to suggest and apply fixes with user approval.
  • Use Case: Before merging documentation changes, run this skill to automatically catch any broken external URLs, missing internal links, or invalid skill references, ensuring your documentation remains reliable.

Quick Start

Run the /validate-skills command to check all SKILL.md files in the repository.

Frequently Asked Questions about umbraco-skill-validator

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

FAQPage Schema
How do I validate links and file paths in SKILL.md files?

To validate links in SKILL.md files, run a deterministic script that scans external URLs, internal markdown references, and import paths via the GitHub API, generating a structured JSON report of broken documentation.

What is the best way to automate checking documentation links before merging?

Automating documentation checks before merging involves running a validation script against your SKILL.md files to catch broken external URLs and invalid skill references, which produces a JSON report for review.

Can I automatically fix broken markdown links and invalid skill references?

Yes, you can fix broken markdown links and invalid skill references by spawning an AI sub-agent that suggests and applies fixes based on the structured JSON validation report, pending your final approval.

Does this link validation skill require the GitHub API for internal file paths?

Yes, validating internal markdown links and file paths requires the GitHub API to deterministically check import paths and references within your SKILL.md documentation.

What limitations exist when validating SKILL.md documentation with scripts?

A limitation of validating SKILL.md documentation with scripts is that automated checks focus on deterministic link and path accuracy, requiring an AI sub-agent for actual fixes rather than handling semantic documentation errors.