Borrowing it
Nothing to install: this file belongs to NguyenSiTrung/Conductor-Beads. Take a copy, put it at the same path in your own repository, and replace the rules that are about this project with yours.
curl -O https://raw.githubusercontent.com/NguyenSiTrung/Conductor-Beads/main/.claude/skills/beads/SKILL.mdgit clone --depth 1 https://github.com/NguyenSiTrung/Conductor-BeadsWrote this? Show the measurements
A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.
[](https://agentmods.dev/skills/nguyensitrung/conductor-beads/beads)<a href="https://agentmods.dev/skills/nguyensitrung/conductor-beads/beads"><img src="https://agentmods.dev/badge/skills/nguyensitrung/conductor-beads/beads/github.svg" alt="Measured on agentmods" height="20"></a>Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.
<a href="https://agentmods.dev/skills/nguyensitrung/conductor-beads/beads"><img src="https://agentmods.dev/badge/skills/nguyensitrung/conductor-beads/beads.svg" alt="Reviewed on agentmods" width="80" height="20"></a>What it costs to keep this loaded
Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.
| Model | Per session | Once invoked |
|---|---|---|
| Fable 5.1 | $0.00038 | $0.01239 |
| Opus 5 | $0.00019 | $0.00620 |
| Sonnet 5 | $0.00008 | $0.00248 |
| Haiku 4.5 | $0.00004 | $0.00124 |
Grade A, and why
beads scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 11d ago.
A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.
Nothing flagged
None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.
This is a copy
88% identical to beads — 20 lines differ, which has more behind it and is treated as the original. This page carries a canonical link to it rather than competing with it.
How it starts
The opening of the file, as written. The whole thing — 110 lines — stays where its author put it; the contents beside it link to each section on GitHub.
Beads - Persistent Task Memory for AI Agents
Graph-based issue tracker that survives conversation compaction. Provides persistent memory for multi-session work with complex dependencies.
bd vs TodoWrite
| bd (persistent) | TodoWrite (ephemeral) |
|---|---|
| Multi-session work | Single-session tasks |
| Complex dependencies | Linear execution |
| Survives compaction | Conversation-scoped |
| Git-backed, team sync | Local to session |
Decision test: "Will I need this context in 2 weeks?" → YES = bd
When to use bd:
- Work spans multiple sessions or days
- Tasks have dependencies or blockers
- Need to survive conversation compaction
- Exploratory/research work with fuzzy boundaries
- Collaboration with team (git sync)
When to use TodoWrite:
- Single-session linear tasks
- Simple checklist for immediate work
- All context is in current conversation
- Will complete within current session
Prerequisites
bd --version # Requires v0.56.0+
- bd CLI installed and in PATH
- Git repository (bd requires git for sync)
- Initialization:
bd initrun once (humans do this, not agents)
CLI Reference
Run bd prime for AI-optimized workflow context (auto-loaded by hooks).
Run bd <command> --help for specific command usage.
Essential commands: bd ready, bd create, bd show, bd update, bd close, bd dolt push
v0.56+: Beads now requires a running Dolt SQL server. Start with
bd dolt startbefore using bd commands.
Session Protocol
bd ready— Find unblocked workbd show <id>— Get full contextbd update <id> --claim— Claim and start work atomically- Add notes as you work (critical for compaction survival)
bd close <id> --reason "..."— Complete taskbd dolt push— Push to Dolt remote (if configured)
Advanced Features
| Feature | CLI | Resource |
|---|---|---|
| Molecules (templates) | bd mol --help |
MOLECULES.md |
| Chemistry (pour/wisp) | bd pour, bd wisp |
CHEMISTRY_PATTERNS.md |
| Agent beads | bd agent --help |
AGENTS.md |
| Async gates | bd gate --help |
ASYNC_GATES.md |
| Worktrees | bd worktree --help |
WORKTREES.md |
| Messaging | bd mail --help |
MESSAGING.md |
| Graph links | bd relate --help |
GRAPH_LINKS.md |
| Dolt management | bd dolt --help |
— |
| SQL access | bd sql --help |
— |
| Graph visualization | bd graph --help |
— |
What ships with it
49 files beside SKILL.md in the same directory: the scripts, references and assets a skill reads on demand. Not counted in the per-session cost; read them before you install if any of them is executable.
- adr/0001-bd-prime-as-source-of-truth.md 1.7 KB
- CLAUDE.md 2.6 KB
- commands/audit.md 947 B
- commands/blocked.md 561 B
- commands/close.md 583 B
- commands/comments.md 965 B
- commands/compact.md 1.0 KB
- commands/create.md 649 B
- commands/decision.md 2.6 KB
- commands/delete.md 959 B
- commands/dep.md 3.3 KB
- commands/epic.md 858 B
- commands/export.md 586 B
- commands/import.md 1019 B
- commands/init.md 751 B
- commands/label.md 896 B
- commands/list.md 2.6 KB
- commands/prime.md 231 B
- commands/quickstart.md 348 B
- commands/ready.md 579 B
- commands/rename-prefix.md 599 B
- commands/reopen.md 593 B
- commands/restore.md 712 B
- commands/search.md 3.1 KB
- commands/show.md 561 B
- commands/stats.md 617 B
- commands/sync.md 880 B
- commands/template.md 6.5 KB
- commands/update.md 868 B
- commands/version.md 974 B
- commands/workflow.md 1.9 KB
- README.md 5.0 KB
- resources/AGENTS.md 2.0 KB
- resources/ASYNC_GATES.md 3.9 KB
- resources/BOUNDARIES.md 17 KB
- resources/CHEMISTRY_PATTERNS.md 6.7 KB
- resources/CLI_REFERENCE.md 25 KB
- resources/DEPENDENCIES.md 19 KB
- resources/GRAPH_LINKS.md 3.5 KB
- resources/INTEGRATION_PATTERNS.md 13 KB
- resources/ISSUE_CREATION.md 5.0 KB
- resources/MESSAGING.md 2.8 KB
- resources/MOLECULES.md 10 KB
- resources/PATTERNS.md 11 KB
- resources/RESUMABILITY.md 5.3 KB
- resources/STATIC_DATA.md 2.0 KB
- resources/TROUBLESHOOTING.md 10 KB
- resources/WORKFLOWS.md 19 KB
- resources/WORKTREES.md 2.7 KB
What this file has done since we first saw it
Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.
- 11d ago First seen · 110 lines · 38 tokens per session scan A c41ee99936bb
beads is a skill published in the GitHub repository NguyenSiTrung/Conductor-Beads (24 stars, last pushed 6mo ago), licensed Apache-2.0. It adds 38 tokens to every session and 1,239 once invoked, about $0.0002 per session on Opus 5. A static security scan graded it A with 0 findings. It is 88% identical to beads, differing in 20 lines, and is treated as a copy.
Other skills, from other repositories
mcore-split-pr
Split a PR into multiple PRs to reduce the number of required CODEOWNERS reviewer groups.
shiplog
Recap of everything shipped since the last run - cross-repo PRs, security fixes, star deltas, and X traction, synthesized into a digest article and a ready-to-post shiplog in your voice.
llxprt-issue-workflow
Use this skill when asked to address, fix, or work on a GitHub issue in the llxprt-code repository. Covers the complete issue lifecycle - branch setup, gh CLI usage, test-first planning, subagent delegation and review loops, the full verification cycle (including the stepfun-37 smoke test), open code review (ocr), PR…
cyrus-setup-repository
Add one or more Git repositories to Cyrus configuration so it can process issues from those repos.
github-sync
Bidirectional synchronization of epics and tasks with GitHub issues, labels, and relationships.
github-notification-triage
Triage GitHub notifications and issue/PR queues.