gsd-list-workspaces

Scan ~/gsd-workspaces/ for WORKSPACE.md manifests and display a summary table.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Automatically identify and summarize the status of all GSD workspaces by discovering local workspace manifests and aggregating their metadata to inform teams.

Core Features & Use Cases

  • Scan ~/gsd-workspaces/ for WORKSPACE.md manifests and extract workspace name, path, repo count, strategy, and status.
  • Generate a concise summary table suitable for dashboards or quick health checks.
  • Use case: team leads and developers gain a real-time view of active workspaces to prioritize work.

Quick Start

Run the list-workspaces workflow to display all active GSD workspaces and 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 active GSD workspaces and monitor their status?

To list active GSD workspaces, scan the ~/gsd-workspaces/ directory for WORKSPACE.md manifests and aggregate metadata into a summary table displaying name, path, repo count, strategy, and status.

What is a GSD workspace manifest and how does it track project health?

A GSD workspace manifest is a WORKSPACE.md file containing project metadata. Reading these manifests allows you to aggregate workspace name, repo count, and strategy to enable quick health checks and monitoring.

Does listing GSD workspaces require any external dependencies?

Listing GSD workspaces requires no external dependencies. It operates by scanning the local ~/gsd-workspaces/ directory structure to discover and read existing WORKSPACE.md files.

What's the best way to generate a dashboard summary of local workspace directories?

The best way to generate a dashboard summary of local workspace directories is to scan ~/gsd-workspaces/ for WORKSPACE.md manifests and extract metadata into a concise table showing project status and repo count.

Why is my GSD workspace not showing up in the summary table?

A GSD workspace might not appear in the summary table if its directory is missing a valid WORKSPACE.md manifest, or if the directory is not located within the expected ~/gsd-workspaces/ scan path.