gsd-list-workspaces

Scan GSD workspace manifests and summarize status in a table.

Updated Aug 15, 2025
One-click install
npx skills add https://github.com/gesmith0606/nfl_data_engineering --skill gsd-list-workspaces-gesmith0606
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gsd-list-workspaces
Source: https://github.com/gesmith0606/nfl_data_engineering/tree/main/.claude/skills/gsd-list-workspaces
Command: npx skills add https://github.com/gesmith0606/nfl_data_engineering --skill gsd-list-workspaces-gesmith0606

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Automatically inventories GSD workspaces and their status, saving time and ensuring visibility into active projects.

Core Features & Use Cases

  • Scans ~/gsd-workspaces/ for workspace manifests containing WORKSPACE.md
  • Compiles a summary table with name, path, repo count, strategy, and project status
  • Supports quick filtering by status and generates a compact report for leadership reviews

Quick Start

Run the list-workspaces workflow to generate the current workspace summary.

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 workspaces and summarize their project status?

To list active workspaces and summarize project status, run the list-workspaces workflow. It scans local directories under ~/gsd-workspaces for WORKSPACE.md manifests and renders a summary table with name, path, repo count, strategy, and status.

What information is included in a workspace inventory summary table?

A workspace inventory summary table includes the workspace name, directory path, repository count, defined strategy, and overall project status. It aggregates this data by scanning WORKSPACE.md manifests to provide a quick review of active projects.

How do I generate a quick report of local project directories for a leadership review?

You can generate a compact report for leadership reviews by running the list-workspaces workflow. It automatically inventories active GSD workspaces and outputs an aggregated summary table of project statuses and repository counts.

Do I need a specific manifest file to inventory my project directories?

Yes, you need a WORKSPACE.md manifest file in each project directory. The inventory workflow scans local directories under ~/gsd-workspaces to detect these manifests and aggregate workspace status.

Can I filter my workspace inventory summary by project status?

Yes, the workspace inventory workflow supports quick filtering by project status. It scans WORKSPACE.md manifests and compiles a summary table that can be filtered for rapid review of active projects.

What is the best way to automate visibility into active local project workspaces?

The best way to automate visibility into active local workspaces is running the list-workspaces workflow. It scans ~/gsd-workspaces for manifests, counts repositories, and renders an aggregated summary table to ensure project status visibility.