br SKILL.md skillA

br from dicklesworthstone/beads_rust is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add dicklesworthstone/beads_rust/br@v1.0.0

Pins v1.0.0 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
dicklesworthstone/beads_rust
Path
.claude/skills/br/SKILL.md
Versions recorded
4
Latest version
v1.0.0, committed Apr 1, 2026
First version recorded
Mar 3, 2026
Size
10,818 bytes
Repository stars
1,145
License
a license file GitHub does not identify

Official skill for beads_rust (`br`), a local-first, dependency-aware issue tracker for AI agents. Use when creating issues, triaging backlogs, managing dependencies, finding ready work, updating status, or syncing to git via JSONL.

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

<!-- TOC: Critical Rules | Quick Workflow | Essential Commands | Dependencies | Sync | bv Integration | Agent Mail | Troubleshooting | References -->

# br -- Beads Rust Issue Tracker (Official Skill)

> **Non-invasive:** br NEVER runs git commands. Sync and commit are YOUR responsibility.

## Critical Rules for Agents

| Rule | Why |
|------|-----|
| **Binary is `br`** | NEVER `bd` (that is the old Go version) |
| **ALWAYS use `--json`** | Structured output for parsing; `--format toon` for reduced tokens |
| **NEVER run bare `bv`** | Blocks session in interactive TUI mode |
| **Sync is EXPLICIT** | `br sync --flush-only` exports DB to JSONL only |
| **Git is YOUR job** | br only touches `.beads/` -- you must `git add .beads/ && git commit` |
| **No cycles allowed** | `br dep cycles` must return empty |
| **Resolve actor at runtime** | Use `ACTOR="${BR_ACTOR:-assistant}"` and pass `--actor "$ACTOR"` |

## Quick Workflow

```bash
ACTOR="${BR_ACTOR:-assistant}"

# 1. Find work
br ready --json

# 2. Claim it
br update --actor "$ACTOR" <id> --status in_progress

# 3. Do work...

# 4. Complete
br close --actor "$ACTOR" <id> --reason "Implemented X"

# 5. Sync to git (EXPLICIT!)
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add dicklesworthstone/beads_rust/br@sha256:9bec4f308df6544f

The line at the top of this page pins the label v1.0.0, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_uqnvwv7py2tno7kd.svg)](https://markdownregistry.com/a/art_uqnvwv7py2tno7kd)

3 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 4 versions of this file, between Mar 3, 2026 and Apr 1, 2026, about one every 10 days.

versioncommittedcommitsizeaudit
v1.0.0 latest2026-04-01 4abf01a 10,818 BA view · diff
git:20260329.e53e29d2026-03-29 e53e29d 8,840 BA view · diff
git:20260326.7cd40eb2026-03-26 7cd40eb 4,205 BA view · diff
v1.0.02026-03-03 578d02f 10,818 BA view

Audit of the latest version

A  17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (10818 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

dicklesworthstone/beads_rust · 1,145 stars · license a license file GitHub does not identify · pushed 2026-11-05 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_uqnvwv7py2tno7kd
GET https://markdownregistry.com/api/v1/resolve?ref=dicklesworthstone/beads_rust/br
GET https://markdownregistry.com/api/v1/blob/9bec4f308df6544f8379239344f88f2ffe32fe71d5f80d9660a8d16b94b67707

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from dicklesworthstone/beads_rust

AGENTS.md AGENTS.md file
dicklesworthstone/beads_rust · AGENTS.md
git:20261105.1763fff · audit A · 1,145 stars
AGENTS.md@docs/agent AGENTS.md file
dicklesworthstone/beads_rust · docs/agent/AGENTS.md
git:20261015.22d1a01 · audit A · 1,145 stars
bd-to-br-migration SKILL.md skill
dicklesworthstone/beads_rust · skills/bd-to-br-migration/SKILL.md · Migrate docs from bd (beads) to br (beads_rust). Use when updating AGENTS.md, converting bd commands, "bd sync" → "br…
git:20260119.b49fda7 · audit A · 1,145 stars

Every file in dicklesworthstone/beads_rust

Browse by kind, by grade A, or by owner.