umbraco-17-planning

Guides planning and sequencing of Umbraco 17 schema and backoffice extension work.

Updated May 26, 2026
One-click install
npx skills add https://github.com/robot-denny/ai-sketchlab --skill umbraco-17-planning-robot-denny
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: umbraco-17-planning
Source: https://github.com/robot-denny/ai-sketchlab/tree/main/.agents/skills/umbraco-17-planning
Command: npx skills add https://github.com/robot-denny/ai-sketchlab --skill umbraco-17-planning-robot-denny

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Planning work on an Umbraco 17 project is error-prone when done blind: schema IDs, existing compositions, and backoffice extension registry patterns cannot be reliably inferred from training data or committed files alone. This Skill supplies stack-specific planning rules so plans are grounded in the live CMS state and authoritative extension guidance. ## Core Features & Use Cases - Live schema inspection before planning: Directs use of Umbraco MCP tools (get-all-document-types, get-all-data-types, and related lookups) to surface real IDs, property editors, and reusable compositions before designing schema steps. - Backoffice extension routing: Maps each extension type (dashboards, property editors, workspaces, modals, trees, context API, entry points, entity actions, block editor custom views) to the authoritative umbraco-cms-backoffice-skills companion, with explicit fallback behavior when those skills are unavailable. - Layer vocabulary and step ordering: Defines the layers an Umbraco feature spans (schema, slice, client-side components, backoffice extension, tests) and the step order that usually works, including model regeneration handling. - Use Case: When asked to plan a new document type with a custom dashboard, first query the live instance for existing compositions, record discovered IDs in Key Decisions, then sequence schema, slice, and extension steps per the prescribed order. ## Quick Start Ask the assistant to plan an Umbraco 17 feature such as adding a document type with a custom backoffice dashboard, and it will inspect the live schema and sequence the work steps accordingly.

Frequently Asked Questions about umbraco-17-planning

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

FAQPage Schema
How do I plan a new document type in Umbraco 17?

Query the live Umbraco instance via MCP tools like get-all-document-types and get-all-data-types before designing schema steps. Record discovered IDs and aliases in the plan's Key Decisions section, then author schema through the backoffice or Management API rather than hand-editing .uda files.

What is the correct step order for an Umbraco 17 feature?

Start with schema, then the slice (view model plus view or controller), then integration wiring, then client-side assets, then tests, and finally record behavior. Backoffice extensions follow their own order: registration, component, context and state, tests, then record behavior.

Which skill covers Umbraco backoffice dashboards and property editors?

Backoffice extension work routes to the umbraco-cms-backoffice-skills pack, with dedicated skills for dashboards, property editor UIs, workspaces, modals, trees, context API, entry points, entity actions, and block editor custom views. Testing routes to umbraco-cms-backoffice-testing-skills.

What happens if the Umbraco backoffice skills are not enabled?

Plan from the codebase's existing extension patterns instead, naming the closest analogue used. Record in Key Decisions which companion skill is missing and how enabling it would improve the plan; if no local precedent exists either, treat extension steps as unvalidated.

Should I hand-edit .uda files to change Umbraco schema?

No. Committed schema files (.uda under Deploy or uSync .config files) are the source of truth for structure, but schema should be authored via the backoffice or Management API. Hand-editing risks conflicts with the Deploy pipeline.