dirty-repo-bootstrap

Official

Safely snapshot and recover dirty repos.

Software Engineering #git #beads #bd #snapshot #dirty-repo #wip

Authorstars-end

Version1.0.0

Installs0

System Documentation

What problem does it solve?

Safe recovery procedure for dirty/WIP repositories. This skill provides a standardized workflow for:

Snapshotting uncommitted work to a WIP branch
Pushing the snapshot to origin for safety
Handling Beads-tracked repositories correctly
Recovering from repository corruption

Non-negotiables:

Do NOT stash by default - snapshot to a branch and push
Do NOT print secrets (bearer tokens, headers, etc.)
Warning-only locally; CI can fail-loud

Core Features & Use Cases

Snapshot uncommitted work to a WIP branch and push
Beads-aware handling of .beads/issues.jsonl
Safe recovery from corrupted or dirty repositories
Beads integration checks and optional sync prior to commit

Quick Start

Quick Recovery (Copy/Paste) ~/.agent/skills/dirty-repo-bootstrap/snapshot.sh

Manual Recovery Flow

Check git status
Create a WIP branch named with hostname/date/repo
Sync Beads if .beads/issues.jsonl is modified (bd sync)
Commit all changes and push the WIP branch
Return to previous branch or main

Dependency Matrix

Required Modules

gitbdjq

Components

scripts

💻 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: dirty-repo-bootstrap
Download link: https://github.com/stars-end/agent-skills/archive/main.zip#dirty-repo-bootstrap

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.