gsd-list-workspaces

Scan ~/gsd-workspaces for WORKSPACE.md manifests and summarize workspace status.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Finding and summarizing multiple local GSD workspaces is tedious and error-prone when done manually, especially across many projects. This Skill automates discovery and presents a concise status summary to speed audits and planning.

Core Features & Use Cases

  • Workspace Discovery: Scans the ~/gsd-workspaces/ directory for workspace folders that contain WORKSPACE.md manifests.
  • Metadata Extraction & Summary: Collects workspace name, path, repository count, declared strategy, and GSD project status and shows them in a compact table.
  • Use Cases: Quickly audit workspace health before a milestone, onboard teammates by listing available workspaces, or verify repository counts and strategies across projects.

Quick Start

Run the gsd-list-workspaces skill to scan the ~/gsd-workspaces directory and return a summary table with each workspace's name, path, repository count, strategy, and GSD project 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 active GSD workspaces and check their project status?▼

List GSD workspaces by scanning the ~/gsd-workspaces directory for folders containing a WORKSPACE.md manifest, then extract repository counts, declared strategy, and status fields to present a summary table of all active projects.

What is a GSD workspace manifest and what metadata does it contain?▼

A GSD workspace manifest is a WORKSPACE.md file stored in each workspace directory under ~/gsd-workspaces, containing metadata fields for workspace name, path, repository count, declared strategy, and current GSD project status.

How do I audit repository counts and strategies across multiple local GSD projects?▼

Audit multiple GSD projects by running an automated scan of the ~/gsd-workspaces directory, which discovers each workspace folder, counts repositories inside, extracts strategy assignments, and compiles them into a concise table for review.

Can I use this workspace listing approach for onboarding teammates to local GSD setups?▼

Yes, scanning local GSD setups under ~/gsd-workspaces generates a concise summary table with workspace names, paths, repository counts, and strategies, giving teammates a quick overview of all available workspaces for onboarding.

What is the best way to get a quick overview of workspace health before a milestone?▼

Get a quick workspace health overview by scanning the ~/gsd-workspaces directory to extract and summarize each workspace's repository count, declared strategy, and GSD project status into a compact table for milestone planning.

Does this workspace discovery method require any external dependencies or tools?▼

No external dependencies are required for workspace discovery. The scan operates directly on the local filesystem under ~/gsd-workspaces, reading WORKSPACE.md manifests to extract and summarize workspace metadata without additional tooling.