gsd-list-workspaces

Scan local directories for GSD workspace manifests and generate status reports.

1|Updated Apr 4, 2026
One-click install
npx skills add https://github.com/nnexai/git-stacks --skill gsd-list-workspaces-nnexai
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gsd-list-workspaces
Source: https://github.com/nnexai/git-stacks/tree/main/.github/skills/gsd-list-workspaces
Command: npx skills add https://github.com/nnexai/git-stacks --skill gsd-list-workspaces-nnexai

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill solves the visibility gap in managing multiple task-scoped workspaces, allowing you to quickly audit the status and configuration of your active projects without manual file inspection.

Core Features & Use Cases

  • Workspace Inventory: Automatically scans the designated directory to identify all active workspaces.
  • Status Reporting: Aggregates key metadata including path, repository count, and project strategy into a clean, readable summary.
  • Use Case: When juggling multiple feature branches or tickets, use this to verify which workspaces are currently active and confirm their configuration status before switching contexts.

Quick Start

Ask the assistant to list all active GSD workspaces to see a summary of your current project environment.

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

You can audit active workspaces by scanning local directories for GSD workspace manifests. The generated status report aggregates the path, repository count, and operational strategy for each active project.

What is a GSD workspace manifest and how does it help with project management?

A GSD workspace manifest is a WORKSPACE.md file defining a task-scoped environment. Parsing these files aggregates project metadata into a comprehensive summary, solving the visibility gap when managing multiple workspaces.

How do I audit multiple task-scoped workspaces without manual file inspection?

You can audit multiple task-scoped workspaces automatically by scanning your local directories. This parses WORKSPACE.md files to produce a clean, readable summary of your current project environment.

Does this workspace inventory tool require filesystem access to parse manifests?

Yes, generating a workspace inventory requires access to the local filesystem. This access is necessary to parse WORKSPACE.md files and display the formatted output containing your project metadata.

When should I use a workspace status report for my projects?

You should use a workspace status report when juggling multiple feature branches or tickets. It allows you to verify which workspaces are currently active and confirm their configuration status before switching contexts.