gsd-remove-workspace

Remove GSD workspace directories and clean up git worktrees.

1|Updated Apr 4, 2026
One-click install
npx skills add https://github.com/nnexai/git-stacks --skill gsd-remove-workspace-nnexai
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gsd-remove-workspace
Source: https://github.com/nnexai/git-stacks/tree/main/.github/skills/gsd-remove-workspace
Command: npx skills add https://github.com/nnexai/git-stacks --skill gsd-remove-workspace-nnexai

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill solves the challenge of manually cleaning up complex multi-repo workspaces, ensuring that git worktrees are properly removed and local environments remain consistent.

Core Features & Use Cases

  • Automated Cleanup: Orchestrates the removal of workspace directories and associated git worktrees.
  • Safety Checks: Prevents accidental data loss by refusing to remove workspaces that contain uncommitted changes.
  • Use Case: When a feature branch is merged and the task is complete, use this skill to instantly purge the isolated workspace and restore your local file system state.

Quick Start

Invoke the gsd-remove-workspace skill by providing the name of the workspace you wish to delete.

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 and clean up the workspace directory?

To safely remove a git worktree, use an automated cleanup skill that validates repository states for uncommitted changes before deleting the workspace directory and executing git worktree removal commands to prevent data loss.

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

When deleting a workspace with uncommitted changes, the removal process performs safety checks and refuses to purge the isolated workspace, preventing accidental data loss by ensuring local environments remain consistent.

How do I clean up task-scoped workspaces after merging a feature branch?

To clean up task-scoped workspaces after a feature branch merges, invoke the automated cleanup process by providing the workspace name to instantly purge the isolated workspace and restore your local file system state.

Can I automate multi-repo worktree cleanup to keep my local environment consistent?

Yes, you can automate multi-repo worktree cleanup by orchestrating the removal of workspace directories and associated git worktrees, solving the challenge of manually cleaning complex environments to ensure local consistency.

What is the best way to delete a git-stacks workspace without losing data?

The best way to delete a git-stacks workspace without losing data is using a cleanup tool that validates repository states and blocks deletion of workspaces containing uncommitted changes before executing removal commands.

Why does manual git worktree cleanup fail to maintain environment hygiene?

Manual git worktree cleanup often fails to maintain environment hygiene because it lacks automated safety checks for uncommitted changes and does not orchestrate complete removal of task-scoped workspace directories and associated worktrees.