Skill389 repo starsupdated today

beads

The beads skill enables Codex agents to manage work through a native issue-tracking system using the `br` CLI. Agents discover unblocked tasks via `br ready`, claim issues with `br update --claim`, and close completed work via `br close`, while orchestrators coordinate multi-agent execution by embedding issue IDs in spawn prompts. Use this when implementing distributed task workflows where Codex agents need lightweight issue management with built-in dependency tracking.

View source Repository: agentops

Install in Claude Code

Copy

git clone --depth 1 https://github.com/boshu2/agentops /tmp/beads && cp -r /tmp/beads/skills-codex-overrides/beads ~/.claude/skills/beads

Then start a new Claude Code session; the skill loads automatically.

Definition

SKILL.md

# $beads — Issue Tracking (Codex Tailoring)

This override captures the Codex-native execution model for beads-based issue tracking.

## Key Distinction

Codex agents use `br` CLI directly for issue management. There is no task-queue abstraction — agents read issues via `br ready`, claim via `br update --claim`, and close via `br close`. The orchestrator assigns work to sub-agents by including the issue ID in the spawn prompt.

## Codex-Native Flow

### Finding Work

```bash
br ready                    # unblocked issues
br list --status=open       # all open
br show <id>                # details + dependencies
```

### Creating Issues

```bash
br create --title="<title>" --description="<desc>" --type=task --priority=2
br dep add <child> <parent>  # child depends on parent
```

### Working Issues

1. `br update <id> --claim` — claim before starting
2. Implement the work
3. `br close <id>` — mark complete after verification

### Multi-Agent Coordination

When spawning workers via `spawn_agent(...)`, include the issue ID in the prompt:

```
spawn_agent(prompt="Implement issue <id>: <title>. Details: <description>. Files: <file-list>.")
```

Workers close their own issues after verification. The orchestrator validates via `br list --status=open` after `wait_agent(...)` returns.

## Constraints

1. Always use `br` CLI — never track issues in markdown files or inline state.
2. One issue per worker. If a worker needs to split work, it creates child issues with `br create` + `br dep add`.
3. Workers must `br close` their issue only after the acceptance criteria pass.