Beads

Shared Beads workflow baseline. Use whenever an agent uses `bd`, manages durable tasks, blockers, or handoffs, resolves work ownership, or decides between an ephemeral checklist and durable tracking. Covers store authority and remote Dolt safety.

Install

skills CLI (Claude Code, Cursor, Codex and more)
npx skills add flurdy/agent-skills --skill beads
Manual install
git clone --depth 1 https://github.com/flurdy/agent-skills.git /tmp/agent-skills
mkdir -p ~/.claude/skills
cp -r /tmp/agent-skills/skills/beads ~/.claude/skills/beads

Personal skills live in ~/.claude/skills. Use .claude/skills in a project folder to share a skill with your team.

From the SKILL.md

# Beads Workflow

Apply this baseline whenever Beads is active. It decides where durable work belongs and which
focused skill owns the operation; it is not another intake, grooming, migration, or sync
procedure.

## Authority and opt-in

Repository-local instructions remain authoritative for whether Beads is active, which tracker
and store own work, lifecycle conventions, and stronger safety rules. Follow the nearest
`AGENTS.md` or equivalent project guidance before this shared baseline when they differ.

Do not initialize Beads merely because this skill loaded. If the repository has no active Beads
store, follow its declared Jira, Trello, or other tracking policy. If no tracker is declared, ask
before introducing one.

Never edit generated Beads integration blocks manually during ordinary work. This includes the
legacy `` marker and metadata-bearing variants through
``. The only exception is the explicit cleanup-only, marker-bounded native edit in [integration-cleanup.md](references/integration-cleanup.md), after its exact preview, ownership
checks, recovery evidence and fresh confirmation. `bd` may regenerate removed blocks; put
human-maintained policy outside its markers.

## Explicit fresh-store setup

For an explicitly requested fresh repository store with a private GitHub Dolt remote, use
[beads-setup](../beads-setup/SKILL.md). Its preview grants no initialization or publication
Read the full skill on GitHub

Details

Skill name
beads
Path
skills/beads/SKILL.md
License
MIT
Repo updated
17 November 2026

FAQ

What does the Beads skill do?

Shared Beads workflow baseline. Use whenever an agent uses `bd`, manages durable tasks, blockers, or handoffs, resolves work ownership, or decides between an ephemeral checklist and durable tracking. Covers store authority and remote Dolt safety.

How do I install the Beads skill?

skills CLI (Claude Code, Cursor, Codex and more): npx skills add flurdy/agent-skills --skill beads. Skills go in ~/.claude/skills (personal) or .claude/skills (project), and Claude loads them automatically when a task matches the description.

Is Beads popular?

It lives in flurdy/agent-skills, which has 9 GitHub stars and 0 forks.

Related skills

Architect

9

flurdy/agent-skills

Architecture and implementation planning gate for complex or high-blast-radius work. Produces evidence-backed decisions, reviewable slices, acceptance evidence, and conditional human review ownership without editing code.

Software Development

Artifact Hygiene

9

flurdy/agent-skills

Run a local-only, read-only advisory audit of publishable working-tree files and unpublished branch history with redaction-safe findings.

Git & Code Review

Backlog Groom

9

flurdy/agent-skills

Auto-detects workspace unfinished backlogs across unique stores; otherwise local open beads. Flags thin prose, missing labels, drift, lifecycle and duplicates. Report-only; mutations need approval, destructive ones individually.

Other

Complete Task

9

flurdy/agent-skills

Complete an in-progress task by running clean-code, staging, and committing. Close the bead on trunk, leave it open for PR creation, and protect detached commits. Use after /verify-task.

Productivity & Notes

Verified Email

9

PanPanFR/oh-my-openkilo

Provides a complete workflow for implementing verified email retrieval on Android Credential Manager API. Use this skill to integrate a secure, OTP-less email verification flow into an Android app. This skill solves the problem of high-friction sign-up processes by leveraging cryptographically verified credentials from trusted providers like Google.

Productivity & Notes

Handoffs

9

flurdy/agent-skills

Browse and load current-repo or workspace-member handoffs, including pruned worktrees. Optional confirmed archiving and checkout recovery; loading alone never executes the saved task.

Productivity & Notes

Browse the most popular Claude skills, all productivity & notes skills, or write your own with the skills generator.