codebase-time-machine skill
scriptsTells the story of a codebase from its git history as an entertaining documentary, with eras, key contributors, plot twists (reverts, giant commits, long silences), cursed files, and the current state, backed by a git analysis script. Useful for onboarding, retrospectives, anniversaries, and fun. Use when the user asks for the history of a repo, how a project evolved, a repo story or timeline, or "who built what and when".
- GitHub stars
- 5
- Files
- 2
- Last commit
- Nov 4, 2026
- License
- MIT
- Allowed tools
- —
What does the codebase-time-machine skill do?
codebase-time-machine tells the story of a codebase from its git history as an entertaining documentary, with eras, key contributors, plot twists (reverts, giant commits, long silences), cursed files, and the current state, backed by a git analysis script. Useful for onboarding, retrospectives, anniversaries, and fun. Use when the user asks for the history of a repo, how a project evolved, a repo story or timeline, or "who built what and when".
How to install the codebase-time-machine skill
Each command copies the skill folder into the client's skills directory. Restart the client or start a new session to load it.Install the codebase-time-machine skill in Plugin
/plugin marketplace add milad-ahmd/agent-skills /plugin install all-skills@milad-agent-skills
Install the codebase-time-machine skill in Claude Code
~/.claude/skills/codebase-time-machine/SKILL.md
$ npx degit milad-ahmd/agent-skills/skills/codebase-time-machine ~/.claude/skills/codebase-time-machineInstall the codebase-time-machine skill in Claude Code (project)
.claude/skills/codebase-time-machine/SKILL.md
$ npx degit milad-ahmd/agent-skills/skills/codebase-time-machine .claude/skills/codebase-time-machineInstall the codebase-time-machine skill in Codex
~/.agents/skills/codebase-time-machine/SKILL.md
$ npx degit milad-ahmd/agent-skills/skills/codebase-time-machine ~/.agents/skills/codebase-time-machineInstall the codebase-time-machine skill in Gemini CLI
~/.gemini/skills/codebase-time-machine/SKILL.md
$ npx degit milad-ahmd/agent-skills/skills/codebase-time-machine ~/.gemini/skills/codebase-time-machineInstall the codebase-time-machine skill in Claude.ai
npx degit milad-ahmd/agent-skills/skills/codebase-time-machine codebase-time-machine && zip -r codebase-time-machine.zip codebase-time-machine # claude.ai → Customize → Skills → + → Create skill → Upload a skill → codebase-time-machine.zip
SKILL.md
View on GitHubCodebase Time Machine ⏳
"In the beginning, there was Initial commit…"
1. Collect the facts
python3 scripts/git_timeline.py [path/to/repo] # defaults to current directory
python3 scripts/git_timeline.py . --max 5000 # limit for huge repos
git -C <repo> tag --sort=creatordate | tail -20 # releases, if any
The script reports the span, commits per year, top authors, the biggest commits, the most-changed ("cursed") files, reverts and hotfixes, and the longest silence. Read key commits (git show --stat <hash>) before narrating them.
2. Narrate (default style: nature documentary; also epic, noir, sports commentary or plain)
# 🎬 <Project>: The Story So Far
## Prologue: <first commit date, first message, first files>
## Chapter 1: <era name> (<years>): what was built, by whom, defining commits
## Chapter 2: ... (split eras by activity bursts, long gaps, big refactors, major tags)
## 🎭 The Cast: top contributors and what they shaped (no judgments about people)
## 🌪️ Plot Twists: reverts, giant commits, the great silence of <dates>
## 👻 Cursed Files: most-changed files and why they keep changing
## 📍 Present Day: current state, active areas
## 🧭 Lessons for newcomers: where the dragons are, what to read first
Rules
- Facts come only from git. Quote commit messages exactly, with their short hashes. Speculation is labelled as such ("probably", "it seems").
- Be kind about people. Celebrate them; never mock them. Don't print email addresses.
- For private or company repos, ask before producing anything meant to be shared publicly.
Files in this skill
2codebase-time-machine skill questions
How do I install the codebase-time-machine skill in Claude Code?
Run npx degit milad-ahmd/agent-skills/skills/codebase-time-machine ~/.claude/skills/codebase-time-machine. Claude Code loads skills from ~/.claude/skills (all projects) or .claude/skills (one project) and uses a skill when its description matches the task.
Which clients can use the codebase-time-machine skill?
Any client that reads the Agent Skills format: Claude Code, Codex, Gemini CLI and claude.ai (upload as a ZIP). Scripts in the skill run only where the client allows code execution.