Bv
Bv extracts key information from text, streamlining data analysis and accelerating insights for quicker decision-making.
Install on your platform
We auto-selected Claude Code based on this skill’s supported platforms.
Run in terminal (recommended)
claude mcp add bv npx -- -y @trustedskills/bv
Or manually add to ~/.claude/settings.json
{
"mcpServers": {
"bv": {
"command": "npx",
"args": [
"-y",
"@trustedskills/bv"
]
}
}
}Requires Claude Code (claude CLI). Run claude --version to verify your install.
About This Skill
What it does
Bv (Beads Viewer) is a triage engine specifically designed for Beads projects, which use .beads/beads.jsonl files. It analyzes these project files by computing nine graph metrics to identify key dependencies and potential bottlenecks. Bv provides deterministic recommendations and flags structural errors like circular dependencies, streamlining data analysis and accelerating insights for quicker decision-making within a Beads project. Crucially, it offers "Robot Mode" designed specifically for AI agent integration.
When to use it
- Analyzing large Beads projects to identify foundational blockers.
- Pinpointing bottlenecks that are hindering release progress.
- Detecting and resolving circular dependencies (structural errors) within a Beads project.
- Prioritizing tasks and identifying quick wins in a Beads workflow.
- Understanding the influence of different components through eigenvector analysis.
Key capabilities
- Computes nine graph metrics: PageRank, Betweenness, HITS, Critical Path, Eigenvector, Degree, Density, Cycles, and Topo Sort.
- Provides deterministic recommendations for project triage and planning.
- Flags circular dependencies explicitly.
- Offers "Robot Mode" with various commands for AI agent integration (e.g.,
bv --robot-triage,bv --robot-next). - Performs a two-phase analysis: quick metrics are computed instantly, while more complex ones have a 500ms timeout.
Example prompts
bv --robot-triage: To get full triage recommendations, including quick wins and blockers to clear.bv --robot-next: To receive the single top pick for immediate action.bv --robot-insights: To view all computed graph metrics for a comprehensive project analysis.
Tips & gotchas
- Robot Mode is essential: Never run Bv without using one of the
--robot-*flags, as it will launch an interactive TUI that blocks your session. - Large graphs may be approximate: For projects with over 500 nodes, some graph metrics might be approximated due to computational constraints.
- Check the status field: Always review the "status" field in the output to understand if any metrics were skipped or are approximate.
Tags
TrustedSkills Verification
Unlike other registries that point to live repositories, TrustedSkills pins every skill to a verified commit hash. This protects you from malicious updates — what you install today is exactly what was reviewed and verified.
Security Audits
| Gen Agent Trust Hub | Pass |
| Socket | Pass |
| Snyk | Pass |
🌐 Community
Passed automated security scans.