gsd-remove-workspace

Remove a GSD workspace directory and its git worktrees after user confirmation.

Updated Mar 27, 2026
One-click install
npx skills add https://github.com/onelee85/my-skills --skill gsd-remove-workspace
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gsd-remove-workspace
Source: https://github.com/onelee85/my-skills/tree/main/gsd-remove-workspace
Command: npx skills add https://github.com/onelee85/my-skills --skill gsd-remove-workspace

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Remove a GSD workspace and clean up worktrees, preventing leftover files and ensuring a clean development environment.

Core Features & Use Cases

  • Remove the workspace directory and associated git worktrees for a given GSD workspace.
  • Safeguard against uncommitted changes by refusing to remove when changes exist.
  • Clean up member repositories in a worktree setup and surface a clear success message.

Quick Start

Provide the workspace name and confirm to remove it along with all associated worktrees.

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 without losing uncommitted changes?

To safely remove a git worktree without losing uncommitted changes, use a tool that checks repository status first. This Skill refuses to proceed if any member repository has uncommitted changes, ensuring no work is lost during workspace cleanup.

What is the best way to clean up a multi-repo git worktree workspace?

The best way to clean up a multi-repo git worktree workspace is to run git worktree remove for each member repository systematically. This Skill automates that process, removing the workspace directory and all associated worktrees after requiring user confirmation.

Does this workspace cleanup tool delete files if repositories have pending changes?

No, this workspace cleanup tool does not delete files if repositories have pending changes. It includes safeguards that explicitly refuse to proceed with removing worktrees or the workspace directory when uncommitted changes are detected in any member repository.

How do I delete a GSD workspace directory and its associated worktrees?

To delete a GSD workspace directory and its associated worktrees, provide the workspace name and confirm the action. The Skill executes git worktree remove for each member repo and cleans up the workspace directory, surfacing a clear success message upon completion.

Why does git worktree remove fail when I try to clean up my workspace?

Git worktree remove can fail during workspace cleanup if repositories contain uncommitted changes. This Skill prevents this failure by checking for uncommitted changes beforehand and refusing to remove worktrees until those changes are committed or stashed.

Can I remove multiple git worktrees from a workspace at once?

Yes, you can remove multiple git worktrees from a workspace at once. This Skill handles workspaces using a git worktree strategy with multiple member repos, running the removal process for each repository and cleaning the workspace directory after user confirmation.