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.