project-init

Automate Beads/Dolt database setup and recovery workflows.

1|Updated Jul 7, 2026
One-click install
npx skills add https://github.com/the-inconvenience-store/superbeads --skill project-init-the-inconvenience-store
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: project-init
Source: https://github.com/the-inconvenience-store/superbeads/tree/main/skills/project-init
Command: npx skills add https://github.com/the-inconvenience-store/superbeads --skill project-init-the-inconvenience-store

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires beads, dolt, and includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill automates the setup and recovery workflows for the Beads/Dolt database, addressing issues like initialization failures, missing databases, and diverged history.

Core Features & Use Cases

  • Database Initialization: Handles fresh initialization, bootstrap from remote, and recovery workflows.
  • Diagnostic Phase: Provides a diagnostic phase to understand the current state before taking action.
  • Decision Matrix: Offers a decision matrix based on diagnostic results to guide the appropriate action.
  • Paths for Recovery: Provides step-by-step instructions for different recovery scenarios like fresh initialization, bootstrap from remote, fixing diverged history, and more.

Quick Start

Run the project-init skill to set up or recover the beads database.

Frequently Asked Questions about project-init

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

FAQPage Schema
How do I automate Beads database setup and initialization?

To automate Beads database setup, you can use a workflow that handles fresh initialization via the bd init command, ensuring your local Dolt environment is configured correctly without manual database creation.

What is the best way to fix a diverged Beads database history?

The best way to fix diverged Beads database history is to run a diagnostic phase first, then follow a decision matrix that guides you through specific recovery paths to reconcile the history and restore sync.

How do I bootstrap a Dolt database from a remote repository?

You can bootstrap a Dolt database from a remote repository by executing the bd bootstrap command, which pulls the remote state and configures your local database to match the upstream version.

Do I need to run diagnostics before recovering a missing Beads database?

Yes, you need to run diagnostics before recovering a missing Beads database because the diagnostic phase evaluates the current state and provides a decision matrix to determine whether to initialize fresh or bootstrap.

Why does my Beads database initialization fail and how can I troubleshoot it?

Your Beads database initialization might fail due to environment misconfiguration or missing dependencies, which you can troubleshoot by running the bd doctor command to diagnose issues and follow the recovery decision matrix.

Can I use bd doctor to diagnose Dolt database recovery issues?

Yes, you can use bd doctor to diagnose Dolt database recovery issues, as it provides diagnostic tools that evaluate your current database state and output actionable steps for troubleshooting.