gsd-list-workspaces

Lists GSD workspaces and displays their status in a summary table.

Updated Feb 18, 2026
One-click install
npx skills add https://github.com/jjchambers80/judgesdirectory --skill gsd-list-workspaces-jjchambers80
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: gsd-list-workspaces
Source: https://github.com/jjchambers80/judgesdirectory/tree/main/.github/skills/gsd-list-workspaces
Command: npx skills add https://github.com/jjchambers80/judgesdirectory --skill gsd-list-workspaces-jjchambers80

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Developers managing multiple GSD workspaces lack a quick way to see which workspaces exist, where they live, and what state each project is in without manually inspecting each directory. ## Core Features & Use Cases - Workspace Discovery: Scans ~/gsd-workspaces/ for directories containing WORKSPACE.md manifest files. - Status Summary Table: Displays each workspace's name, path, repository count, strategy, and GSD project status in one view. - Use Case: Before starting a work session, run this Skill to see all active GSD workspaces at a glance and decide which project to resume based on its current status. ## Quick Start Ask the assistant to list all active GSD workspaces and show their current status. ## Quick Start List all my GSD workspaces and show their status.

Frequently Asked Questions about gsd-list-workspaces

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I list all GSD workspaces on my machine?▼

Invoke the gsd-list-workspaces skill, which scans ~/gsd-workspaces/ for directories containing WORKSPACE.md manifests. It outputs a summary table with each workspace's name, path, repo count, strategy, and GSD project status.

What information does the GSD workspace summary table show?▼

The summary table shows five fields per workspace: name, filesystem path, repository count, strategy, and current GSD project status. The data is read from each workspace's WORKSPACE.md manifest file.

Where does the skill look for GSD workspaces?▼

It scans the ~/gsd-workspaces/ directory in the user's home folder. Only subdirectories containing a WORKSPACE.md manifest file are recognized as valid workspaces and included in the output.

Why is my workspace missing from the GSD workspace list?▼

A workspace is skipped if its directory is not located under ~/gsd-workspaces/ or if it lacks a WORKSPACE.md manifest file. Verify the workspace location and confirm the manifest exists at the workspace root.

What permissions does the gsd-list-workspaces skill need?▼

The skill declares Bash and Read as its allowed tools. It uses them to scan the workspaces directory and read WORKSPACE.md manifests; it does not modify any files.