gsd-workstreams
Manage parallel workstreams — list, create, switch, status, progress, complete, and resume
How do I install this agent skill?
npx skills add https://github.com/open-gsd/gsd-core --skill gsd-workstreamsIs this agent skill safe to install?
- Gen Agent Trust Hubpass
The skill manages parallel workstreams by executing the gsd-tools CLI via Bash. It interpolates user-supplied input into shell commands, which presents a potential command injection surface.
- Socketpass
No alerts
- Snykpass
Risk: LOW · No issues
What does this agent skill do?
/gsd-workstreams
Manage parallel workstreams for concurrent milestone work.
Usage
/gsd-workstreams [subcommand] [args]
Subcommands
| Command | Description |
|---|---|
list | List all workstreams with status |
create <name> | Create a new workstream |
status <name> | Detailed status for one workstream |
switch <name> | Set active workstream |
progress | Progress summary across all workstreams |
complete <name> | Archive a completed workstream |
resume <name> | Resume work in a workstream |
Step 1: Parse Subcommand
Parse the user's input to determine which workstream operation to perform.
If no subcommand given, default to list.
Step 2: Execute Operation
list
Run: gsd_run query workstream.list --raw --cwd "$CWD"
Display the workstreams in a table format showing name, status, current phase, and progress.
create
Run: gsd_run query workstream.create <name> --raw --cwd "$CWD"
After creation, display the new workstream path and suggest next steps:
/gsd-new-milestone --ws <name>to set up the milestone
status
Run: gsd_run query workstream.status <name> --raw --cwd "$CWD"
Display detailed phase breakdown and state information.
switch
Run: gsd_run query workstream.set <name> --raw --cwd "$CWD"
Also set GSD_WORKSTREAM for the current session when the runtime supports it.
If the runtime exposes a session identifier, GSD also stores the active workstream
session-locally so concurrent sessions do not overwrite each other.
progress
Run: gsd_run query workstream.progress --raw --cwd "$CWD"
Display a progress overview across all workstreams.
complete
Run: gsd_run query workstream.complete <name> --raw --cwd "$CWD"
Archive the workstream to milestones/.
resume
Set the workstream as active and suggest /gsd-resume-work --ws <name>.
Step 3: Display Results
Format the JSON output from gsd-tools query into a human-readable display.
Include the ${GSD_WS} flag in any routing suggestions.
How can the creator link this skill?
Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.
<a href="https://skillzs.dev/skills/open-gsd/gsd-core/gsd-workstreams">View gsd-workstreams on skillZs</a>