gsd-list-workspaces

Scan local GSD workspace directories for WORKSPACE.md manifests and summarize statuses.

Updated Feb 11, 2026
One-click install
npx skills add https://github.com/ArtRiv/game-topicos-especiais --skill gsd-list-workspaces-artriv
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gsd-list-workspaces
Source: https://github.com/ArtRiv/game-topicos-especiais/tree/main/.github/skills/gsd-list-workspaces
Command: npx skills add https://github.com/ArtRiv/game-topicos-especiais --skill gsd-list-workspaces-artriv

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Finding which GSD workspaces are active and what state they are in can be time-consuming, especially when many workspace directories exist locally.

Core Features & Use Cases

  • Workspace discovery via manifests: Scans ~/gsd-workspaces/ for workspace directories containing WORKSPACE.md.
  • Status reporting: Produces a summary table including workspace name, path, repository count, strategy, and the current GSD project status.
  • End-to-end workflow reuse: Runs the existing list-workspaces workflow to generate the output consistently.
  • Use case: As part of operational monitoring, quickly verify which workspaces are ready, failing, or require attention before starting related tasks.

Quick Start

Run the gsd-list-workspaces skill to scan your ~/gsd-workspaces/ folder and display a table of active workspaces with their statuses.

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 on my local filesystem?

To list active GSD workspaces, scan the ~/gsd-workspaces/ directory for folders containing WORKSPACE.md manifests. The skill executes the list-workspaces workflow to generate a summary table showing workspace name, path, repository count, strategy, and current project status.

What is a GSD workspace manifest and why is it needed for workspace discovery?

A GSD workspace manifest is a WORKSPACE.md file inside a workspace directory. It is required for workspace discovery because the local filesystem scan only identifies and reports active workspaces that contain this manifest file, using it to extract repo counts and strategy details.

Can I check the repository count and strategy for multiple GSD workspaces at once?

Yes, you can check repository counts and strategies for multiple workspaces by running the end-to-end list-workspaces workflow. It produces a deterministic summary table aggregating workspace name, path, repo count, strategy, and GSD project status for operational monitoring.

Does this workspace status reporting tool require any external dependencies?

No external dependencies are required for this workspace status reporting tool. It operates independently by scanning local workspace directories and requires only existing WORKSPACE.md manifests to produce the operational status summary table.

What's the best way to audit GSD workspace readiness before starting operational tasks?

The best way to audit GSD workspace readiness is to scan ~/gsd-workspaces/ for WORKSPACE.md manifests. This generates a status reporting table that quickly verifies which workspaces are ready, failing, or require attention before you start related tasks.

Why does my GSD workspace not show up in the workspace discovery scan?

Your GSD workspace does not appear in the workspace discovery scan because it lacks a WORKSPACE.md manifest file. The local filesystem scan strictly requires this manifest to identify active workspaces and extract repository counts, strategy, and project status.