Agent skill

using-beads-bv

Use when coordinating dependency-aware task planning with beads (bd) CLI and bv graph sidecar - covers ready work selection, priority management, and robot flags for deterministic outputs

View SKILL.md on GitHub Repository
Stars 232
Forks 15

Install this agent skill to your Project

npx add-skill https://github.com/aiskillstore/marketplace/tree/main/skills/agentworkforce/using-beads-bv

SKILL.md

Using Beads and bv

Overview

Beads provides a lightweight, dependency-aware issue database. The bd CLI manages tasks, while bv provides graph metrics and execution planning.

Project: steveyegge/beads

When to Use

  • Coordinating multi-agent work with dependencies
  • Finding ready work (no blockers)
  • Priority management and task sequencing
  • Understanding project graph metrics

Don't use: Simple single-session tasks (use TodoWrite instead).

Quick Reference

Command Description
bd ready Show issues ready to work (no blockers)
bd list --status=open All open issues
bd list --status=in_progress Active work
bd show <id> Issue details with dependencies
bd create --title="..." --type=task Create new issue
bd update <id> --status=in_progress Claim work
bd close <id> Mark complete

bv Robot Flags (AI Sidecar)

CRITICAL: Always use --robot-* flags. The interactive TUI will block your session!

bash
bv --robot-help          # All AI-facing commands
bv --robot-insights      # JSON graph metrics (PageRank, critical path, cycles)
bv --robot-plan          # JSON execution plan with parallel tracks
bv --robot-priority      # Priority recommendations with reasoning
bv --robot-recipes       # List available recipes
bv --robot-diff --diff-since <commit>  # Changes since commit/date

Example: Get Execution Plan

bash
bv --robot-plan

Returns JSON with:

  • Parallel tracks (what can run concurrently)
  • Items per track
  • Unblocks lists (what each completion frees up)

Common Workflows

Starting Work

bash
bd ready                                  # Find available work
bd show <id>                              # Review issue details
bd update <id> --status=in_progress       # Claim it

Completing Work

bash
bd close <id1> <id2> ...                  # Close completed issues
bd sync                                   # Push to remote

Creating Dependent Work

bash
bd create --title="Implement feature X" --type=feature --priority=P2
bd create --title="Write tests for X" --type=task --priority=P2
bd dep add <tests-id> <feature-id>        # Tests depend on feature

Priority Levels

Use numeric priorities (NOT "high"/"medium"/"low"):

Priority Use Case
P0 Critical - blocking everything
P1 High - needs immediate attention
P2 Medium - standard work
P3 Low - nice to have
P4 Backlog - future consideration

Conventions

  • Single source of truth: Use Beads for task status/priority/dependencies
  • Shared identifiers: Use beads issue ID (e.g., agent-relay-123) in commit messages
  • Message subjects: Prefix with [agent-relay-123] for traceability

Session Close Protocol

Before ending any session:

bash
bd sync                 # Commit beads changes
git add <files>         # Stage code changes
git commit -m "..."     # Include bd-### in message
bd sync                 # Commit any new beads changes
git push                # Push to remote

Anti-Patterns

Mistake Fix
Using bv without robot flags Always use --robot-* flags
Managing tasks in markdown Use bd as single task queue
Missing issue IDs in commits Always include bd-###
Using high/medium/low priority Use P0-P4 numeric format

Recommended Agent Skills

Expand your agent's capabilities with these related and highly-rated skills.

aiskillstore/marketplace

perigon-backend

Perigon ASP.NET Core + EF Core + Aspire conventions

232 15
Explore
aiskillstore/marketplace

perigon-agent

Pointers for Copilot/agents to apply Perigon conventions

232 15
Explore
aiskillstore/marketplace

perigon-angular

Angular 21+ standalone/Material/signal conventions for Perigon WebApp

232 15
Explore
aiskillstore/marketplace

fastapi-mastery

Comprehensive FastAPI development skill covering REST API creation, routing, request/response handling, validation, authentication, database integration, middleware, and deployment. Use when working with FastAPI projects, building APIs, implementing CRUD operations, setting up authentication/authorization, integrating databases (SQL/NoSQL), adding middleware, handling WebSockets, or deploying FastAPI applications. Triggered by requests involving .py files with FastAPI code, API endpoint creation, Pydantic models, or FastAPI-specific features.

232 15
Explore
aiskillstore/marketplace

context7-efficient

Token-efficient library documentation fetcher using Context7 MCP with 86.8% token savings through intelligent shell pipeline filtering. Fetches code examples, API references, and best practices for JavaScript, Python, Go, Rust, and other libraries. Use when users ask about library documentation, need code examples, want API usage patterns, are learning a new framework, need syntax reference, or troubleshooting with library-specific information. Triggers include questions like "Show me React hooks", "How do I use Prisma", "What's the Next.js routing syntax", or any request for library/framework documentation.

232 15
Explore
aiskillstore/marketplace

browser-use

Browser automation using Playwright MCP. Navigate websites, fill forms, click elements, take screenshots, and extract data. Use when tasks require web browsing, form submission, web scraping, UI testing, or any browser interaction.

232 15
Explore

Didn't find tool you were looking for?

Be as detailed as possible for better results