How do I install the Umbraco Skill Validator skill?

Run npx skillmds@latest add majiayu000/umbraco-skill-validator in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

What does the Umbraco Skill Validator skill do?

Validate links and references in SKILL.md files using deterministic scripts It is listed under Coding & Dev Tools on SkillMD.

Is Umbraco Skill Validator safe to use?

This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. Capability flags: makes network calls. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Umbraco Skill Validator?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Umbraco Skill Validator free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Umbraco Skill Validator?

majiayu000 (@majiayu000) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Umbraco Skill Validator by majiayu000

Name: Umbraco Skill Validator
Rating: 4.2 (5 reviews)
Author: majiayu000

File contents

Skill Content Validator

Validates all SKILL.md files in the repository for broken links, missing references, and invalid paths.

What This Skill Does

Runs deterministic validation script - Fast, consistent checking of all links
Generates structured report - JSON output with all issues found
Spawns fixer subagent - AI-powered fix suggestions for issues
Presents fix plan - Diff-style changes for approval
Executes approved fixes - Only applies changes user approves

Validation Checks

Check Type	Description
External URLs	HTTP HEAD request to verify accessibility
Skill references	Verify referenced skills exist (e.g., `umbraco-dashboard`)
Internal links	Check relative paths resolve (e.g., `patterns/foo.md`)
File paths	Verify Umbraco-CMS paths via GitHub API if not local
Import paths	Check `@umbraco-cms/backoffice/*` imports are valid

Running the Validator

Via Slash Command

/validate-skills

Via Script Directly (CI/CD)

cd .claude/skills/umbraco-skill-validator/scripts
npm install
npm run validate

Report Format

The script outputs JSON that gets formatted as:

# Skill Validation Report

## Summary
- Skills scanned: 25
- Issues found: 3
- Auto-fixable: 2

## Issues by Skill

### `umbraco-dashboard`
| Line | Type | Issue | Status |
|------|------|-------|--------|
| 45 | Broken URL | [example-broken-url] returns 404 | :x: |

### `umbraco-tree`
| Line | Type | Issue | Status |
|------|------|-------|--------|
| 72 | Missing skill | [example-missing-skill] not found | :x: |

Fix Plan Format

When issues are found, the fixer subagent generates:

# Fix Plan

## Fix 1: Update broken URL
**File:** plugins/.../umbraco-dashboard/SKILL.md
**Line:** 45
**Action:** Replace with current documentation URL

- [Dashboard docs][old-url]
+ [Dashboard docs][new-url]

## Approval
- [ ] Fix 1: Update broken URL
- [ ] Fix 2: ...

Link Patterns Detected

External URLs

https://docs.umbraco.com/...
https://github.com/umbraco/...

Skill References

`umbraco-dashboard`
`umbraco-workspace`

Internal Pattern Links

[Pattern Name](patterns/pattern-name.md)
[Example](examples/example-name/)

File Paths

/Umbraco-CMS/src/Umbraco.Web.UI.Client/...
src/packages/core/...

Import Paths (in code blocks)

import { ... } from '@umbraco-cms/backoffice/notification';

Workflow Instructions

When this skill is invoked:

Run the validation script

cd .claude/skills/umbraco-skill-validator/scripts
npx tsx validate-links.ts

Read the JSON output from stdout or validation-report.json
Format as markdown report using the template above
If issues found, spawn the skill-content-fixer agent:
- Pass the JSON report as context
- Request fix suggestions with diffs
Present fix plan to user with AskUserQuestion
Execute only approved fixes using Edit tool

Edge Cases

Rate limiting: Script batches URL checks with 100ms delays
Redirects: Reported as warnings with new URL suggestion
Missing Umbraco-CMS: Falls back to GitHub API
Timeouts: 5 second timeout per URL request
Large repos: Processes files in batches of 10

---name: umbraco-skill-validatordescription: Validate links and references in SKILL.md files using deterministic scripts--- # Skill Content Validator Validates all SKILL.md files in the repository for broken links, missing references, and invalid paths. ## What This Skill Does 1. **Runs deterministic validation script** - Fast, consistent checking of all links 2. **Generates structured report** - JSON output with all issues found 3. **Spawns fixer subagent** - AI-powered fix suggestions for issues 4. **Presents fix plan** - Diff-style changes for approval 5. **Executes approved fixes** - Only applies changes user approves ## Validation Checks | Check Type | Description | |------------|-------------| | External URLs | HTTP HEAD request to verify accessibility | | Skill references | Verify referenced skills exist (e.g., `umbraco-dashboard`) | | Internal links | Check relative paths resolve (e.g., `patterns/foo.md`) | | File paths | Verify Umbraco-CMS paths via GitHub API if not local | | Import paths | Check `@umbraco-cms/backoffice/*` imports are valid | ## Running the Validator ### Via Slash Command ``` /validate-skills ``` ### Via Script Directly (CI/CD) ```bash cd .claude/skills/umbraco-skill-validator/scripts npm install npm run validate ``` ## Report Format The script outputs JSON that gets formatted as: ```markdown # Skill Validation Report ## Summary - Skills scanned: 25 - Issues found: 3 - Auto-fixable: 2 ## Issues by Skill ### `umbraco-dashboard` | Line | Type | Issue | Status | |------|------|-------|--------| | 45 | Broken URL | [example-broken-url] returns 404 | :x: | ### `umbraco-tree` | Line | Type | Issue | Status | |------|------|-------|--------| | 72 | Missing skill | [example-missing-skill] not found | :x: | ``` ## Fix Plan Format When issues are found, the fixer subagent generates: ```markdown # Fix Plan ## Fix 1: Update broken URL **File:** plugins/.../umbraco-dashboard/SKILL.md **Line:** 45 **Action:** Replace with current documentation URL - [Dashboard docs][old-url] + [Dashboard docs][new-url] ## Approval - [ ] Fix 1: Update broken URL - [ ] Fix 2: ... ``` ## Link Patterns Detected ### External URLs ``` https://docs.umbraco.com/... https://github.com/umbraco/... ``` ### Skill References ``` `umbraco-dashboard` `umbraco-workspace` ``` ### Internal Pattern Links ``` [Pattern Name](patterns/pattern-name.md) [Example](examples/example-name/) ``` ### File Paths ``` /Umbraco-CMS/src/Umbraco.Web.UI.Client/... src/packages/core/... ``` ### Import Paths (in code blocks) ```typescript import { ... } from '@umbraco-cms/backoffice/notification'; ``` ## Workflow Instructions When this skill is invoked: 1. **Run the validation script** ```bash cd .claude/skills/umbraco-skill-validator/scripts npx tsx validate-links.ts ``` 2. **Read the JSON output** from stdout or `validation-report.json` 3. **Format as markdown report** using the template above 4. **If issues found**, spawn the `skill-content-fixer` agent: - Pass the JSON report as context - Request fix suggestions with diffs 5. **Present fix plan** to user with AskUserQuestion 6. **Execute only approved fixes** using Edit tool ## Edge Cases - **Rate limiting**: Script batches URL checks with 100ms delays - **Redirects**: Reported as warnings with new URL suggestion - **Missing Umbraco-CMS**: Falls back to GitHub API - **Timeouts**: 5 second timeout per URL request - **Large repos**: Processes files in batches of 10

Frequently asked questions

Umbraco Skill Validator