gsd-list-workspaces

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

264|11|Updated Apr 25, 2026
One-click install
npx skills add https://github.com/coco-research/coco --skill gsd-list-workspaces-coco-research
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gsd-list-workspaces
Source: https://github.com/coco-research/coco/tree/main/systems/gsd/skills/gsd-list-workspaces
Command: npx skills add https://github.com/coco-research/coco --skill gsd-list-workspaces-coco-research

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It helps you quickly identify active GSD workspaces and understand their current status without manually checking each directory.

Core Features & Use Cases

  • Workspace Discovery: Scans ~/gsd-workspaces/ for directories that contain WORKSPACE.md manifests.
  • Status Summary: Produces a concise table with workspace name, path, repository count, strategy, and GSD project status.
  • Use Case: Use it when you need a fast operational snapshot of multiple workspaces before planning work or reviewing progress.

Quick Start

Ask the skill to list active GSD workspaces and summarize their name, path, repo count, strategy, and 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 active GSD workspaces and get a status summary?

To list active GSD workspaces, scan the ~/gsd-workspaces/ directory for folders containing WORKSPACE.md manifests. This generates a summary table with workspace name, path, repo count, strategy, and project status.

What is the best way to audit multiple workspace manifests without checking each directory?

Auditing multiple workspace manifests is done by scanning the ~/gsd-workspaces/ directory for WORKSPACE.md files. It returns a concise table summarizing workspace name, path, repository count, strategy, and current GSD project status.

How does workspace discovery find active GSD projects?

Workspace discovery finds active GSD projects by scanning the ~/gsd-workspaces/ path. It identifies directories that contain a WORKSPACE.md manifest and extracts metadata to produce a summary of active workspaces.

Do I need a specific directory structure to list GSD workspaces?

You need a specific directory structure to list GSD workspaces: directories must be located within ~/gsd-workspaces/ and contain a WORKSPACE.md manifest file to be recognized and summarized by the scan.

Can I use this workspace summary for planning and coordination tasks?

You can use this workspace summary for planning and coordination tasks. It provides a fast operational snapshot by returning the workspace name, path, repo count, strategy, and GSD project status for active directories.

What metadata is returned when summarizing GSD workspaces?

When summarizing GSD workspaces, the metadata returned includes the workspace name, directory path, repository count, strategy, and the current GSD project status, all presented in a concise summary table format.