Skills
.Work. You
Rest

unfuck-my-git-state

Community

Recover broken Git state safely and quickly.

Software Engineering#git#repository#worktree#recovery#refs#head
Authorbillyfranklim1
Version1.0.0
Installs0

System Documentation

What problem does it solve?

Diagnose and recover a broken Git state and misconfigured worktree metadata without escalating risk, especially when HEAD is detached, locks exist, or refs are missing.

Core Features & Use Cases

  • Staged, low-risk recovery flow to minimize blast radius and preserve history.
  • Playbooks A–D cover orphaned worktrees, phantom locks, detached HEAD, and missing refs with clear steps and verification.
  • Verification gates ensure repo integrity after each fix before proceeding.

Quick Start

Begin by backing up the repository's .git directory and follow the staged recovery playbooks to repair HEAD and worktree state.

Dependency Matrix

Required Modules

None required

Components

Standard package

💻 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: unfuck-my-git-state
Download link: https://github.com/billyfranklim1/claude-skills/archive/main.zip#unfuck-my-git-state

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.