workspace-remove-tool

Removes a tool link from a Pixie workspace by editing the tool_workspaces join.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Removes a tool from a workspace without removing the tool itself or the workspace. Use when the user asks to remove, unassign, ungroup, or detach a NAMED tool from a workspace, project, or section. Do NOT use to delete the tool (remove-tool), archive (archive-tool), or delete the workspace.

Core Features & Use Cases

  • Unlink a single tool from a specific workspace by removing the association in tool_workspaces.
  • Preserve the tool's installation and its presence in other workspaces.
  • Use case: detach a tool from one workspace while keeping it available in others.

Quick Start

Identify the tool_id and workspace_id, then run the unlink command via the Pixie API or direct database update to detach the tool from the workspace.

Frequently Asked Questions about workspace-remove-tool

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

FAQPage Schema
How do I remove a tool from a workspace without deleting the tool itself?▼

To unlink a tool from a workspace, you must remove its association in the tool_workspaces database join using the tool_id and workspace_id. This safely detaches the specific tool while preserving its installation.

How do I unbind a tool from one workspace but keep it active in others?▼

Unbinding a tool from a single workspace requires deleting its specific link in the tool_workspaces table via API or database operation. This removes the tool from that workspace while leaving its other workspace associations intact.

What is the difference between unlinking and archiving a workspace tool?▼

Unlinking a workspace tool removes its binding in the tool_workspaces join without deleting the tool or workspace. Archiving or deleting a tool performs different operations that affect the tool's overall availability rather than just the workspace association.

What inputs do I need to detach a tool from a workspace safely?▼

Detaching a tool from a workspace safely requires the specific tool_id and workspace_id as inputs. The process validates that the link exists in the tool_workspaces join before deleting it and reporting the remaining associations.

Can I use the database API to unassign a tool from a workspace?▼

Yes, you can unassign a tool from a workspace by executing an unlink command through the Pixie API or a direct database update. This targets the tool_workspaces join to remove the specific link between the tool and workspace.

When should I not use workspace tool unlinking?▼

You should not use workspace tool unlinking when you intend to completely delete the tool, archive the tool, or delete the workspace itself. Unlinking only removes the specific association between a named tool and a workspace.