repo-timelinelisted
Install: claude install-skill mostafa-drz/claude-skills
# Repo Timeline
Visualize the history of a repository or branch as a meaningful, grouped timeline — not raw git log, but an engineer-friendly narrative of what changed, when, and why.
## Preferences
_On startup, use the Read tool to load `~/.claude/skills/repo-timeline/preferences.md`. If it doesn't exist, use defaults._
## Context
_On startup, use Bash to detect: current git branch, repo root (`git rev-parse --show-toplevel`), repo name (`basename $(git rev-parse --show-toplevel)`), remote URL (`git remote get-url origin`), and GitHub repo name (`gh repo view --json nameWithOwner -q .nameWithOwner`). Skip any that fail._
## Command routing
Check `$ARGUMENTS`:
- **`help`** → display help then stop
- **`config`** → interactive setup then stop
- **`reset`** → delete `~/.claude/skills/repo-timeline/preferences.md`, confirm, stop
- **branch name** — if argument looks like a branch name (no `--` prefix), use it as the target branch
- **flags** — parse `--since`, `--until`, `--focus`, `--depth`, `--sources`
- **empty** — use current branch with defaults
### Flags
Parse from `$ARGUMENTS`:
- **`--since <time>`** — start of time range (e.g., "2 weeks ago", "2026-01-01", "last tag")
- **`--until <time>`** — end of time range (defaults to now)
- **`--focus <areas>`** — comma-separated paths or areas to emphasize (e.g., "api,auth,frontend")
- **`--depth brief|detailed`** — "brief" for one-liners, "detailed" for full descriptions (default from preferences)
- **`--sources <list>`