beads-workflow

Create Beads epics and features with automatic Git branch creation.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/stars-end/affordabot --skill beads-workflow
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: beads-workflow
Source: https://github.com/stars-end/affordabot/tree/main/.claude/skills/beads-workflow
Command: npx skills add https://github.com/stars-end/affordabot --skill beads-workflow

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

Keeping track of development tasks, managing dependencies, and ensuring persistent task memory across sessions can be cumbersome, especially in multi-developer environments.

Core Features & Use Cases

  • Automated Issue & Branch Creation: Effortlessly create epics or features, automatically generating and checking out corresponding Git branches.
  • Intelligent Work Tracking: Manage issue lifecycles (create, update, close), track dependencies, and find ready tasks with no blockers.
  • Git-Backed Persistence: Ensures all task memory is synchronized with Git, providing persistent context across sessions and team members.
  • Use Case: When starting a new feature, simply ask to "create a feature for OAuth login," and this Skill will set up the Beads issue and the Git branch for you.

Quick Start

To create a new feature and automatically set up its branch, simply say: "create a feature for OAuth login"

Frequently Asked Questions about beads-workflow

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

FAQPage Schema
How do I automate Git branch creation when tracking issues?

Automated Git branch creation pairs issue tracking with version control by generating branches whenever you create epics or features. This Skill automatically checks out the corresponding branch, synchronizing your task management with Git so branch names reflect issue context.

Can I track task dependencies and find work ready to start?

Yes. This Skill manages issue lifecycles and dependency linking, letting you query ready tasks—those with no blocking dependencies—so your team always knows what can start next without manual dependency review.

How do I keep task memory persistent across development sessions?

Task data syncs with Git, ensuring all issue state, branch history, and dependency records persist across sessions and team members. Git becomes the single source of truth for your workflow.

What's the quickest way to set up a feature branch and its tracking issue?

Say "create a feature for [task name]" and the Skill handles both issue creation in Beads and Git branch setup in one step, eliminating manual context switching between tools.

Do I need the Beads MCP plugin to use this Skill?

Yes. Integration with the Beads MCP plugin, Git, and Bash tooling is required. The Skill orchestrates these components to link issue tracking, branching, and workflow automation.

Can this Skill manage both epics and features across my workflow?

Yes. This Skill applies to both epic and feature lifecycles, supporting creation, dependency management, status updates, and automatic branch provisioning for each type.