command-center-workspace-builder

Create, validate, and mutate Command Center workspaces and widget payloads.

6|1|Updated Nov 14, 2024
One-click install
npx skills add https://github.com/mainsequence-sdk/mainsequence-sdk --skill command-center-workspace-builder
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: command-center-workspace-builder
Source: https://github.com/mainsequence-sdk/mainsequence-sdk/tree/main/docs/astro/command_center/workspace_builder
Command: npx skills add https://github.com/mainsequence-sdk/mainsequence-sdk --skill command-center-workspace-builder

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill enables teams to create, update, validate, and review Main Sequence Command Center workspaces, handling workspace documents, widget payload resolution, layout decisions, and safe mutation.

Core Features & Use Cases

  • Create a new Command Center workspace
  • Update an existing workspace document
  • Add widgets to a workspace
  • Resolve widget instance payloads from local models or examples
  • Decide between full workspace update and widget-scoped mutation
  • Patch, move, or delete widgets safely
  • Verify shared workspace data versus current-user state
  • Review and validate workspace payloads for consistency

Quick Start

Define a workspace metadata payload and widget layout, then apply it to the Command Center via your preferred deployment method.

Frequently Asked Questions about command-center-workspace-builder

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

FAQPage Schema
How do I create a Command Center workspace with custom widget layouts?

To create a Command Center workspace, you define the workspace metadata payload and widget layout configuration, then apply it through your preferred deployment method. The builder validates IDs and ensures the layout is structurally consistent before applying the changes.

What is the safest way to update widget payloads in an existing workspace?

The safest way to update widget payloads is through widget-scoped mutations rather than full workspace overwrites. This approach applies guardrails that scope changes strictly to the target widget, resolving local payload sources and verifying valid IDs before patching.

How do I separate shared workspace data from current-user state?

Separating shared workspace data from current-user state requires validating the workspace payload structure to distinguish global layout configurations from user-specific widget states. The builder verifies this data separation during review to prevent cross-contamination.

Can I move or delete widgets without affecting the rest of the workspace layout?

Yes, you can safely move or delete widgets without impacting the surrounding layout. The mutation process enforces scoped guardrails that isolate the target widget instance, ensuring the broader workspace document remains structurally valid and unaffected.

When should I use a full workspace update instead of a widget-scoped mutation?

A full workspace update is necessary when applying broad structural changes to the workspace document or altering multiple widget layouts simultaneously. For isolated changes like patching, moving, or deleting a single widget, widget-scoped mutation provides safer, targeted modification.

Why does workspace validation fail when adding widgets with unresolved local payloads?

Workspace validation fails because widget instance payloads must be resolved from local models or examples before application. The builder enforces payload resolution and checks for valid IDs to guarantee workspace consistency and prevent unresolved references.