gsd-list-workspaces

Scans ~/gsd-workspaces/ for WORKSPACE.md manifests and summarizes active GSD workspaces in a table format.

1|Updated Apr 7, 2026
One-click install
npx skills add https://github.com/TruCol270/salty-pickle --skill gsd-list-workspaces-trucol270
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gsd-list-workspaces
Source: https://github.com/TruCol270/salty-pickle/tree/main/.claude-skills/gsd-list-workspaces
Command: npx skills add https://github.com/TruCol270/salty-pickle --skill gsd-list-workspaces-trucol270

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Scan and summarize GSD workspaces to reveal their current status and configuration, saving time on project visibility.

Core Features & Use Cases

  • Scan ~/gsd-workspaces/ for workspace manifests (WORKSPACE.md) to identify active workspaces.
  • Generate a concise table with name, path, repo count, strategy, and GSD project status for quick governance.
  • Use cases include project audits, progress tracking, and readiness checks before launches.

Quick Start

Run the list-workspaces workflow to scan the workspace directory and render 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 their current project statuses?

To list active GSD workspaces, scan the ~/gsd-workspaces/ directory for WORKSPACE.md manifests. This generates a compact summary table showing each workspace's name, path, repo count, strategy, and overall project status.

What is a WORKSPACE.md manifest used for in GSD project tracking?

A WORKSPACE.md manifest identifies an active GSD workspace directory. Scanning for these files allows you to extract workspace metadata, including repo count and strategy, for project audits and readiness checks.

How do I scan ~/gsd-workspaces/ to generate a summary table of workspace configurations?

Run the list-workspaces workflow to deterministically scan ~/gsd-workspaces/ using standard shell tooling. It produces a query-friendly configuration table of names, paths, and statuses, tolerating missing values.

Does the GSD workspace summary work if the WORKSPACE.md manifest is missing required values?

Yes, the GSD workspace summary is tolerant of missing values. The implementation relies on standard shell tooling to deterministically scan directories and render summaries without failing on incomplete manifests.

Can I use standard shell tooling to scan GSD workspaces for progress tracking?

Yes, you can use standard shell tooling to scan GSD workspaces. The process relies on reproducible shell commands to identify WORKSPACE.md files and output a compact progress tracking summary.