skills.rest
umbraco
umbracoOFFICIAL
Explore all skills by this author →
WebsiteGitHub

general-create-workspace

Scaffold default or routable workspace extensions for Umbraco backoffice entities.

5.2k|2.9k|Updated Jun 10, 2013
Search Tags:#workspace#lit element#typeScript#backoffice#Umbraco#extension manifest#Scaffold
One-click install
npx skills add https://github.com/umbraco/Umbraco-CMS --skill general-create-workspace
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: general-create-workspace
Source: https://github.com/umbraco/Umbraco-CMS/tree/main/src/Umbraco.Web.UI.Client/.claude/skills/general-create-workspace
Command: npx skills add https://github.com/umbraco/Umbraco-CMS --skill general-create-workspace

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Creating a new workspace in the Umbraco backoffice requires coordinating many files — context tokens, workspace contexts, editor elements, view elements, and extension manifests — with strict conventions that are easy to get wrong. This Skill guides the AI through scaffolding either a manifest-only default workspace or a full routable workspace with create/edit routing, validation, and save flows.

Core Features & Use Cases

  • Default Workspace Scaffolding: Generate manifest-only workspaces for root pages, listing pages, and settings with optional collection workspace views.
  • Routable Workspace Scaffolding: Create full entity-detail workspaces including context token, workspace context class, editor element, detail view element, and workspace/view/action manifests.
  • Parent-Aware Variants: Supports both flat entities (like webhook) and tree entities requiring a parent (like data-type) with the appropriate create route pattern.
  • Use Case: A developer says "add a workspace for my webhook entity" and receives a complete, convention-compliant workspace wired into the package's manifests, including save actions and new-entity redirect handling.

Quick Start

Ask the AI to create a routable workspace for your entity, providing the entity name, package path, and whether creation requires a parent entity.

Frequently Asked Questions about general-create-workspace

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

FAQPage Schema
How do I create a workspace in the Umbraco backoffice?▼

Choose between a default workspace (manifest-only, for root or listing pages) or a routable workspace (custom context class with create/edit routes for entity detail editing). The Skill generates the required manifests, context, and elements based on your entity name and package path.

What is the difference between default and routable workspaces in Umbraco?▼

A default workspace uses the built-in UmbDefaultWorkspaceContext and needs only a manifest with kind 'default'. A routable workspace uses kind 'routable' with a custom context class extending UmbEntityNamedDetailWorkspaceContextBase, enabling create/edit URL routing and full CRUD lifecycle.

What prerequisites are needed before creating a routable workspace?▼

The entity must already have entity type constants, a detail model type, a detail repository with data source and store, and a registered repository manifest. If the package does not exist yet, create it first with the general-create-package skill.

How do I handle tree entities that require a parent in Umbraco workspaces?▼

Use the parent-aware create route variant with path 'create/parent/:entityType/:parentUnique'. The route setup extracts the parent entity type and unique identifier from route params and passes them to createScaffold before redirecting to the edit route.

Why is my Umbraco workspace view not showing up?▼

Workspace views only render when their conditions match. Verify the view manifest includes the UMB_WORKSPACE_CONDITION_ALIAS condition matching your workspace alias, and that the workspace manifests are imported and spread into the parent module's manifests.ts.

Related Skills

Explore More Software Engineering Skills→
consuelohqconsuelohq
1

syncable-entity-types-and-constants

Define syncable entity types, TypeORM entities, and central constants for workspace migrations.

Official
Advanced
1k-off1k-off
1

umbraco-menu

Create Umbraco backoffice menu manifests with aliases and placement rules.

Community
Basic
albanistrefialbanistrefi
4

umbraco-entity-bulk-actions

Implement Umbraco backoffice entity bulk actions with manifest registration and selection iteration.

Community
Intermediate
albanistrefialbanistrefi
4

umbraco-workspace

Generate Umbraco backoffice routable workspaces with context, views, and actions.

Community
Intermediate