skills.rest
parisgroup-ai
parisgroup-aiOFFICIAL
Explore all skills by this author →
GitHub

project-stats

Generate JSON project statistics reports from git repositories.

1|2|Updated Apr 6, 2026
Search Tags:#monorepo#repo-analysis#loc#git-metrics#project-stats#codebase-metrics#automated-reporting
One-click install
npx skills add https://github.com/parisgroup-ai/imersao-ia-setup --skill project-stats
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: project-stats
Source: https://github.com/parisgroup-ai/imersao-ia-setup/tree/main/skills/project-stats
Command: npx skills add https://github.com/parisgroup-ai/imersao-ia-setup --skill project-stats

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires python3, git, and includes scripts (resource) components.

What problem does it solve?

Projects and repositories lack a fast, consistent way to measure codebase size, language composition, git activity, test coverage proxies, dependencies, and infrastructure signals and to compare those metrics over time for observable trends and health checks.

Core Features & Use Cases

  • Automated collection: Runs a portable shell collector to produce a structured JSON snapshot of a repository including LOC, file counts, test files, and dependency counts.
  • Git & activity insights: Reports commit totals, recent velocity, contributors, branches, tags, commit-type breakdowns and AI-collaboration metrics.
  • Monorepo and framework detection: Detects common monorepo tools, workspace counts, frameworks, Dockerfiles, and basic i18n statistics for comparison across releases.
  • Comparative reporting: Finds the most recent previous report and computes deltas, presenting a formatted markdown report with trend indicators and interpretation notes.

Quick Start

Run the bundled collection script from the repository root to generate a JSON project-stats report and save it under .claude/reports/.

Frequently Asked Questions about project-stats

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I generate a codebase metrics report for a git repository?▼

Generate a codebase metrics report by running the bundled bash collector script from your repository root to produce a structured JSON snapshot of LOC, file counts, and dependency inventories.

Can I track git activity and commit velocity over time?▼

Track git activity over time by generating a current JSON report and locating the most recent previous report to compute deltas for commit totals, recent velocity, contributors, and AI-collaboration metrics.

Does the project stats collector detect monorepo workspaces and frameworks?▼

Yes, the project stats collector detects common monorepo tools, workspace counts, frameworks, Dockerfiles, and basic i18n statistics within the repository to provide comprehensive infrastructure signals.

What do I need to run automated repository analysis for project health checks?▼

You need python3 and git installed in your environment to run the automated repository analysis script, which collects codebase metrics and saves the output under .claude/reports/.

How are codebase metrics and test file inventories compared across releases?▼

Codebase metrics and test file inventories are compared across releases by finding the most recent previous JSON report and calculating deltas to produce a formatted markdown report with trend indicators.

Related Skills

Explore More Software Engineering Skills→
samjhechtsamjhecht
4

initialize-governance

Generate Constitution, Roadmap, and process documentation templates for project governance.

Community
Advanced
sky770825sky770825

log-analyzer-skill

Analyze Syslog, JSON, and plain text logs to extract errors and generate reports.

Community
Intermediate
kynoptickynoptic
1

Auditing Test Quality

Audit test suites for vanity tests and mock-to-assertion ratios.

Community
Intermediate
KrismithReddy12KrismithReddy12

health

Calculate a weighted 0-10 code quality score from linters and test runners.

Community
Advanced