Claude opencode Skill

beads

Use when working in a repository that uses bd or Beads for durable project task tracking, issue dependencies, blocker management, multi-session handoff, or shared work memory. Trigger when the user asks to find ready work, claim or close tasks, create follow-up work, inspect bloc

LLM Mart · 0 points · 0 17 0

Virus-scanned Reviewed automatically before listing.

Full trust report

Download paseo-cafe-paseo-cafe-.agents_skills_beads-cc83f83.zip · 1 KB

paseo-cafe/paseo-cafe 26 28 forks Apache-2.0 Updated 5d ago

Install

skills CLI npx skills add https://github.com/paseo-cafe/paseo-cafe/tree/main/.agents/skills/beads

Claude Code claude plugin marketplace add https://llmmart.ai/marketplace.json && claude plugin install paseo-cafe-paseo-cafe@llmmart

Git git clone https://github.com/paseo-cafe/paseo-cafe.git

The skills CLI installs just this skill, for any of its supported agents. Claude Code installs the whole paseo-cafe/paseo-cafe collection as a plugin from our marketplace. Git is the plain clone.

Skill manifest

Beads

Use Beads as the shared project task system. Local plans, scratch files, and personal memories are useful, but they are not the durable source of truth for project work.

First Step

Run:

bd prime

If that prints nothing, check whether the repository has an active Beads workspace:

bd where

Preferred Route

Use the bd CLI when shell access is available. It is the most compact and direct Beads interface.

Core CLI Workflow

Find work:

bd ready
bd list --status=open
bd list --status=in_progress

Inspect before editing:

bd show <id>

Claim work atomically:

bd update <id> --claim

Create durable follow-up work when implementation reveals new tasks:

bd create "Short title" --description="Why this exists and what needs to be done" --type=task --priority=2

Close completed work:

bd close <id> --reason="Completed"

What Belongs In Beads

Use Beads for:

shared project tasks
blockers and dependencies
discovered follow-up work
work that must survive thread reset, compaction, or handoff
status that another person or agent should be able to resume

Use agent-local planning tools only for the current turn's execution checklist. Do not treat them as shared project state.

Rules

Do not create markdown TODO files as the source of truth when Beads is available.
Do not use bd edit; it opens an interactive editor. Use bd update flags instead.
Prefer --json when parsing bd output programmatically.
If hooks are installed, bd prime may already be injected. Run it manually when context is missing.
Do not auto-close or mutate tasks unless the work is actually complete.

Files (paseo-cafe)

agents

openai.yaml 175 B

interface:
  display_name: "Beads"
  short_description: "Project task tracking with bd"
  default_prompt: "Use $beads to inspect ready work and manage durable project tasks."

SKILL.md 2.1 KB

---
name: beads
description: Use when working in a repository that uses bd or Beads for durable project task tracking, issue dependencies, blocker management, multi-session handoff, or shared work memory. Trigger when the user asks to find ready work, claim or close tasks, create follow-up work, inspect blockers, recover project context, or choose between local planning and persistent project tracking.
---

# Beads

Use Beads as the shared project task system. Local plans, scratch files, and personal memories are useful, but they are not the durable source of truth for project work.

## First Step

Run:

```bash
bd prime
```

If that prints nothing, check whether the repository has an active Beads workspace:

```bash
bd where
```

## Preferred Route

Use the `bd` CLI when shell access is available. It is the most compact and direct Beads interface.

## Core CLI Workflow

1. Find work:

```bash
bd ready
bd list --status=open
bd list --status=in_progress
```

2. Inspect before editing:

```bash
bd show <id>
```

3. Claim work atomically:

```bash
bd update <id> --claim
```

4. Create durable follow-up work when implementation reveals new tasks:

```bash
bd create "Short title" --description="Why this exists and what needs to be done" --type=task --priority=2
```

5. Close completed work:

```bash
bd close <id> --reason="Completed"
```

## What Belongs In Beads

Use Beads for:

- shared project tasks
- blockers and dependencies
- discovered follow-up work
- work that must survive thread reset, compaction, or handoff
- status that another person or agent should be able to resume

Use agent-local planning tools only for the current turn's execution checklist. Do not treat them as shared project state.

## Rules

- Do not create markdown TODO files as the source of truth when Beads is available.
- Do not use `bd edit`; it opens an interactive editor. Use `bd update` flags instead.
- Prefer `--json` when parsing `bd` output programmatically.
- If hooks are installed, `bd prime` may already be injected. Run it manually when context is missing.
- Do not auto-close or mutate tasks unless the work is actually complete.