메뉴
Validate links and references in SKILL.md files using deterministic scripts
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
Implement UFM (Umbraco Flavored Markdown) components in Umbraco backoffice using official docs
Add a new Umbraco extension project reference to the main Umbraco instance and solution
Understand and use localization in Umbraco backoffice (foundational concept)
Implement property editor UIs in Umbraco backoffice using official docs
Quick setup for Umbraco extension development - creates instance, extension, and registers it
Review checks reference for validating Umbraco backoffice extensions
| name | umbraco-skill-validator |
| description | Validate links and references in SKILL.md files using deterministic scripts |
| allowed-tools | Bash, Read, Glob, Task, AskUserQuestion, Edit |
Validates all SKILL.md files in the repository for broken links, missing references, and invalid paths.
| 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 |
/validate-skills
cd .claude/skills/umbraco-skill-validator/scripts
npm install
npm run validate
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: |
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: ...
https://docs.umbraco.com/...
https://github.com/umbraco/...
`umbraco-dashboard`
`umbraco-workspace`
[Pattern Name](patterns/pattern-name.md)
[Example](examples/example-name/)
/Umbraco-CMS/src/Umbraco.Web.UI.Client/...
src/packages/core/...
import { ... } from '@umbraco-cms/backoffice/notification';
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:
Present fix plan to user with AskUserQuestion
Execute only approved fixes using Edit tool