How does the skill activate?

The skill automatically activates when Claude detects a .beads directory in your project root and the user mentions task-related keywords like 'bd' or 'add task'.

What is the 'Landing the Plane' workflow?

It is a mandatory completion sequence that ensures all code is tested, issues are updated, and changes are successfully pushed to the remote repository before ending a session.

Beads is a distributed issue tracker that lives within your Git repository, designed for local-first developer workflows and seamless integration with Git worktrees.

Can I use this for multi-agent collaboration?

Yes, the skill includes a handoff feature that adds comments to tasks, explaining the status and next steps for the next developer or AI agent.

How does this skill handle Git worktrees?

It creates dedicated worktrees for every epic to ensure work is isolated from the main checkout, preventing branch pollution and environment conflicts.

Beads Issue Tracking

Name: Beads Issue Tracking
Author: sttts

bysttts

•

Productivity & Workflow

Manages project tasks and Git worktrees using the Beads issue tracker directly within the Claude Code environment.

About

This skill integrates the Beads issue tracking system with Claude Code to provide a structured, local-first workflow for task management and Git worktree automation. It streamlines developer productivity by enforcing mandatory synchronization routines, automating the creation of tasks and epics with semantic IDs, and ensuring that every work session ends with a successful remote push and detailed handoff. Designed for projects that value isolated development environments, it automatically manages worktrees for epics to keep main checkouts clean and stable.

Key Features

Detailed task handoff system using Beads comments for multi-session continuity
Automated task and epic creation with semantic ID patterns
1 GitHub stars
AI-optimized project context loading via 'bd prime' on session start
Mandatory session completion workflows including quality gates and remote sync
Streamlined Git worktree management for isolated epic development

Use Cases

Managing project backlogs and task states without leaving the terminal
Organizing large-scale feature development into isolated, dedicated Git worktrees
Enforcing consistent Git hygiene and issue status updates across development teams

About

Key Features

Detailed task handoff system using Beads comments for multi-session continuity
Automated task and epic creation with semantic ID patterns
1 GitHub stars
AI-optimized project context loading via 'bd prime' on session start
Mandatory session completion workflows including quality gates and remote sync
Streamlined Git worktree management for isolated epic development

Use Cases

Managing project backlogs and task states without leaving the terminal
Organizing large-scale feature development into isolated, dedicated Git worktrees
Enforcing consistent Git hygiene and issue status updates across development teams