beads-workflow

Automate beads issue tracker task management with session-start workflows.

6|Updated Dec 7, 2025
One-click install
npx skills add https://github.com/timequity/plugins --skill beads-workflow-timequity
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: beads-workflow
Source: https://github.com/timequity/plugins/tree/main/vibe-coder/skills/beads-workflow
Command: npx skills add https://github.com/timequity/plugins --skill beads-workflow-timequity

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Proactive task management for projects using beads issue tracker. It helps orchestrate task flow, readiness, and progress between beads-based tasks.

Core Features & Use Cases

  • Session Start: Initialize beads workflow and CLAUDE Beads.md prompts
  • Task Decomposition: Break down beads tasks with TodoWrite
  • Ready/Progress Sync: Sync and switch between in-progress and ready tasks
  • Next Task Guidance: Present next high-priority task from ready queue

Quick Start

When starting a beads session, use the beads workflow to show current in_progress task or pick from ready tasks, then break work into subtasks and proceed.

Frequently Asked Questions about beads-workflow

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

FAQPage Schema
How do I automate task management in a beads project?

Beads-workflow automates task orchestration by managing work initiation, task selection, and progress tracking within beads issue tracker projects. Start the workflow in a directory containing .beads/ to initialize session, select ready tasks, and advance them through in_progress and completion states using triggers like 'next task', 'done', or 'refresh'.

What triggers activate the beads workflow?

Beads-workflow responds to multiple trigger phrases including 'next task', 'pick task', 'done', 'tasks', 'refresh', 'sync', 'какие задачи', 'что делать', 'готово', 'следующая задача', 'создай задачу', and 'обнови задачи'. These commands initiate task selection, completion workflows, subtask creation, and synchronization actions.

Do I need CLAUDE.md to use beads workflow?

Yes, beads-workflow requires CLAUDE.md provisioning as a mandatory environment check before managing tasks. The workflow validates beads presence and CLAUDE.md setup during session initialization to ensure proper context and prompt configuration.

How do I break down beads tasks into subtasks?

Beads-workflow implements task decomposition through TodoWrite, enabling you to create subtasks and structure work within existing beads tasks. Use workflow triggers to initiate subtask creation while tracking progress and managing task transitions.

Can beads workflow synchronize across multiple tasks?

Yes, beads-workflow includes synchronization capabilities through 'bd sync' and environment context retrieval. It syncs ready and in_progress task states, allowing you to refresh task queues and switch between active work items across beads projects.

What happens during beads workflow session start?

Session start initializes beads workflow by checking for .beads/ directory presence, provisioning CLAUDE.md, retrieving current context, and presenting task status. The workflow then guides you to either continue an in_progress task or select from ready tasks.