umbraco-validation-checks

Debug Umbraco backoffice extensions with categorized validation checks.

26|13|Updated Nov 30, 2025
One-click install
npx skills add https://github.com/umbraco/Umbraco-CMS-Backoffice-Skills --skill umbraco-validation-checks
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: umbraco-validation-checks
Source: https://github.com/umbraco/Umbraco-CMS-Backoffice-Skills/tree/main/plugins/umbraco-backoffice-skills/skills/umbraco-validation-checks
Command: npx skills add https://github.com/umbraco/Umbraco-CMS-Backoffice-Skills --skill umbraco-validation-checks

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill provides a comprehensive set of checks and guidance to help developers identify and resolve common issues encountered when building and testing Umbraco backoffice extensions.

Core Features & Use Cases

  • Systematic Debugging: Offers categorized checks for configuration, navigation, API, forms, and workspaces.
  • Symptom-Based Guidance: Helps pinpoint relevant checks based on observed issues (e.g., "Can't see my extension").
  • Quick Reference: Provides tables of common IDs, checks, and symptoms for rapid troubleshooting.
  • Use Case: When a new Umbraco backoffice extension fails to appear in the sidebar, a developer can load this skill, consult the 'Configuration Checks' section, and quickly identify that user group permissions need to be updated.

Quick Start

Load this skill before starting manual browser validation for your Umbraco backoffice extension.

Frequently Asked Questions about umbraco-validation-checks

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

FAQPage Schema
How do I debug an Umbraco backoffice extension that fails to appear in the sidebar?

To debug an Umbraco backoffice extension not appearing in the sidebar, use systematic configuration checks to verify user group permissions and registration. This skill provides categorized checks to quickly identify missing configuration causing visibility issues.

What is the best way to troubleshoot Umbraco API interactions for custom extensions?

The best way to troubleshoot Umbraco API interactions is to apply specific diagnostic steps based on observed symptoms. This skill guides developers through identifying common API communication issues and resolving them efficiently.

Can I run validation checks for Umbraco form controls and workspaces?

Yes, you can run validation checks for Umbraco form controls and workspaces. This skill provides a structured framework of categorized checks specifically designed to test form controls and workspace functionality within the backoffice.

Why does my Umbraco extension navigation break after updating configuration?

Your Umbraco extension navigation might break after configuration updates due to incorrect routing or registration. This skill offers navigation checks to pinpoint relevant configuration mismatches and apply specific diagnostic steps to resolve the issue.

Do I need to install dependencies to use this Umbraco validation framework?

No, you do not need to install dependencies to use this Umbraco validation framework. The skill operates as a standalone reference, requiring only that you load it before starting manual browser validation for your backoffice extension.