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.