gitfx-storylisted
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