beads-viewer

Installation
SKILL.md

Beads Viewer

Overview

Beads Viewer (BV) is a graph-aware triage engine for Beads projects (.beads/beads.jsonl). It computes 9 graph metrics, generates execution plans, and provides deterministic recommendations.

When to use: Triaging beads tasks, analyzing dependency graphs, finding bottlenecks, detecting circular dependencies, planning parallel execution tracks, generating sprint burndown data, comparing historical project states.

When NOT to use: Parsing raw beads.jsonl directly (BV pre-computes graph metrics), simple bead CRUD operations (use bd CLI instead), projects without .beads/beads.jsonl.

Capability Raw beads.jsonl BV Robot Mode
Query "List all issues" "List the top 5 bottlenecks blocking the release"
Context Cost High (linear with issue count) Low (fixed summary struct)
Graph Logic Agent must compute Pre-computed (PageRank, betweenness, cycles)
Safety Agent might miss cycles Cycles explicitly flagged

Quick Reference

Related skills
Installs
31
GitHub Stars
11
First Seen
Feb 24, 2026