umbraco-skill-code-analyzer

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_MODULES set Add to KNOWN_EXTENSION_TYPES set