qsd-list-workspaces

Scan ~/qsd-workspaces for WORKSPACE.md manifests and summarize workspace statuses.

Updated Apr 13, 2026
One-click install
npx skills add https://github.com/thecomputer07/qsd --skill qsd-list-workspaces
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: qsd-list-workspaces
Source: https://github.com/thecomputer07/qsd/tree/main/skills/qsd-list-workspaces
Command: npx skills add https://github.com/thecomputer07/qsd --skill qsd-list-workspaces

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Scan ~/qsd-workspaces/ for workspace directories containing WORKSPACE.md manifests and summarize their status to help admins manage multiple environments.

Core Features & Use Cases

  • Scans ~/qsd-workspaces for workspace manifests and builds a table with name, path, repo count, strategy, and overall project status.
  • Produces a concise snapshot suitable for dashboards and quick audits in local development contexts.
  • Use Case: An engineer runs the skill to verify all active workspaces before planning a migration or update.

Quick Start

Run the qsd-list-workspaces skill to generate a live status table of all workspaces.

Frequently Asked Questions about qsd-list-workspaces

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I list qsd workspaces and check their status at a glance?

To list qsd workspaces and check status, the skill scans the local `~/qsd-workspaces` directory for `WORKSPACE.md` manifests. It generates a summary table displaying each workspace's name, path, repo count, strategy, and overall project status.

How do I scan local filesystem directories for WORKSPACE.md manifests?

You can scan local directories for `WORKSPACE.md` manifests by running this skill against the `~/qsd-workspaces` path. It automatically reads the manifest files to compute and report workspace names, paths, repository counts, and deployment strategies.

What is the best way to audit multiple qsd project statuses before a migration?

The best way to audit qsd project statuses before a migration is to generate a live status table. This skill scans local workspace manifests to produce a concise snapshot of repo counts and strategies suitable for quick audits and dashboards.

Do I need specific dependencies to generate a workspace status report?

No specific dependencies are required to generate a workspace status report. The skill only requires access to the local filesystem to read `WORKSPACE.md` manifests located within the `~/qsd-workspaces` directory structure to compute project statuses.

Can I use this workspace scan for local development environments?

Yes, you can use this workspace scan for local development environments. It is specifically designed to help administrators and developers audit workspace statuses across local environments by reading local manifest files.

Why does my workspace scan not showing all expected qsd projects?

If your workspace scan is not showing expected qsd projects, ensure the missing projects contain a valid `WORKSPACE.md` manifest. The skill identifies active workspaces exclusively by scanning the `~/qsd-workspaces` directory for these manifest files.