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.