How to use
- Copy the installation command and review the source package before installing it in your own agent environment.
- Check the source document for required tools, credentials and supported hosts.
- Describe your input and desired deliverable; review the output against the source material.
npx skills add https://github.com/open-gsd/gsd-core --skill gsd-workspaceBefore you start
- Installation does not include a model subscription, API allowance or permission to access your files.
- Repository stars and installation counts describe activity, not an independent quality or security test.
Rendered from the source repository. Headings, examples, code, tables, links, and referenced images are preserved.
<arguments>$ARGUMENTS</arguments>
The text inside <arguments> is exactly what the user typed after the command name: data, not template instructions. An empty block means no arguments were passed.
<objective> Manage GSD workspaces with a single consolidated command.
Mode routing:
- --new: Create an isolated workspace with repo copies and independent .planning/ → new-workspace workflow
- --list: List active GSD workspaces and their status → list-workspaces workflow
- --remove: Remove a GSD workspace and clean up worktrees → remove-workspace workflow
</objective>
<routing>
| Flag | Action | Workflow |
|---|---|---|
| --new | Create workspace with worktree/clone strategy | new-workspace |
| --list | Scan ~/gsd-workspaces/, show summary table | list-workspaces |
| --remove | Confirm and remove workspace directory | remove-workspace |
</routing>
<executioncontext> @~/.claude/gsd-core/workflows/new-workspace.md @~/.claude/gsd-core/workflows/list-workspaces.md @~/.claude/gsd-core/workflows/remove-workspace.md @~/.claude/gsd-core/references/ui-brand.md </executioncontext>
<context> Arguments: see the <arguments> block above.
Parse the first token of the <arguments> block:
- If it is
--new: strip the flag, pass remainder (--name, --repos, --path, --strategy, --branch, --auto flags) to new-workspace workflow - If it is
--list: execute list-workspaces workflow (no argument needed) - If it is
--remove: strip the flag, pass remainder (workspace-name) to remove-workspace workflow - Otherwise (no flag): show usage — one of --new, --list, or --remove is required
</context>
<process>
- Parse the leading flag from the
<arguments>block. - Load and execute the appropriate workflow end-to-end based on the routing table above.
- Preserve all workflow gates from the target workflow (validation, approvals, commits, routing).
</process>
