umbraco-skill-code-analyzer
Analyze code examples in SKILL.md files for correctness using static analysis and TypeScript compilation
How do I install this agent skill?
npx skills add https://github.com/umbraco/umbraco-cms-backoffice-skills --skill umbraco-skill-code-analyzerIs this agent skill safe to install?
- Gen Agent Trust Hubpass
The skill is a code analysis tool designed to validate Umbraco-related documentation. It scans the project directory for SKILL.md files, extracts code blocks, and performs checks using regex patterns and the TypeScript compiler. While it involves shell command execution and dynamic file generation to facilitate linting, these behaviors are aligned with its primary purpose as a static analysis utility.
- Socketpass
No alerts
- Snykpass
Risk: LOW · No issues
- Runlayerwarn
4/4 files flagged
What does this agent skill do?
Umbraco Skill Code Analyzer
Static analysis tool that validates code examples in SKILL.md files.
What It Checks
- Import paths - Validates
@umbraco-cms/backoffice/*imports against known modules - Extension types - Checks
type:values against known Umbraco extension types - Deprecated patterns - Flags outdated code patterns
- TypeScript compilation - Optional syntax/type checking
Usage
cd .claude/skills/umbraco-skill-code-analyzer/scripts
npm install --silent
npx tsx analyze-code.ts
Environment Variables
| Variable | Default | Description |
|---|---|---|
CHECK_TYPESCRIPT | true | Set to false to skip TypeScript compilation |
Output
Produces code-analysis-report.json in project root with structure:
{
"timestamp": "...",
"skillsScanned": 69,
"codeBlocksAnalyzed": 473,
"issuesFound": 34,
"skills": [
{
"skillPath": "...",
"skillName": "...",
"codeBlocks": 5,
"issues": [
{
"line": 33,
"type": "invalid-import",
"value": "@umbraco-cms/backoffice/unknown",
"message": "Unknown import path",
"severity": "warning"
}
]
}
],
"statistics": {
"totalCodeBlocks": 473,
"typescriptBlocks": 368,
"importIssues": 16,
"extensionTypeIssues": 21,
"compilationErrors": 0,
"deprecatedPatterns": 15
}
}
Issue Types
| Type | Severity | Description |
|---|---|---|
invalid-import | warning | Unknown @umbraco-cms/backoffice/* module |
unknown-extension-type | warning | Unrecognized extension type: value |
deprecated-pattern | warning | Outdated code pattern detected |
typescript-error | error | TypeScript compilation failed |
Updating Known Values
The script maintains lists of known modules and extension types. To update:
- Edit
analyze-code.ts - Add to
KNOWN_BACKOFFICE_MODULESset - Add to
KNOWN_EXTENSION_TYPESset
How can the creator link this skill?
Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.
<a href="https://skillzs.dev/skills/umbraco/umbraco-cms-backoffice-skills/umbraco-skill-code-analyzer">View umbraco-skill-code-analyzer on skillZs</a>