gsd-list-workspaces

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

1|Updated Aug 17, 2025
One-click install
npx skills add https://github.com/DuySeu/StockMind --skill gsd-list-workspaces-duyseu
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gsd-list-workspaces
Source: https://github.com/DuySeu/StockMind/tree/main/.agent/skills/gsd-list-workspaces
Command: npx skills add https://github.com/DuySeu/StockMind --skill gsd-list-workspaces-duyseu

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Quickly identify all active GSD workspaces and understand their current status by scanning local workspace manifests, enabling faster governance and planning.

Core Features & Use Cases

  • Workspace discovery: Detects GSD workspaces under ~/gsd-workspaces and validates the presence of WORKSPACE.md manifests.
  • Status summary: Generates a concise table with each workspace's name, path, repository count, strategy, and overall GSD project status.
  • Use Case: An operator wants a one-shot inventory of all active workspaces to assess compliance with current GSD workflows and priorities.

Quick Start

Run the gsd-list-workspaces skill to scan ~/gsd-workspaces for WORKSPACE.md manifests and display a summary table.

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 status?

To list GSD workspaces and check their status, scan the ~/gsd-workspaces directory for WORKSPACE.md manifests. This generates a concise table showing each workspace's name, path, repository count, strategy, and project status.

What is a WORKSPACE.md manifest used for in GSD workspace scanning?

A WORKSPACE.md manifest is used to identify and validate an active GSD workspace during directory scanning. Its presence confirms the workspace is active and allows the system to extract metadata like repository count and project status.

How do I inventory local workspace manifests for governance and planning?

You can inventory local workspace manifests by scanning ~/gsd-workspaces for WORKSPACE.md files. This provides a one-shot summary of workspace names, paths, repo counts, and strategies to assess compliance with current workflows.

What happens if a WORKSPACE.md manifest is missing during workspace scanning?

If a WORKSPACE.md manifest is missing or paths are unavailable during workspace scanning, the system handles it gracefully by enforcing strict validation and returning a clear error message instead of failing silently.

What's the best way to get a summary table of GSD project statuses?

The best way to get a summary table of GSD project statuses is to run a scan of ~/gsd-workspaces. It detects all WORKSPACE.md manifests and outputs a concise table with names, paths, repo counts, and strategies.