beads-issue-tracking

Synchronize issue tracking across GitHub, Linear, and Forgejo using Beads.

Updated Nov 3, 2025
One-click install
npx skills add https://github.com/ethicalcapital/skills --skill beads-issue-tracking-ethicalcapital
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: beads-issue-tracking
Source: https://github.com/ethicalcapital/skills/tree/main/beads-issue-tracking
Command: npx skills add https://github.com/ethicalcapital/skills --skill beads-issue-tracking-ethicalcapital

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires beads, and includes scripts (resource) and references (resource) components.

What problem does it solve?

Beads Issue Tracking streamlines issue management by providing a structured approach to triage, mutation, and next-task selection, ensuring all work is tracked and synchronized across platforms.

Core Features & Use Cases

  • Beads-first Work Tracking: Centralizes work tracking in Beads, with synchronization to GitHub, Linear, and Forgejo.
  • Triage and Issue Mutation: Facilitates efficient issue creation, update, and closure.
  • Task Selection: Offers commands for identifying the next best task based on dependencies and blockers.
  • Use Case: For a team managing a large codebase, this skill helps maintain a clean and organized issue tracker, reducing time spent on manual issue management.

Quick Start

Run the bd ready command to prepare for task management.

Frequently Asked Questions about beads-issue-tracking

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I synchronize issue tracking between GitHub and Beads?

Issue tracking synchronization between GitHub and Beads centralizes work in Beads and pushes issue creation, updates, and closures to GitHub. This ensures your remote tracker stays aligned without manual duplicate entry.

How do I select the next best task when managing issues with dependencies?

Selecting the next best task is handled by dedicated Beads commands that analyze your issue tracker for dependencies and blockers. This identifies the optimal task to work on next, preventing stalled progress on blocked items.

What is the Beads-first methodology for work management?

The Beads-first methodology for work management centralizes all issue triage and mutation in Beads before synchronizing to external platforms. This provides a structured approach to tracking work, ensuring all changes propagate cleanly.

Do I need a Beads installation to use this issue tracking skill?

Yes, a Beads installation is required as a dependency for this issue tracking skill. You must run the `bd ready` command to prepare your environment before managing tasks or synchronizing issues across platforms.

Can I use Beads issue tracking with platforms other than GitHub?

Yes, Beads issue tracking supports synchronization with Linear and Forgejo in addition to GitHub. This allows you to maintain a clean issue tracker across multiple platforms from a centralized Beads workflow.