When should I create an issue versus just writing code?

This skill follows the 'non-trivial' rule: if a task takes more than 5-10 minutes or spans multiple files, you should create an issue to track the work.

Can I edit the .beads files manually?

No. To maintain data integrity, you should always use the 'bd' or 'beads' CLI commands rather than manually editing the .beads/issues.jsonl file.

Does this skill work with Git?

Yes, it is designed for Git workflows. You are encouraged to commit changes in the .beads/ directory to sync issue states with your code progress.

What is Beads and how does it store data?

Beads is a minimalist, local-first issue tracker that stores all tasks, comments, and status changes as plain text files within a .beads/ directory in your project.

How do priorities work in the Beads system?

Beads uses a numeric scale from 0 to 4 (P0-P4). P0 is critical/urgent, P2 is normal work, and P4 is for the someday/maybe backlog.

Beads Issue Tracker

Name: Beads Issue Tracker
Author: code0100fun

bycode0100fun

0•

Productividad y Flujo de Trabajo

Manages project tasks and bug tracking using a local-first, file-based system integrated directly into your repository.

Beads Issue Tracker is a specialized skill that enables Claude to manage project tasks through a minimalist, local-first workflow. By storing issues as plain text files in a .beads/ directory, it allows developers to maintain a version-controlled record of bugs, features, and epics without external dependencies. This skill provides a structured framework for prioritizing work on a 0-4 scale, managing session-based progress, and ensuring project state is accurately documented through CLI commands, making it ideal for maintaining high development velocity in offline or private environments.

Características Principales

01Comprehensive CLI command support for issue creation, filtering, and searching

02Session management protocol for tracking progress and documenting technical decisions

03Local-first tracking using plain text files stored in the .beads/ directory

040 GitHub stars

05Seamless Git integration for versioning issue history alongside source code

06Standardized priority (P0-P4) and classification system for bugs, epics, and chores

Casos de Uso

01Managing complex multi-file refactors that require persistent state across sessions

02Maintaining a private, offline-capable alternative to centralized issue management tools

03Tracking technical debt and feature requests without leaving the terminal

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add code0100fun/botfiles beads-issue-tracker

For use in Claude.ai and ChatGPT

Download Skill