plan-to-beads

Convert a project plan file into a beads epic with subtasks.

11|2|Updated Jan 3, 2022
One-click install
npx skills add https://github.com/hay-kot/dotfiles --skill plan-to-beads
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: plan-to-beads
Source: https://github.com/hay-kot/dotfiles/tree/main/.ai/skills/plan-to-beads
Command: npx skills add https://github.com/hay-kot/dotfiles --skill plan-to-beads

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill automates turning a plan file into a beads epic, ensuring the complete plan text is preserved in the epic and subtasks are created to track all work items.

Core Features & Use Cases

  • Creates a beads epic from the current plan file and stores the full plan text in the epic description.
  • Generates subtasks for each major work item or step identified in the plan, with clear titles and parent epic linkage.
  • Optionally links sequential steps and ensures changes are synced back to version control.

Quick Start

Run the plan-to-beads command to transform the current plan into an epic with subtasks.

Frequently Asked Questions about plan-to-beads

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

FAQPage Schema
How do I convert a project plan into a beads epic with subtasks?

To convert a project plan into a beads epic, the skill reads your latest plan file, creates an epic with the full plan text preserved in the description, and generates linked subtasks for all identified work items.

What is the best way to track plan subtasks and link dependencies in beads?

The best way to track plan subtasks and link dependencies in beads is to automate epic creation from your plan file, which parses major work items into subtasks and optionally links sequential steps together.

Does the plan-to-beads skill sync generated epics and subtasks back to git?

Yes, the plan-to-beads skill syncs generated epics and subtasks back to git. It ensures changes are synced to version control and provides a clipboard copy of the epic id for reference.

Can I preserve the complete plan text inside a beads epic description?

Yes, you can preserve the complete plan text inside a beads epic description. The skill takes the full text from your plan file and stores it directly in the generated epic's description field.

When do I need to use a plan-driven workflow for project management automation?

You need a plan-driven workflow for project management automation when your process requires visualizing tasks as beads, linking sequential dependencies, and syncing tracked subtasks directly with version control.