kenzik/beads
skills/beads_rust/SKILL.md
Track tasks and issues using the br CLI. Use for task management, sprint planning, dependency tracking, and project organization. Replaces TodoWrite.
tools
Updated Apr 23, 2026
$ install --global
skillsauthnpx skillsauth add kenzik/agent-config beadsInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: Apr 23, 2026, 7:57 PM166.3s1 file scanned
SKILL.md
- name:
- beads
- alt_names:
- beads_rust, br, bd
- description:
- Track tasks and issues using the br CLI. Use for task management, sprint planning, dependency tracking, and project organization. Replaces TodoWrite.
- url:
- https://github.com/Dicklesworthstone/beads_rust
Beads Workflow Integration
This project uses beads_rust (br/bd) for issue tracking. Issues are stored in .beads/ and tracked in git.
Prerequisites
Install beads:
curl -fsSL "https://raw.githubusercontent.com/Dicklesworthstone/beads_rust/main/install.sh?$(date +%s)" | bash
Initialize in a project:
br init
Essential Commands
# View ready issues (unblocked, not deferred)
br ready # or: bd ready
# List and search
br list --status=open # All open issues
br show <id> # Full issue details with dependencies
br search "keyword" # Full-text search
# Create and update
br create --title="..." --description="..." --type=task --priority=2
br update <id> --status=in_progress
br close <id> --reason="Completed"
br close <id1> <id2> # Close multiple issues at once
# Sync with git
br sync --flush-only # Export DB to JSONL
br sync --status # Check sync status
Workflow Pattern
- Start: Run
br readyto find actionable work - Claim: Use
br update <id> --status=in_progress - Work: Implement the task
- Complete: Use
br close <id> - Sync: Always run
br sync --flush-onlyat session end
Key Concepts
- Dependencies: Issues can block other issues.
br readyshows only unblocked work. - Priority: P0=critical, P1=high, P2=medium, P3=low, P4=backlog (use numbers 0-4, not words)
- Types: task, bug, feature, epic, chore, docs, question
- Blocking:
br dep add <issue> <depends-on>to add dependencies
Session Protocol
Before ending any session, run this checklist:
git status # Check what changed
git add <files> # Stage code changes
br sync --flush-only # Export beads changes to JSONL
git commit -m "..." # Commit everything
git push # Push to remote
Best Practices
- Check
br readyat session start to find available work - Update status as you work (in_progress → closed)
- Create new issues with
br createwhen you discover tasks - Use descriptive titles and set appropriate priority/type
- Always sync before ending session
Related Skills
kenzik/worktree
development
VerifiedTrustedCommunity
Manage git worktrees for parallel development. Use to work on multiple branches simultaneously without stashing or switching contexts.
SKILL.mdUpdated Apr 23, 2026
kenzik/tmux
tools
VerifiedTrustedCommunity
Manage tmux sessions for background processes. Use to run long-running commands, manage multiple terminals, and capture output from background processes.
SKILL.mdUpdated Apr 23, 2026
kenzik/skill-creator
tools
VerifiedTrustedCommunity
Create new Agent Skills for Claude Code. Use when user wants to create a skill, add a new capability, document a CLI workflow, or asks how skills work.
SKILL.mdUpdated Apr 23, 2026
kenzik/github
tools
VerifiedTrustedCommunity
Manage GitHub issues using gh CLI - create, list, view, update, close, and assign issues. Use when working with GitHub issues, bug tracking, or project management tasks.
SKILL.mdUpdated Apr 23, 2026