skills.rest
stars-end
stars-endOFFICIAL
Explore all skills by this author →
GitHub

dirty-repo-bootstrap

Snapshot uncommitted git work to a WIP branch and push to origin.

Updated Aug 23, 2026
Search Tags:#git#beads#bd#snapshot#dirty-repo#wip
One-click install
npx skills add https://github.com/stars-end/agent-skills --skill dirty-repo-bootstrap
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: dirty-repo-bootstrap
Source: https://github.com/stars-end/agent-skills/tree/main/dirty-repo-bootstrap
Command: npx skills add https://github.com/stars-end/agent-skills --skill dirty-repo-bootstrap

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires git, bd, jq, and includes scripts (resource) components.

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

Frequently Asked Questions about dirty-repo-bootstrap

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

FAQPage Schema
How do I safely snapshot uncommitted changes in a git repository?▼

Snapshot uncommitted work to a WIP branch using dirty-repo-bootstrap, which creates an auto-named branch (hostname/date/repo), commits all changes, and pushes to origin—avoiding stash and ensuring recovery safety without losing work.

Can I recover a dirty git repository without losing work?▼

Yes. dirty-repo-bootstrap provides safe recovery for repositories with uncommitted changes or corruption by snapshotting to a pushed WIP branch, validating each step, and returning you to your previous branch or main.

How do I handle Beads-tracked repositories when snapshotting?▼

dirty-repo-bootstrap detects modified .beads/issues.jsonl, runs bd sync automatically before committing, and ensures Beads state stays synchronized across your snapshot and push workflow.

What's the safest way to prepare a dirty repository for destructive operations?▼

Use dirty-repo-bootstrap to snapshot all uncommitted work to a pushed WIP branch with clear exit codes and validation, giving you a recovery point before making irreversible changes.

Do I need git and jq installed to use dirty-repo-bootstrap?▼

Yes. dirty-repo-bootstrap requires git, bd (Beads), and jq as dependencies to snapshot, validate repository state, and handle Beads synchronization correctly.

What happens if my repository is corrupted—can this help me recover?▼

dirty-repo-bootstrap includes robust validation and recovery workflows for corrupted or dirty repositories, detecting state issues and providing clear error codes to guide safe recovery steps.

Related Skills

Explore More Software Engineering Skills→
justin-delanojustin-delano
1

beads-init

Initialize beads issue tracking with manual staging control over .beads/*.jsonl.

Community
Intermediate
cacr92cacr92
4

auto-merge-and-cleanup

Merge a feature branch into main and clean up branches and worktree.

Community
Advanced
mistakeknotmistakeknot
2

ship

Automate Git commit, push, bead closing, and synchronization for session closure.

Community
Intermediate
ReidondReidond

branch-switch

Switch Git branches while preserving uncommitted changes via stashes.

Community
Advanced