# Commit Archaeologist Agent Skill

> git blame tells you who last changed a line. Commit Archaeologist reconstructs why the line exists.

- Source: https://doutorai.pt/en/apps/commit-archaeologist
- Category: Agent Skills
- Difficulty: Intermediate
- Models: -
- Frameworks: -
- Runs locally?: Needs cloud APIs
- Required keys: None
- License: Apache-2.0
- Site: Doutor AI (https://doutorai.pt/en) - AI tools for small businesses

## Full tutorial

# 🏺 Commit Archaeologist Agent Skill

`git blame` tells you who last changed a line. Commit Archaeologist reconstructs
why the line exists.

Point it at a tracked file and an optional line range. Its local Python script
finds the introducing commit, orders later modifications, classifies commit
messages, summarizes current authorship, detects repeatedly co-changed files,
and flags issue references, reverts, workarounds, temporary choices, and TODOs.
The agent turns that evidence into a readable history and a change-risk note.

![demo](/assets/apps-img/d9c393eaab4eeff7.gif)

## Install

```bash
npx skills add https://github.com/Shubhamsaboo/awesome-llm-apps/tree/main/agent_skills/commit-archaeologist
```

The [skills CLI](https://skills.sh) installs the folder for compatible coding
agents. You can also copy this directory into an agent's skills directory.

## Run

Ask your agent:

> Why does `src/cache.py` lines 40-72 exist, and what should I know before I
> change it?

Or run the deterministic core from a clone of this repository:

```bash
python3 agent_skills/commit-archaeologist/scripts/archaeologist.py \
  /path/to/repo src/cache.py --lines 40-72 --json
```

Omit `--lines` to follow the entire file history. Omit `--json` for a compact
terminal summary.

## Output

The JSON dig report contains:

- the normalized region, historical path aliases, and co-change threshold
- the introducing commit
- an oldest-to-newest timeline with changed files and intent categories
- repeated co-changes and their supporting commits
- current blamed-line counts alongside historical commit counts
- intent signals grounded in commit subjects and bodies

Everything runs locally with Python's standard library and git. The script is
read-only and makes no network calls.

## Verify

```bash
python3 agent_skills/evals/commit-archaeologist/test_archaeologist.py
```

The eval builds its own temporary repository and checks ordering, co-changes,
authorship, intent signals, deterministic JSON, and validation errors.

## Files

```text
commit-archaeologist/
|-- SKILL.md
|-- README.md
|-- scripts/archaeologist.py
`-- references/reading-git-history.md
```

Part of [awesome-llm-apps](https://github.com/Shubhamsaboo/awesome-llm-apps).
Apache-2.0. Last verified: July 2026.

## Save hours every week with AI, no hassle

**Doutor AI** gives you 1,859 ready-to-copy AI prompts, by industry and in plain English - plus a complete technical library for those who want to go further. [See plans →](https://doutorai.pt/en/pricing)

---
Content by Doutor AI (https://doutorai.pt/en). When quoting, please cite the source: https://doutorai.pt/en/apps/commit-archaeologist