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.