umbraco-workspace

Implement Umbraco backoffice workspaces with routable contexts and observable unique values.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps you implement Umbraco backoffice workspaces that provide isolated draft editing experiences for specific entity types, including correct navigation and state handling.

Core Features & Use Cases

  • Workspace implementation guidance: Creates workspaces tailored to entity editing with the right extension types (contexts, views, actions, footer apps).
  • Correct workspace routing behavior: Explains when to use kind: 'default' versus kind: 'routable' and how to avoid broken selection/loading behavior.
  • Routable context + observable unique: Implements a workspace context pattern that exposes an observable unique to drive view updates during tree navigation.
  • View/action manifest patterns: Produces minimal but valid manifest examples that link workspace aliases to workspace views and tree item entity types.

Quick Start

Ask the agent to generate a routable workspace for your entity type with a workspace context exposing unique, plus a matching workspace view that consumes that context.

Frequently Asked Questions about umbraco-workspace

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

FAQPage Schema
How do I create a routable Umbraco backoffice workspace for draft editing?

To create a routable Umbraco backoffice workspace for draft editing, you define a workspace context class exposing an observable `unique`, set `kind: 'routable'` in your manifest, and link workspace views to your entity type.

Why does my Umbraco workspace lose tree selection when navigating between items?

Your Umbraco workspace loses tree selection when navigating because the workspace context lacks an observable `unique`. Exposing an observable `unique` in your routable workspace context drives view updates and maintains correct selection during tree navigation.

When should I use kind default versus kind routable for an Umbraco workspace?

Use `kind: 'routable'` for Umbraco workspaces requiring tree-integrated entity editing with dedicated navigation. Use `kind: 'default'` when you do not need routable navigation, as incorrect selection causes broken loading behavior.

What is a workspace context in Umbraco front-end extensions?

A workspace context in Umbraco front-end extensions is a TypeScript class that manages isolated editing state for specific entity types. It exposes an observable `unique` property to synchronize view updates during tree navigation.

Can I use TypeScript to build Umbraco workspace views and actions?

Yes, you can use TypeScript to build Umbraco workspace views and actions by generating manifests that align `entityType` and workspace alias conditions, linking workspace aliases to views and tree item entity types for proper integration.

How do I align Umbraco workspace manifests with entityType and workspace aliases?

To align Umbraco workspace manifests, you generate manifest entries that match your `entityType` to the correct workspace alias conditions, ensuring workspace views and actions properly bind to tree item entity types.