Agent Skills: Initialize Beads (bd)

Initialize beads issue tracking in a repository

UncategorizedID: michaelvessia/nixos-config/init-bd

Install this agent skill to your local

pnpm dlx add-skill https://github.com/MichaelVessia/nixos-config/tree/HEAD/modules/programs/agents/shared/skills/init-bd

Skill Files

Browse the full folder contents for init-bd.

Download Skill

Loading file tree…

modules/programs/agents/shared/skills/init-bd/SKILL.md

Skill Metadata

Name
init-bd
Description
Initialize beads issue tracking in a repository

Initialize Beads (bd)

Set up beads issue tracking in this repository.

Steps

  1. Initialize beads:

    bd init
    

    This creates .beads/ directory with project database.

  2. Install git hooks (auto-sync on commit):

    bd hooks install
    
  3. Add to agent instructions (CLAUDE.md or AGENTS.md):

    If CLAUDE.md exists, append to it. Otherwise create AGENTS.md.

    Add this snippet:

    ## Issue Tracking
    
    This project uses **bd (beads)** for issue tracking.
    Run `bd prime` for workflow context, or install hooks (`bd hooks install`) for auto-injection.
    
    **Quick reference:**
    - `bd ready` - Find unblocked work
    - `bd create "Title" --type task --priority 2` - Create issue
    - `bd close <id>` - Complete work
    - `bd sync` - Sync with git (run at session end)
    
    For full workflow details: `bd prime`
    
  4. Verify setup:

    bd doctor
    
  5. Summary: Report what was created and next steps.