Home / alexhawat / mergecraft · src/mergecraft/skills/git-archaeology/SKILL.md · GitHub

git-archaeology skillA

git-archaeology is agent-read markdown (skill) from alexhawat/mergecraft: Investigate how code reached its current state — when a line, function, import, or whole file was changed or deleted, who removed it, and what it looked like before. Use when `git blame` came up empty, when content has been refactored away, or when you need the full evolution of a function across commits..

Indexed from public GitHub and served as immutable, content-addressed versions. Install it pinned to an exact SHA-256 with the mdr CLI, and every file is verified against the hash recorded here before it reaches your agent. The deterministic audit below grades the latest version, and the same file always earns the same grade.

What the file says

# Git history archaeology

`git blame` only sees what's still in the working tree. For anything that was
deleted, moved, or refactored away, you need the commands below. Most agents
under-use them and end up scrolling through `git log -p` instead.

## Output discipline (read first)

`git log -p` on a long-lived file can dump tens of thousands of lines and blow
the context window. Always:

1. **Start narrow.** Use `--oneline` or `--stat` to get a list of candidate
   commits.
2. **Drill in.** Use `git show <sha> -- <path>` for the diff of one specific
   commit.
3. **Scope the search.** Add `--since="3 months ago"`, `-n 20`, or a path
   restriction (`-- <path>`) so output stays manageable.
4. **Avoid `git log -p` without a path filter** on any non-trivial repo.

## Decision tree (by agent intent)

### "When did this exact line, string, or import disappear?"

```bash
git log -S'<exact-string>' --oneline -- <file>
```

The pickaxe. Returns commits that **changed the count** of that string in the
file. The most recent hit is typically the removal commit. Add `-p` only after
you've narrowed to a few candidates.

Notes:
…

Read the whole file at its exact version.

How to install

Latest version
mdr add alexhawat/mergecraft/git-archaeology@git:20260728.b8e83a8
Exact content
mdr add alexhawat/mergecraft/git-archaeology@sha256:44e5cadde56f4099

Pin to a label to follow the author's releases, or to a sha256 to freeze the exact bytes forever. Either way the resolved hash is written to mdr.lock, and mdr install reproduces it on any machine.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_axynzvgyh6zk5w7i.svg)](https://markdownregistry.com/a/art_axynzvgyh6zk5w7i)

1 badge views in 30 days

Versions

versioncommittedcommitsizeaudit
git:20260728.b8e83a8 latest2026-07-28 b8e83a8 7,129 BA view

Audit of the latest version

A  17 of 17 checks passed. Deterministic, no model, same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (7129 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

GitHub

alexhawat/mergecraft · 11 stars · license MIT · pushed 2026-09-23 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_axynzvgyh6zk5w7i
GET https://markdownregistry.com/api/v1/resolve?ref=alexhawat/mergecraft/git-archaeology
GET https://markdownregistry.com/api/v1/blob/44e5cadde56f409963f82e15b3f4883780c986b10314d604e31d9bc99b1f6148

Your agent 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.

More from alexhawat/mergecraft

code-review skill
alexhawat/mergecraft · .github/skills/code-review/SKILL.md · Reviews a pull request or diff in the mergeCraft repository and produces typed, evidence-backed findings with a…
git:20260910.99ce63d · audit A · 11 stars
AGENTS.md agents
alexhawat/mergecraft · AGENTS.md
git:20260922.3ffdd69 · audit A · 11 stars
llms-full.txt llmstxt
alexhawat/mergecraft · llms-full.txt
git:20260922.3ffdd69 · audit B · 11 stars
llms.txt llmstxt
alexhawat/mergecraft · llms.txt
git:20260901.f17f2c3 · audit A · 11 stars
mergecraft skill
alexhawat/mergecraft · skills/claude-code/mergecraft/SKILL.md · Set up, run, and troubleshoot mergeCraft — the BYOK AI PR review GitHub
git:20260921.fc1ed4b · audit A · 11 stars
mergecraft skill
alexhawat/mergecraft · skills/codex/mergecraft/SKILL.md · Set up, run, and troubleshoot mergeCraft — the BYOK AI PR review GitHub
git:20260921.fc1ed4b · audit A · 11 stars
mergecraft skill
alexhawat/mergecraft · skills/copilot/mergecraft/SKILL.md · Set up, run, and troubleshoot mergeCraft — the BYOK AI PR review GitHub
git:20260921.fc1ed4b · audit A · 11 stars
mergecraft skill
alexhawat/mergecraft · skills/cursor/mergecraft/SKILL.md · Set up, run, and troubleshoot mergeCraft — the BYOK AI PR review GitHub
git:20260921.fc1ed4b · audit A · 11 stars
mergecraft skill
alexhawat/mergecraft · skills/gemini-cli/mergecraft/SKILL.md · Set up, run, and troubleshoot mergeCraft — the BYOK AI PR review GitHub
git:20260921.fc1ed4b · audit A · 11 stars
mergecraft skill
alexhawat/mergecraft · skills/grok-bot/mergecraft/SKILL.md · Set up, run, and troubleshoot mergeCraft — the BYOK AI PR review GitHub
git:20260921.fc1ed4b · audit A · 11 stars
mergecraft skill
alexhawat/mergecraft · skills/hermes/mergecraft/SKILL.md · Set up, run, and troubleshoot mergeCraft — the BYOK AI PR review GitHub
git:20260921.fc1ed4b · audit A · 11 stars
mergecraft skill
alexhawat/mergecraft · skills/mergecraft/SKILL.md · Set up, run, and troubleshoot mergeCraft — the BYOK AI PR review GitHub Action and CLI. Use when the user asks to…
git:20260921.fc1ed4b · audit A · 11 stars

Every file in alexhawat/mergecraft

Browse by kind, by grade A, or by owner.