workspace-add-tool

Link an existing Pixie tool to a workspace via the tool_workspaces join.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Adds an existing Pixie tool to an existing workspace via the tool_workspaces join - sidebar grouping only. Use when the user asks to add, assign, move, or group a NAMED tool INTO a workspace, project, or section. Do NOT use to create the workspace (workspace-create), tag (tag-tool), or duplicate (fork-tool).

Core Features & Use Cases

  • Link a tool to a workspace without altering the tool's runtime state or its tool.json.
  • Support scenarios where a tool needs to be added to or reorganized within a workspace or sidebar group.
  • Enforce safe operations by guiding the user to create missing workspaces or tools before linking, and by preventing unintended modifications to runtime state.

Quick Start

Add an existing Pixie tool to an existing workspace by linking the tool_id to the workspace_id.

Frequently Asked Questions about workspace-add-tool

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

FAQPage Schema
How do I add an existing tool to a workspace sidebar?

To link a tool to a workspace, update the tool_workspaces join with the existing tool_id and workspace_id. This organizes the sidebar without modifying the tool's runtime state or configuration.

What happens to a tool's runtime configuration when it is assigned to a workspace?

Assigning a tool to a workspace only updates the tool_workspaces join for sidebar organization. It does not modify the tool's runtime state or its configuration files.

Can I move or group multiple tools into a project section?

Yes, you can reorganize tools by linking each named tool to the target workspace or project section. This updates the sidebar grouping without creating duplicate tool entries.

What preflight checks are required before linking a tool to a workspace?

Before linking, the system verifies that the tool exists, the workspace exists, and the link is not a duplicate. Missing tools or workspaces must be created before attempting the link.

Does adding a tool to a workspace create a duplicate or fork?

No, adding a tool to a workspace creates a link via the tool_workspaces join and does not duplicate or fork the tool. It enforces non-duplication checks before creating the link.