Skip to content
Skill

beads-task-management

by majiayu000

Install

Copy this and paste it into Claude Code, Cursor, or any AI assistant:

I want to install the "beads-task-management" skill in my project.

Please run this command in my terminal:
# Install skill into your project (2 files)
mkdir -p .claude/skills/beads-task-management && curl --retry 3 --retry-delay 2 --retry-all-errors -o .claude/skills/beads-task-management/SKILL.md "https://raw.githubusercontent.com/majiayu000/claude-skill-registry/main/skills/productivity/beads-task-management/SKILL.md" && curl --retry 3 --retry-delay 2 --retry-all-errors -o .claude/skills/beads-task-management/metadata.json "https://raw.githubusercontent.com/majiayu000/claude-skill-registry/main/skills/productivity/beads-task-management/metadata.json"

Then restart Claude Code (or reload the window in Cursor) so the skill is picked up.

Description

Use beads for structured task tracking with dependencies, recovery cards, and cross-session context management

Overview

Beads is a git-backed issue tracker designed for AI agents and distributed workflows. This skill teaches Claude how to use beads effectively for task management, context recovery, and cross-session collaboration. Core principle: Persistent task tracking prevents context loss and enables multi-session workflows.

Prerequisites

Required: • bd (beads CLI) - Install: brew install steveyegge/beads/bd • Git repository • Project initialized with bd init Optional but Recommended: • ~/.claude/hooks/beads-auto-sync.sh - Auto-sync hook (see HOOK_SETUP.md) First-time setup in a project: `bash cd <project-directory> bd init `

When to Use This Skill

Use beads when: • Working on multi-session tasks (spans multiple days/weeks) • Tasks have dependencies or blockers • Discovering new work during implementation • Need to preserve context across Claude Code compacts/restarts • Multiple people/agents working on same project Don't use beads for: • Single-session, simple tasks (use TodoWrite instead) • Throwaway experiments • Projects without .beads/ directory

The Recovery Card Pattern

CRITICAL: Every beads project must have a standardized recovery card.

Discussion

0/2000
Loading comments...

Health Signals

MaintenanceCommitted 1mo ago
Active
Adoption100+ stars on GitHub
119 ★ · Growing
DocsREADME + description
Well-documented

GitHub Signals

Stars119
Forks20
Issues1
Updated1mo ago
View on GitHub
MIT License

My Fox Den

Community Rating

Sign in to rate this booster

Works With

Claude Code