gsd-remove-workspace

Remove a GSD workspace after confirming no member repo has uncommitted changes.

Updated Feb 11, 2026
One-click install
npx skills add https://github.com/ArtRiv/game-topicos-especiais --skill gsd-remove-workspace-artriv
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gsd-remove-workspace
Source: https://github.com/ArtRiv/game-topicos-especiais/tree/main/.github/skills/gsd-remove-workspace
Command: npx skills add https://github.com/ArtRiv/game-topicos-especiais --skill gsd-remove-workspace-artriv

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

You need to delete a GSD workspace and related git worktrees without leaving the repository in a broken or dirty state, especially when multiple member repos are involved.

Core Features & Use Cases

  • Workspace removal with confirmation: Removes the specified workspace directory only after user confirmation.
  • Worktree cleanup across member repos: For the worktree strategy, removes each member repo’s worktree using git worktree remove before deleting the workspace.
  • Guardrail against unsafe deletions: Refuses to proceed if any member repo has uncommitted changes.

Quick Start

Use gsd-remove-workspace and provide the workspace name you want removed so it can validate state and clean the related git 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 leaving the repository dirty?

You can safely remove a git worktree by executing `git worktree remove` for each member repository before deleting the workspace directory. This process requires prior confirmation and refuses to execute if any member repo contains uncommitted changes.

What happens if I try to delete a workspace with uncommitted changes in a member repo?

If a member repository has uncommitted changes, the workspace deletion is refused. This guardrail prevents unsafe deletions and ensures the repository is not left in a broken or dirty state during worktree cleanup.

How do I clean up multiple git worktrees across different repositories at once?

Cleaning up multiple git worktrees across member repositories requires a workspace removal tool that iterates through each member repo. It runs `git worktree remove` for each one and then deletes the main workspace directory after user confirmation.

When should I use a dedicated workspace removal tool instead of manual directory deletion?

You should use a dedicated workspace removal tool when managing multiple member repositories under a worktree strategy. Manual deletion leaves broken states, whereas a dedicated tool enforces safety checks, validates uncommitted changes, and properly cleans associated worktrees.

Does workspace deletion require confirmation before cleaning the worktrees?

Yes, workspace deletion requires explicit user confirmation before proceeding. Once confirmed, the process validates repository states, removes associated git worktrees for each member repo, and finally deletes the specified workspace directory.