Git Project Status

Git Project Status Skill

Generate a comprehensive status report for one or more git repositories.

Usage

Path resolution (in priority order):

1. Full path provided — use it directly
2. Only a project name mentioned (e.g. "check pi-crm-personal") — look in /Users/espen/Dev/<project-name>
3. No path or name specified — use the current working directory (.)

Never ask the user for a path — resolve it using the rules above and run the report. The skill produces a structured report for each repo.

Report Structure

Each report MUST include these sections in order. Sections marked (Conditional) are only included when the relevant tool/data is available.

1. Overview

• Project name (from directory name or package.json/Cargo.toml/pyproject.toml)
• Version (from package manifest if available)
• Brief description (from README.md first paragraph, or package manifest description)
• When the project was started (first commit date)
• Current branch and whether working tree is clean/dirty
• Repo visibility (public/private) — if GitHub origin is detected

2. Branches

• Current branch name (highlighted with *)
• List all local branches with:
  • How far ahead/behind the default branch (main/master) each branch is
  • Last commit date on each branch
• Flag stale branches (no commits in >30 days) with ⚠
• Show total branch count

Format example:

Branches (4 total) * feature/typescript-refactor +12 ahead, 3 behind main (last: 2h ago) main up to date (last: 3d ago) fix/webhook-retry +2 ahead (last: 5d ago) old/experiment +1 ahead (last: 45d ago) ⚠ stale

3. Progress (Commit History)

• Total commit count
• Date range of commits
• A table of recent commits (up to 5) showing:
  • Short hash (6 chars)
  • Commit message (first line, truncated to fit column)

Format as a simple two-column list — hash followed by message. Truncate long messages with "…".

d7bd8b feat: Integrate pi-crm-personal extension e0469f deps: Add pi-crm-personal as file: dependency 6638a4 fix(heartbeat): normalize db health-check path in checklist 8770c4 chore: update agent name note and add start:tui script bedca7 Merge 'hannah/td-2f5211-workon' — workon tool, cross-proj…

4. Codebase Overview

• Total lines of code and total number of source files
• Language breakdown by percentage of lines (show as a compact bar or list)

Format example:

Codebase (3,420 lines across 18 files) TypeScript 82% ████████████████░░░░ 2,804 lines HTML 9% ██░░░░░░░░░░░░░░░░░░ 308 lines SQL 5% █░░░░░░░░░░░░░░░░░░░ 171 lines Shell 4% █░░░░░░░░░░░░░░░░░░░ 137 lines

Counting rules:

• Group by language, not file extension (e.g. .ts and .tsx both count as TypeScript, .js and .jsx as JavaScript)
• Always exclude: node_modules, .git, vendor, dist, build, target, pycache, .next, .nuxt, coverage, lock files
• Also exclude generated files (*.min.js, *.map, *.d.ts)
• Use a simple bar visualization (█ and ░) — 20 chars wide, proportional to percentage

5. GitHub Activity (Conditional)

Only include this section if the git remote origin points to GitHub (github.com) AND the gh CLI is available and authenticated.

Detect GitHub origin:

git remote get-url origin 2>/dev/null | grep -q "github.com"

Check gh is available and authenticated:

gh auth status 2>/dev/null

If both conditions are met, include:

Open Pull Requests

gh pr list --state open --json number,title,headRefName,author,reviewDecision,statusCheckRollup,updatedAt --limit 20

Show for each PR:

• PR number and title
• Branch name
• Author
• Review status (APPROVED, CHANGES_REQUESTED, REVIEW_REQUIRED, or pending)
• CI check status (passing ✅, failing ❌, pending ⏳)

Open Issues

gh issue list --state open --json number,title,labels,assignees,createdAt --limit 20

Show for each issue:

• Issue number and title
• Labels
• Assignee (if any)

Recent Merged PRs

gh pr list --state merged --json number,title,mergedAt,author --limit 5

Show the 5 most recently merged PRs with merge date.

CI/CD Status

gh run list --limit 5 --json databaseId,displayTitle,status,conclusion,headBranch,createdAt

Show the 5 most recent workflow runs with:

• Workflow name
• Branch
• Status/conclusion (success ✅, failure ❌, in_progress ⏳, cancelled ⊘)
• When it ran

If gh is not available or not authenticated, skip this entire section silently (do not show an error or placeholder).

6. Dependencies Health (Conditional)

Only include if the project has a dependency manifest.

Check for outdated packages based on project type:

• Node.js (package.json exists):

  npm outdated --json 2>/dev/null

  Show: package name, current version, wanted version, latest version. Highlight major version bumps.

• Rust (Cargo.toml exists):

  cargo outdated 2>/dev/null

• Python (requirements.txt or pyproject.toml exists):

  pip list --outdated --format=json 2>/dev/null

• Go (go.mod exists):

  go list -u -m all 2>/dev/null

Format as a compact table if there are outdated deps:

Dependencies (3 outdated of 24 total) typescript 5.3.3 → 5.6.2 (major) eslint 8.56.0 → 8.57.0 (minor) @types/node 20.11 → 20.14 (minor)

If all dependencies are up to date, say "All N dependencies are up to date." If the outdated check tool is not available, skip gracefully.

7. Issues / Errors

Run appropriate type-checking or linting commands based on the project type:

• TypeScript: npx tsc --noEmit 2>&1 (if tsconfig.json exists)
• Python: python -m py_compile on source files, or mypy if configured
• Rust: cargo check 2>&1 (if Cargo.toml exists)
• Go: go vet ./... (if go.mod exists)

If no errors are found, say "No type errors or lint issues detected."

If errors are found:

• Count them
• List unique error types with file locations
• Provide a brief analysis of the root cause

IMPORTANT: Install dependencies first if needed (check for node_modules, etc.) but do so silently. If type-checking tools aren't available or fail to install, skip this section gracefully and note it.

8. TODO / FIXME / HACK Markers

Scan all source files for common debt markers:

grep -rn --include="*.ts" --include="*.tsx" --include="*.js" --include="*.jsx" \
  --include="*.py" --include="*.rs" --include="*.go" \
  -E "(TODO|FIXME|HACK|XXX|WORKAROUND|TEMP)(\(|:| )" . \
  --exclude-dir=node_modules --exclude-dir=.git --exclude-dir=dist --exclude-dir=build

Format as a compact list grouped by marker type:

Code Markers (7 found) TODO (4): src/db.ts:42 — add migration rollback support src/tool.ts:118 — handle edge case for empty contacts src/web.ts:55 — add pagination src/web.ts:201 — rate limiting FIXME (2): src/registry.ts:88 — race condition on concurrent register src/tool.ts:340 — incorrect type cast HACK (1): src/db.ts:167 — temporary workaround for SQLite locking

If none found, say "No TODO/FIXME/HACK markers found."