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.

Install

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

The skills CLI 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:

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

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

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

Part of awesome-llm-apps.

Apache-2.0. Last verified: July 2026.