← ClaudeAtlas

gitfx-storylisted

Writes a one-page "state of this codebase" briefing from git history for a newcomer, a new tech lead or an acquirer: the top hotspots, the coupling clusters, the ownership risks and five suggested first reads. It runs the three forensics scripts and reads only their reports. Use when the user says "brief me on this codebase", "state of this repo", "onboarding overview", "due diligence on this code", "where should a new hire start reading", or "give me the story of this repository".
vivekbhange-hub/git-forensics-skill · ★ 0 · Code & Development · score 75
Install: claude install-skill vivekbhange-hub/git-forensics-skill
# gitfx-story: the codebase on one page A new reader needs to know three things fast: where the trouble is, what is secretly connected, and whose head holds what. This skill runs the three analysis scripts that live in the sibling skill folders and turns their reports into one page. It adds no script of its own. ## Inputs - A path inside a git repository (default: the current folder), full history, not shallow. - Optional: the reader (new hire, tech lead, acquirer), a window (default `--since "12 months ago"`), and the question they care about most. - This skill calls scripts from sibling skill folders, so install the whole pack, not this skill alone. Commands below say `python3`; on Windows use `python` (or `py -3`). ## Outputs - `gitfx/story.md` (or the path the user prefers): at most one page with five parts: overview, hotspots, coupling, ownership and first reads. - In chat: the three sentences the reader should remember, and what was not checked. ## Steps 1. **Confirm permission.** Ask once whether the user owns or is authorized to analyse this repository. For due diligence, the seller must have given access. If not, stop. 2. **Check the ground.** `git rev-parse --is-shallow-repository` (must print `false`), `git log --oneline | wc -l` for size (on Windows count with `git rev-list --count HEAD`), and the first and last commit dates. Note the age and the commit rate in one sentence. 3. **Run the three scripts** (sibling folders, relative to this sk