umbraco-skill-code-analyzer

Analyze SKILL.md code blocks for invalid Umbraco imports and extension types.

1|Updated May 21, 2026
One-click install
npx skills add https://github.com/1k-off/umbraco-observability-playground --skill umbraco-skill-code-analyzer-1k-off
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: umbraco-skill-code-analyzer
Source: https://github.com/1k-off/umbraco-observability-playground/tree/main/.agents/skills/umbraco-skill-code-analyzer
Command: npx skills add https://github.com/1k-off/umbraco-observability-playground --skill umbraco-skill-code-analyzer-1k-off

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires glob, typescript, tsx, and includes scripts (resource) components.

What problem does it solve?

This Skill helps you catch incorrect Umbraco code snippets in SKILL.md files before they become misleading documentation or broken instructions.

Core Features & Use Cases

  • Validates Umbraco import paths: Flags unknown @umbraco-cms/backoffice/* module imports against a known allowlist.
  • Checks Umbraco extension manifest type: values: Detects unrecognized extension type: values in manifest-like code blocks.
  • Flags deprecated patterns: Identifies specific outdated patterns using regex rules.
  • Optional TypeScript compilation: Performs lightweight TypeScript checks on ts/tsx example blocks using stubbed Umbraco modules.
  • Use Case: Run this across a repository full of SKILL.md instructions to prevent incorrect examples from being shipped to teams or agents.

Quick Start

Run the analyzer to scan all SKILL.md files for invalid imports, unknown extension types, deprecated patterns, and (optionally) TypeScript errors.

Frequently Asked Questions about umbraco-skill-code-analyzer

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I validate Umbraco code examples in markdown documentation?

You validate Umbraco code examples in markdown by scanning SKILL.md files to detect invalid @umbraco-cms/backoffice imports, unrecognized manifest extension type values, and deprecated TypeScript patterns using static analysis.

What are common issues with Umbraco backoffice imports in TypeScript snippets?

Common issues with Umbraco backoffice imports include using unknown @umbraco-cms/backoffice/* module paths falling outside a known allowlist, or specifying unrecognized manifest extension type values within TypeScript code blocks.

Can I compile TypeScript code blocks inside SKILL.md files for error checking?

Yes, you can compile TypeScript code blocks inside SKILL.md files for error checking by running lightweight TypeScript compilation with stubbed Umbraco modules to catch syntax and type errors.

How do I detect deprecated Umbraco extension patterns in documentation?

You detect deprecated Umbraco extension patterns in documentation by applying regex-based deprecation rules to scan markdown code fences and flag specific outdated TypeScript or JavaScript patterns.

Does static analysis work for checking Umbraco manifest extension type values?

Yes, static analysis works for checking Umbraco manifest extension type values by scanning manifest-like code blocks in SKILL.md files and flagging any unrecognized type values against an allowlist.

What are the limitations of analyzing Umbraco TypeScript examples in markdown?

A limitation of analyzing Umbraco TypeScript examples in markdown is that TypeScript compilation is optional and relies on stubbed Umbraco modules, meaning actual runtime behavior or complex module interactions are not fully validated.