Skills
.Work. You
Rest

flow-sync

Community

Sync Beads state to spec.md

Software Engineering#workflow#documentation#task management#beads#sync#spec.md
Authorcofin
Version1.0.0
Installs0

System Documentation

What problem does it solve?

This Skill synchronizes the state of tasks managed in Beads with the on-disk spec.md file, ensuring that your project's documentation accurately reflects the current status of your work.

Core Features & Use Cases

  • Bi-directional Sync: Updates task markers in spec.md based on Beads status.
  • Status Mapping: Translates Beads statuses (open, in_progress, closed, blocked) into markdown markers ([ ], [~], [x], [!]).
  • Commit SHA Appending: Includes commit SHAs from Beads close reasons where available.
  • Use Case: After completing tasks in Beads, run flow-sync to automatically update the corresponding checkboxes and add commit references in your project's spec.md, keeping your documentation in sync with development progress.

Quick Start

Run the flow-sync skill to synchronize the active flow's Beads state to spec.md.

Dependency Matrix

Required Modules

br

Components

references

💻 Claude Code Installation

Recommended: Let Claude install automatically. Simply copy and paste the text below to Claude Code.

Please help me install this Skill:
Name: flow-sync
Download link: https://github.com/cofin/flow/archive/main.zip#flow-sync

Please download this .zip file, extract it, and install it in the .claude/skills/ directory.
View Source Repository

Agent Skills Search Helper

Install a tiny helper to your Agent, search and equip skill from 223,000+ vetted skills library on demand.