workspace-create

Create and organize Pixie workspaces with unique ids and optional colors.

6|1|Updated May 17, 2026
One-click install
npx skills add https://github.com/AlexKapadia/Pixie --skill workspace-create
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: workspace-create
Source: https://github.com/AlexKapadia/Pixie/tree/main/.claude/skills/workspace-create
Command: npx skills add https://github.com/AlexKapadia/Pixie --skill workspace-create

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Creates Pixie workspaces to group tools by project or topic, enabling a clean, collapsible sidebar structure and easier organization of tools.

Core Features & Use Cases

  • Defines a workspace with a unique id (kebab-case), a display name, an optional accent colour, and a sort_order for stable ordering.
  • Tools belong to a workspace via the tool_workspaces join table, and workspaces are stored in the pixie.db.
  • Includes a preflight read of .build/KILL_FILE.md to apply a safe, documented fix if patterns collide.
  • Use cases include creating a new project workspace, grouping related tools by topic, or preparing a dashboard section for a team.

Quick Start

Provide the workspace name (and optional colour and sort_order) and I will derive an id, create the workspace, and confirm the result.

Frequently Asked Questions about workspace-create

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

FAQPage Schema
How do I create a new workspace in Pixie to group tools by project?

To create a Pixie workspace, provide a display name and optional colour or sort order. The system derives a kebab-case id, verifies it against existing workspaces, and safely creates the group via the Pixie API or database.

What is a Pixie workspace used for in sidebar organization?

A Pixie workspace organizes tools into project- or topic-based collapsible sidebar groups. It uses a unique id, optional accent colour, and display order to maintain a clean navigation structure for related tools.

Can I assign a custom color and display order when creating a Pixie workspace?

Yes, you can specify an optional accent colour and a sort_order value when creating a Pixie workspace. These parameters ensure stable, visually distinct ordering of your tool groups in the sidebar.

How does Pixie handle workspace id collisions during creation?

Pixie performs a preflight read of the .build/KILL_FILE.md to check for pattern collisions. If a collision is detected, it applies a safe, documented fix before proceeding with workspace creation.

Do I need a specific database setup to manage Pixie workspaces?

Workspace creation relies on the pixie.db database and the tool_workspaces join table. The Skill handles existence checks and safe creation automatically via Pixie's API or underlying database without manual SQL setup.

What's the best way to organize tools by topic using Pixie workspaces?

The best way is creating a workspace for each topic with a unique kebab-case id and sort_order. This groups related tools logically in the sidebar, preparing distinct dashboard sections for team access.