Why is the session completion workflow mandatory?

To prevent work from being stranded locally. The workflow ensures all code is tested, issues are updated, and changes are pushed to the remote origin before ending the session.

What happens when I ask Claude 'What's next?'

Claude will execute 'bd ready', identify the highest priority tasks, and present a list of in-progress and ready items for you to work on.

Does it support handoffs between different developers?

Yes, the skill automatically adds 'HANDOFF' comments to tasks at the end of a session, providing context and next steps for the next person or agent who picks up the task.

How do I activate the Beads skill in Claude Code?

The skill activates automatically whenever a '.beads' directory is detected in your project's root directory.

How does the skill handle large features or epics?

It mandates the use of dedicated Git worktrees for all epic-related work to ensure a clean development environment and prevent branch pollution.

Beads Issue Tracking

Name: Beads Issue Tracking
Author: sttts

bysttts

•

Collaboration Tools

Manages project tasks, epics, and workflows directly within Claude Code using the Beads issue tracker.

The Beads Issue Tracking skill integrates the Beads CLI into Claude Code to provide a robust, structured workflow for project management. It automates task prioritization, epic creation with intelligent ID conventions, and mandatory session completion rituals. By enforcing Git synchronization, worktree isolation for epics, and detailed handoff comments, it ensures that your development process remains organized, transparent, and ready for collaboration between AI agents and human developers.

Key Features

01Real-time 'What's Next' status reporting for immediate task prioritization

02Intelligent task and epic creation with structured naming conventions

03Automated session initialization using 'bd prime' for optimized AI context

041 GitHub stars

05Enforced session completion workflow including quality gates, syncing, and handoff comments

06Dedicated worktree management for isolated and safe epic development

Use Cases

01Automating the transition between local development and remote repository synchronization

02Managing complex software development cycles using a CLI-native issue tracker

03Facilitating seamless handoffs between multiple AI coding sessions with persistent status comments

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add sttts/skills issue-tracking

For use in Claude.ai and ChatGPT

Download Skill