/gsd-workstreams
SkillDev toolsThe gsd-workstreams skill is a tool for managing parallel workstreams while working with an AI agent. It lets the agent list, create, switch, check status, track progress, complete, and resume workstreams, so you can juggle several tasks at once. It runs gsd-tools queries through Bash and formats the JSON results into readable tables showing names, statuses, phases, and progress.
Then ask your AI: use the /gsd-workstreams skill
Details
Instructions available. Your AI can read the instructions. Execution depends on the setup they require.
Account requirements not reviewed. Check the skill instructions before use; Ahel provides instructions and does not run this skill.
No other account needed.
Make sure the gsd-tools command is available in your environment.
What your AI can do with it
- List all workstreams with their status, current phase, and progress
- Create a new workstream by name
- Switch the active workstream for the current session
- Show detailed status for one workstream
- Show a progress summary across all workstreams
- Complete and archive a workstream to the milestones folder
Getting started
- Make sure the gsd-tools command is available in your environment.
- Add the skill to your agent so it can run gsd-tools queries through Bash.
- Ask the agent to list workstreams to see what already exists.
- Create a workstream by name, then switch to it to make it active.
- Use status or progress to check where each workstream stands.
What this skill tells your AI
The instructions your AI receives, as published by open-gsd/gsd-core in skills/gsd-workstreams/SKILL.md and read by Ahel’s review.
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.
Signals
- GitHub stars
- 10k
- Forks
- 741
- Last commit
- Oct 2026
Questions
- How do I create a new workstream?
- Ask the agent to create a workstream with a name. It runs the create query and then shows the new workstream path, suggesting you set up the milestone next.
- How do I switch between workstreams?
- Ask the agent to switch to a named workstream. It sets that workstream as active for the session, and when the runtime supports it, also sets GSD_WORKSTREAM.
- What happens when I complete a workstream?
- Completing a workstream archives it to the milestones folder. The agent runs the complete query and reports the result.
- Can I see progress across all workstreams at once?
- Yes. The progress subcommand shows a progress overview across all workstreams, formatted as a readable table.
Advanced
- Item type
- skill
- Key
gsd-workstreams-open-gsd- Source
- github.com/open-gsd/gsd-core