gsd-remove-workspace

Remove GSD workspace directories and git worktrees after confirming no uncommitted changes.

Updated Aug 15, 2025
One-click install
npx skills add https://github.com/gesmith0606/nfl_data_engineering --skill gsd-remove-workspace-gesmith0606
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gsd-remove-workspace
Source: https://github.com/gesmith0606/nfl_data_engineering/tree/main/.claude/skills/gsd-remove-workspace
Command: npx skills add https://github.com/gesmith0606/nfl_data_engineering --skill gsd-remove-workspace-gesmith0606

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps safely delete a Get-Shit-Done (GSD) workspace while ensuring associated git worktrees are cleaned up and local changes are not accidentally lost.

Core Features & Use Cases

  • Confirmation and safety checks: Prompts for explicit confirmation before deleting workspace files and refuses to proceed if repositories contain uncommitted changes.
  • Worktree-aware cleanup: Iterates member repositories and runs git worktree remove for each worktree to avoid leaving dangling worktrees.
  • Use Case: Remove a stale or corrupted local workspace that spans multiple git repositories before recreating it or reclaiming disk space.

Quick Start

Use the gsd-remove-workspace skill to remove the workspace named myproject after confirming all member repositories have no uncommitted changes.

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, the Skill checks for uncommitted changes across all member repositories and refuses to proceed if any are found, ensuring local changes are not accidentally lost during workspace cleanup.

What is the best way to clean up multiple git worktrees in a local workspace?

The best way to clean up multiple git worktrees is to iterate through each member repository and run git worktree remove individually, preventing dangling worktrees while prompting for explicit confirmation before deleting workspace files.

How do I delete a stale local workspace that spans multiple git repositories?

To delete a stale local workspace spanning multiple git repositories, the Skill performs confirmation prompts, verifies no uncommitted changes exist, and executes git worktree remove for each member repository to reclaim disk space.

Does the workspace cleanup process stop if a repository has uncommitted changes?

Yes, the workspace cleanup process refuses to proceed if any member repository contains uncommitted changes, acting as a safety check to prevent accidental data loss before removing workspace directories and git worktrees.

When should I use a worktree-aware cleanup script instead of manually deleting directories?

You should use a worktree-aware cleanup script when preparing to delete or recreate a workspace that uses the git worktree strategy across multiple repositories, as manual deletion often leaves dangling worktrees that require additional git maintenance.