gsd-remove-workspace

Remove a GSD workspace and its associated Git worktrees.

Updated Jan 25, 2026
One-click install
npx skills add https://github.com/MINT-IA/MINT --skill gsd-remove-workspace-mint-ia
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gsd-remove-workspace
Source: https://github.com/MINT-IA/MINT/tree/main/.claude/skills/gsd-remove-workspace
Command: npx skills add https://github.com/MINT-IA/MINT --skill gsd-remove-workspace-mint-ia

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Remove a GSD workspace and clean up worktrees to ensure no leftover repos or references remain after task completion.

Core Features & Use Cases

  • Safely removes a GSD workspace directory and all associated worktrees
  • Validates there are no uncommitted changes before removal
  • Supports multi-repo worktrees by removing each member repo before cleanup

Quick Start

Provide the workspace name to remove and confirm the prompt to proceed.

Frequently Asked Questions about gsd-remove-workspace

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

FAQPage Schema
How do I safely remove a git worktree workspace with multiple repos?

To safely remove a git worktree workspace, the tool validates that all member repositories have no uncommitted changes. It then systematically removes the git worktree for each member repository before cleaning up the main workspace directory.

What happens if I try to remove a workspace with uncommitted changes?

If any repository in the workspace has uncommitted changes, the removal process refuses execution and aborts. This safety mechanism prevents the accidental loss of local modifications during the git worktree cleanup process.

Can I delete a GSD workspace if it contains multiple git worktrees?

Yes, you can delete a GSD workspace containing multiple git worktrees. The tool iterates through each member repository, executing git worktree removal individually to ensure all associated references are properly cleaned up before removing the main directory.

How do I clean up leftover git worktrees after completing a task?

To clean up leftover git worktrees after task completion, provide the workspace name to the removal tool and confirm the prompt. This automates the safe removal of all associated worktrees and prevents leftover repository references.

Does the workspace removal tool delete the main repository?

The workspace removal tool deletes the GSD workspace directory and all associated worktrees created within it. It ensures no leftover worktree references remain by validating the status of each member repository prior to deletion.