bead-fix

Apply ledger-listed fixes from BEADS_LEDGER.md to BEADS.md.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/quantfiction/dotfiles --skill bead-fix
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: bead-fix
Source: https://github.com/quantfiction/dotfiles/tree/main/claude/plugins/global-skills/skills/bead-fix
Command: npx skills add https://github.com/quantfiction/dotfiles --skill bead-fix

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It automates applying fixes listed in BEADS_LEDGER.md to BEADS.md, enabling faster, consistent bead updates without manual editing.

Core Features & Use Cases

  • Reads OPEN issues from BEADS_LEDGER.md and applies the required fixes to BEADS.md.
  • Applies both global fixes and targeted bead fixes as dictated by the ledger.
  • Ensures that the ledger itself is not modified and keeps bead-review flow intact.

Quick Start

Run the bead-fix skill after bead-review identifies OPEN issues to automatically apply the ledger's fixes to BEADS.md.

Frequently Asked Questions about bead-fix

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

FAQPage Schema
How do I automatically apply ledger fixes to BEADS.md?

To automatically apply ledger fixes to BEADS.md, run the bead-fix skill after bead-review identifies OPEN issues. It reads OPEN blockers and should-fixes from BEADS_LEDGER.md and enforces those required changes directly onto BEADS.md.

What is the workflow for updating markdown beads after a bead-review?

The markdown bead update workflow involves running bead-fix after bead-review flags OPEN issues. This skill processes both global and bead-specific fixes listed in the ledger, modifying BEADS.md to progress toward approval without manual editing.

Does bead-fix modify the BEADS_LEDGER.md file during the automation process?

No, bead-fix does not modify BEADS_LEDGER.md during the automation process. It strictly reads OPEN items from the ledger to apply required fixes, ensuring the ledger itself remains unchanged and keeping the bead-review flow intact.

Can I use bead-fix to resolve specific blockers in my markdown ledger?

Yes, you can use bead-fix to resolve specific blockers in your markdown ledger. It processes targeted bead fixes as dictated by BEADS_LEDGER.md, applying the necessary updates to BEADS.md to clear OPEN blockers and should-fixes.

When do I need to run automation to apply should-fixes to my bead ledger?

You need to run automation to apply should-fixes when BEADS_LEDGER.md lists OPEN blockers or should-fixes and BEADS.md requires updating to progress toward approval. This ensures consistent, faster bead updates without manual editing.