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

•

생산성 및 워크플로

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

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.

주요 기능

01Detailed task handoff system using Beads comments for multi-session continuity

02Automated task and epic creation with semantic ID patterns

031 GitHub stars

04AI-optimized project context loading via 'bd prime' on session start

05Mandatory session completion workflows including quality gates and remote sync

06Streamlined Git worktree management for isolated epic development

사용 사례

01Managing project backlogs and task states without leaving the terminal

02Organizing large-scale feature development into isolated, dedicated Git worktrees

03Enforcing consistent Git hygiene and issue status updates across development teams

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add sttts/beads-skill issue-tracking

For use in Claude.ai and ChatGPT

Download Skill