# Gc Work

> Gc 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)

- Skill name: `gc-work`
- Category: [Productivity](https://www.openparable.com/skill/productivity/1)
- Source: https://github.com/gastownhall/gascity/blob/HEAD/internal/bootstrap/packs/core/skills/gc-work/SKILL.md
- Repository: gastownhall/gascity (995 GitHub stars when collected)

## SKILL.md

# 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
```

---

Source: https://www.openparable.com/skill/productivity/gc-work (OpenParable). Cite the canonical URL above.
