Przejdź do treści
Biblioteka skilli
Programowanie · Analiza

git-rescue

/git-rescue

Odzyskuje pracę po błędach w git, np. po reset --hard czy usuniętej gałęzi, diagnozując repozytorium i stosując poprawkę po zgodzie.

Repozytorium
git-rescue ↗
Licencja
MIT
Ostatnia zmiana repozytorium
12.11.2026

Ocena i bezpieczeństwo

100/ 100Klasa: dobry
Format25 / 25
Frontmatter z nazwą i opisem, poprawna nazwa, opis do 1024 znaków, nazwa zgodna z folderem.
Odkrywalność25 / 25
Opis mówi, kiedy użyć skilla, ma sensowną długość i jest w 3. osobie.
Treść35 / 35
Co najmniej 150 słów i do 500 linii, nagłówki, listy kroków, przykłady albo kod.
Higiena15 / 15
Bez zaślepek typu TODO, bez ścieżek Windows, z licencją.
Ryzykobrak sygnałów w skanie
Pliki w paczce
1
Skrypty
0
Komentarze HTML
0
Adresy URL w SKILL.md
1
Przestarzałość

Brak sygnałów. Repozytorium zmienione 12.11.2026, bez odwołań do wycofanych modeli i API.

Licencja

MIT, otwarta: można używać i zmieniać, z zachowaniem informacji o autorze.

Co robi i kiedy

Odzyskuje pracę po błędach w git, np. po reset --hard czy usuniętej gałęzi, diagnozując repozytorium i stosując poprawkę po zgodzie.

Wyzwalacze z opisu

how do I undo that
Oryginalny opis (EN)

Recover from git accidents with git-rescue. Use when the user says they messed up git or lost work, for example after reset --hard, a deleted branch, a dropped stash, a rebase or merge stuck or gone wrong, commits on a detached HEAD, files they staged and then lost, or "how do I undo that". It diagnoses the repository, explains what happened, and applies a fix only after the user agrees, with a backup and an undo.

Jak działa

  1. First: do not destroy the evidence
  2. 1. Diagnose
  3. 2. Explain before acting
  4. 3. Apply only with the user's yes
  5. Lost files: search and restore
  6. Rules
Sekcje z nagłówków SKILL.md, w oryginale · 85 linii, 633 słów
Podgląd SKILL.md
---
name: git-rescue
description: Recover from git accidents with git-rescue. Use when the user says they messed up git or lost work, for example after reset --hard, a deleted branch, a dropped stash, a rebase or merge stuck or gone wrong, commits on a detached HEAD, files they staged and then lost, or "how do I undo that". It diagnoses the repository, explains what happened, and applies a fix only after the user agrees, with a backup and an undo.
license: MIT
compatibility: Needs Node 18+ and git 2.17+ on the machine. Runs git-rescue with npx from GitHub (github:zch6a/git-rescue) unless a git-rescue command is installed.
metadata:
  homepage: https://github.com/zch6a/git-rescue
---

# Getting someone's work back with git-rescue

git-rescue reads a repository's state (reflogs, the files git leaves mid-rebase or merge, objects nothing points
to) and reports what went wrong, each finding with the commits involved and options with exact git commands. It
changes nothing unless told to, backs up every branch, HEAD and uncommitted work before a fix, and can undo it.

## First: do not destroy the evidence

Until the diagnosis is done, do not run anything that rewrites refs or deletes objects: no `git gc`, `git prune`,
`git reflog expire`, `git reset`, `git checkout -- .`, `git clean`, `git stash drop`, `git rebase --abort`. Lost
commits and staged files live as objects that `gc` deletes. If an operation is stuck halfway, leave it as it is:
git-rescue reports it and saves the edits before abandoning it.

## 1. Diagnose

In the repository the user means (use `-C <path>` if it is not the current directory):

```bash
npx -y github:zch6a/git-rescue --json
```

Use `git-rescue --json` instead if the command is installed. The output is one JSON object:
`{format, version, state, findings}`. Exit status 0 means nothing wrong, 1 something to look at, 2 could not run
(not a repository, or no Node/git; tell the user).

Each finding has `id`, `key`, `level` (`problem`, `warning`, `info`), `title`, `detail`, `commits`, and
`options`; each option has `title`, `risk` (`safe`, `careful`, `manual`) and `steps` (git's arguments, one list per
command; a one-string step with spaces is something the person does).

## 2. Explain before acting

Tell the user, in plain words, what each finding means for them, most serious first: which commits or files are
at stake (the `detail` names them), and the options with their risk. `info` findings are usually harmless. If
nothing is wrong, say so. To show what happened recently, in words (each event with where things were before it):

```bash
npx -y github:zch6a/git-rescue timeline --json
```

Recommend the option that matches what they want (usually the `safe` one: keep the commits on a new branch, put a
deleted branch back, restore a stash). Show the exact commands from its `steps`.

## 3. Apply only with the user's yes

Never apply a fix without the user explicitly agreeing to that option. Then apply it by its **key** (numbers shift
after each fix; a key names the same finding or is refused):

```bash
npx -y github:zch6a/git-rescue fix <key>/<letter> --yes
```

For example `fix dropped-by-reset:39f66d49/a --yes`. Report what it printed. Exit 0 means done; 1 means a step
failed or the next step is the user's (for example resolving conflicts: guide them through it); 2 means the key is
no longer there (run the diagnosis again).

After a fix, tell the user it can be taken back:

```bash
npx -y github:zch6a/git-rescue undo --yes
```

Run `undo` only when they ask. It puts back exactly what the fix changed and leaves later work alone.

## Lost files: search and restore

Files the user staged (`git add`) and then lost to `reset --hard` or `checkout .` are in the report as
`lost-staged-files`. Find one by a piece of text they remember, then save it to a **new** file (restore never
overwrites):

```bash
npx -y github:zch6a/git-rescue find "some text they remember" --json
npx -y github:zch6a/git-rescue restore <id> <new-file-name>
```

`find --json` gives `{format, version, text, matches}`; each match has `sha` (the id), `where`, `line`, `text`.

## Rules

- git-rescue never pushes and never fetches. If a fix rewrote commits that were already pushed, tell the user
  that pushing again needs `git push --force-with-lease` and that it is their call.
- Do not delete `refs/rescue/*`, `.git/rescue.log` or `.git/rescue-files/`: they are the backups.
- Files the user never added or committed before a `reset --hard` or `checkout .` cannot come back from git; their
  editor's local history may still have them.

Wersje

W bazie nie ma innych skilli o nazwie git-rescue.

Migawka bazy z 13.11.2026 · wersja paczki 298a712fc99e (skrót SHA-256 całej paczki)

Pobrania w ostatnich 30 dniach: 0 · ranking

Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.

Podobne skille

  • 100git-undo-recovery
    Odzyskuje pracę po błędach git: zgubione commity po reset --hard, usunięte gałęzie, złe scalenia i porzucone stashe.
  • 90Git
    Obsługuje repozytorium Git: commity, gałęzie, merge i rebase, rozwiązywanie konfliktów oraz odzyskiwanie historii po błędzie.
  • 100git-workflow
    Prowadzi przez bezpieczne użycie Git: strategie gałęzi, atomowe commity, conventional commits, interaktywny rebase, wybór merge lub rebase, konflikty i odzyskiwanie utraconej pracy przez reflog.
  • 100git-undo
    Bezpiecznie odzyskuje po błędach w Git: odrzucenie, unstage, amend, reset, revert, odtwarzanie zgubionych commitów przez reflog, usuniętych gałęzi i naprawa złego rebase, wybierając najmniej destrukcyjną drogę.
  • 100git
    Prowadzi przez codzienną pracę z Gitem i odzyskiwanie: status, diff, log, gałęzie, commity, merge i rebase, cofanie błędów, rozwiązywanie konfliktów i przeglądanie historii.
  • 100koopa-git-recovery
    Diagnozuje i naprawia typowe wypadki ze stanem git: reset na złej gałęzi, skutki aliasów, kolizje plików nieśledzonych przy checkout i porządkowanie stash.

Uwagi i zgłoszenia

Wiadomość trafi do Bartosza Sokolińskiego. Adres e-mail jest potrzebny tylko do odpowiedzi. Szczegóły w polityce prywatności.