Skill Detail

Diagnose pathological Git repository size before migration, CI, or contributor onboarding

Uses git-sizer to identify the specific size and history characteristics that make a repository painful to clone, fetch, repack, or work in. Use it when an agent needs evidence about large blobs, oversized trees, too many refs, or other Git pathologies before proposing cleanup.

Runbooks & DiagnosticsMulti-Framework

Uses git-sizer to identify the specific size and history characteristics that make a repository painful to clone, fetch, repack, or work in. Use it when an agent needs evidence about large blobs, oversized trees, too many refs, or other Git pathologies before proposing cleanup.

Runbooks & Diagnostics Multi-Framework Security Reviewed
INSTALL WITH ANY AGENT
npx skills add agentskillexchange/skills --skill diagnose-pathological-git-repository-size-before-migration-ci-or-contributor-onboarding Copy
Tools required
Git 2.6 or newer and a full non-shallow clone of the repository being analyzed
Install & setup
Download the ZIP for your platform from https://github.com/github/git-sizer/releases, unzip it, and move git-sizer into your PATH
Author
GitHub
Publisher
Company

This skill uses git-sizer to inspect a local repository and explain why it has become slow, fragile, or expensive to operate. The tool computes size-related metrics across objects, trees, refs, blobs, path lengths, and history structure, then flags the areas most likely to create operational pain. For an agent, that turns an unfocused complaint like β€œthis repo is miserable to clone” into a concrete diagnostic workflow with measurable findings.

Invoke this before migrating a repository to a new host, before enabling heavier CI on a monorepo, before asking external contributors to clone it, or before deciding whether Git LFS, history rewriting, or repo splitting is justified. An agent can run the tool on a full non-shallow clone, interpret the flagged sections, and translate them into next actions such as pruning stale refs, moving large binary assets to Git LFS, rewriting history to remove oversized blobs, or sharding giant directories. It is especially useful when the team needs to know which class of Git problem they actually have instead of applying random cleanup folklore.

The scope boundary is clear. This is not a Git hosting platform, not a backup tool, and not a general repository maintenance suite. It does one narrow job well: diagnose repository size pathologies so later remediation work is targeted. Integration points include migration runbooks, repository health checks, Git LFS adoption decisions, git-filter-repo cleanup work, and CI guardrails that fail when repositories cross size thresholds that hurt developer experience.