Beads Check Dolt Migration

Detect whether a beads repository needs classic-to-Dolt migration or an in-place Dolt schema upgrade.

9 starsOther

Install

skills CLI (Claude Code, Cursor, Codex and more)
npx skills add flurdy/agent-skills --skill beads-check-dolt-migration
Manual install
git clone --depth 1 https://github.com/flurdy/agent-skills.git /tmp/agent-skills
mkdir -p ~/.claude/skills
cp -r /tmp/agent-skills/skills/beads-check-dolt-migration ~/.claude/skills/beads-check-dolt-migration

Personal skills live in ~/.claude/skills. Use .claude/skills in a project folder to share a skill with your team.

From the SKILL.md

# Beads Migration and Schema Check

Read-only detection of whether a repository needs classic-to-Dolt migration, a Dolt schema upgrade, or no action. Reports the current state without changing files, databases, remotes, or Git state.

## When to Use

- Before running `/beads-migrate-to-dolt`
- After upgrading `bd`, especially across a minor or major version
- When `bd` reports pending schema migrations or a remote migration gate
- When `bd` commands fail and the storage format or schema may be stale
- When onboarding to a repo with beads

## Instructions

### 1. Check for Beads Installation

```bash
ls -la .beads/ 2>/dev/null
```

If no `.beads/` directory exists, report "No beads installation found" and stop.

### 2. Detect Storage Format

On-disk inspection is authoritative:

```bash
# Classic format indicators
test -f .beads/beads.db && echo "FOUND: SQLite database"
test -f .beads/issues.jsonl && echo "FOUND: JSONL issues file"

# Dolt format indicators
test -d .beads/dolt && echo "FOUND: server-mode Dolt directory"
test -d .beads/embeddeddolt && echo "FOUND: legacy embedded-Dolt directory"
test -f .beads/metadata.json && cat .beads/metadata.json
```

`issues.jsonl` is not proof of classic storage: modern bd can export JSONL for interchange while Dolt remains authoritative.

### 3. Check Configuration, Remotes, and Worktrees

**Safety gate before store-opening probes:** bd may auto-migrate on store open. On an old,
Read the full skill on GitHub

Details

Skill name
beads-check-dolt-migration
Path
skills/beads-check-dolt-migration/SKILL.md
License
MIT
Repo updated
17 November 2026

FAQ

What does the Beads Check Dolt Migration skill do?

Detect whether a beads repository needs classic-to-Dolt migration or an in-place Dolt schema upgrade.

How do I install the Beads Check Dolt Migration skill?

skills CLI (Claude Code, Cursor, Codex and more): npx skills add flurdy/agent-skills --skill beads-check-dolt-migration. Skills go in ~/.claude/skills (personal) or .claude/skills (project), and Claude loads them automatically when a task matches the description.

Is Beads Check Dolt Migration popular?

It lives in flurdy/agent-skills, which has 9 GitHub stars and 0 forks.

Related skills

Browse the most popular Claude skills, all other skills, or write your own with the skills generator.