🎯

umbraco-skill-code-analyzer

🎯Skill

from umbraco/umbraco-cms-backoffice-skills

VibeIndex|
What it does

Validates code examples in Umbraco SKILL.md files by checking import paths, extension types, and performing TypeScript compilation.

πŸ“¦

Part of

umbraco/umbraco-cms-backoffice-skills(61 items)

umbraco-skill-code-analyzer

Installation

npm installInstall npm package
npm install --silent
npxRun with npx
npx tsx analyze-code.ts
πŸ“– Extracted from docs: umbraco/umbraco-cms-backoffice-skills
1Installs
-
AddedFeb 4, 2026

Skill Details

SKILL.md

Analyze code examples in SKILL.md files for correctness using static analysis and TypeScript compilation

Overview

# 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

```bash

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:

```json

{

"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:

  1. Edit analyze-code.ts
  2. Add to KNOWN_BACKOFFICE_MODULES set
  3. Add to KNOWN_EXTENSION_TYPES set