Gc Work
Productivitygc-workGc Work is an Agent Skill for productivity published in the gastownhall/gascity repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.
Finding, creating, claiming, and closing work items (beads)
How to use this skill
Bring this guide into your coding agent with a prompt tailored to the tool you use.
- Open your project in Codex.
- Copy and paste the prompt below.
- Review files and risks before approving any action.
Inspect the Agent Skill at https://github.com/gastownhall/gascity/blob/HEAD/internal/bootstrap/packs/core/skills/gc-work/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/gc-work, but wait for my approval before writing files or running scripts.
Copying this prompt does not install or run the skill. Review third-party files before use.
Work Items (Beads)
Everything in Gas City is a bead — tasks, messages, molecules, convoys.
The gc bd CLI is the primary interface for bead CRUD.
Rig-scoped beads
Each rig has its own .beads/ database with its own ID prefix (e.g.
fe- for frontend, be- for beads). A bead must live in the
same database as the agent that will work on it. When you sling a bead
to a rig-scoped agent, sling operates on the agent's rig database — so
the bead must already exist there. The bead ID prefix tells you which
rig it belongs to.
Use gc rig list to see rig names, paths, and prefixes.
Creating work
Use --rig to create beads in the right database. If the work will
be dispatched to a rig-scoped agent, create the bead in that agent's rig:
gc bd create "title" --rig frontend # Create in frontend's db (fe- prefix)
gc bd create "title" --rig beads # Create in beads db (be- prefix)
gc bd create "title" # Create in current directory's .beads/
gc bd create "title" -t bug # Create with type
gc bd create "title" --label priority=high # Create with labels
Finding work
gc bd list # List beads in current .beads/
gc bd list --rig <rigname> # List beads in a specific rig
gc bd ready # List beads available for claiming
gc bd ready --label role:worker # Filter by label
gc bd show <id> # Show bead details
Claiming and updating
gc bd update <id> --claim # Claim a bead (sets assignee + in_progress)
gc bd update <id> --status in_progress # Update status
gc bd update <id> --label <key>=<value> # Add/update labels
gc bd update <id> --note "progress..." # Add a note
Closing work
gc bd close <id> # Close a completed bead
gc bd close <id> --reason "done" # Close with reason
Hooks
gc hook show <agent> # Show what's on an agent's hook
gc agent claim <agent> <id> # Put a bead on an agent's hook