ls-git-broken-state-recovery SKILL.md skillA
ls-git-broken-state-recovery from cruxexperts/localsetup is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.
mdr add cruxexperts/localsetup/ls-git-broken-state-recovery@v1.3Pins v1.3 in mdr.lock. Pin the fingerprint instead.
- Audit grade
- A, 17 of 17 checks passed
- Kind
- SKILL.md skill
- Repository
- cruxexperts/localsetup
- Path
ls/skills/ls-git-broken-state-recovery/SKILL.md- Versions recorded
- 1
- Latest version
- v1.3, committed Oct 21, 2026
- Size
- 8,620 bytes
- Repository stars
- 6
- License
- a license file GitHub does not identify
Diagnose and recover broken Git state and worktree metadata with a staged, low-risk recovery flow. Use when Git reports detached or contradictory HEAD state, phantom worktree locks, orphaned worktree entries, missing refs, 0000000000000000000000000000000000000000 hashes, or branch operations fail with errors like already checked out, unknown revision, not a valid object name, or cannot lock ref.
Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.
What the file says
# Unfuck My Git State Recover a repository without making the blast radius worse. ## Core Rules 1. Snapshot first. Do not "just try stuff." 2. Write evidence only beneath the controller-assigned `.agents/state/<task-slug>/` directory. 3. Resolve the per-worktree and common Git directories; never assume `.git` is a directory. 4. Prefer non-destructive fixes before force operations. 5. Inspect reflog and create rescue refs before moving a branch pointer. 6. Create and verify a metadata backup before any manual metadata edit. 7. Obtain point-of-risk confirmation for the exact target and values before a force or manual edit. 8. After each fix, run verification before proceeding. ## Rule Ownership This skill owns Git repair and broken-state recovery behavior. Public maintenance docs can point here, but recovery agents should load this skill before touching Git metadata, index files, worktree metadata, or refs. - Use ordinary `ls-git-merge-rebase` for healthy advanced Git operations. - Use this skill when Git commands report contradictory state, missing objects, broken index/cache-tree data, zero hashes, or stale worktree locks. …
Read the whole file at its exact version.
How to install
mdr add cruxexperts/localsetup/ls-git-broken-state-recovery@sha256:77773b275a33331fThe line at the top of this page pins the label v1.3, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.
[](https://markdownregistry.com/a/art_fqpqebdzcewuyc2e)
2 badge image fetches in 30 days. What the badge shows.
Versions
The registry has recorded 1 version of this file, committed on Oct 21, 2026.
Audit of the latest version
- pass: Frontmatter block present
- pass: Frontmatter declares a name
- pass: Frontmatter declares a description
- pass: Size between 200 bytes and 200 KB (8620 bytes)
- pass: No zero-width or bidi control characters
- pass: No instruction hidden inside an HTML comment
- pass: No link to an exfiltration or paste host
- pass: No credential-shaped string
- pass: No instruction to send local credentials anywhere
- pass: No text hidden with inline styles
- pass: No prompt-injection phrasing
- pass: No curl or wget piped into a shell
- pass: No recursive delete of root, home or parent
- pass: No instruction to read or print local credentials
- pass: No base64 blob over 200 characters
- pass: No link to a raw IP address
- pass: No script tag
Source
cruxexperts/localsetup · 6 stars · license a license file GitHub does not identify · pushed 2026-11-05 · branch main
API
GET https://markdownregistry.com/api/v1/artifacts/art_fqpqebdzcewuyc2e GET https://markdownregistry.com/api/v1/resolve?ref=cruxexperts/localsetup/ls-git-broken-state-recovery GET https://markdownregistry.com/api/v1/blob/77773b275a33331fb4257af907ce5fec7d1668eb6847528adb6f895a2fe2e030
Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.
Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.