Agent Metrics Collection Utility

Collect agent usage metrics from git history and output summary, markdown, or JSON reports.

41|13|Updated Dec 14, 2025
One-click install
npx skills add https://github.com/rjmurillo/ai-agents --skill agent-metrics-collection-utility
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: Agent Metrics Collection Utility
Source: https://github.com/rjmurillo/ai-agents/tree/main/.agents/utilities/metrics
Command: npx skills add https://github.com/rjmurillo/ai-agents --skill agent-metrics-collection-utility

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This utility collects and reports metrics on agent usage from git history, enabling teams to assess agent system health, adoption, and impact.

Core Features & Use Cases

  • Automated metrics collection: Gathers key metrics across commits and PR activity to gauge agent engagement.
  • Multi-language support: Python and PowerShell scripts provide cross-platform access.
  • Automation-ready outputs: Outputs in summary, markdown, and JSON formats for dashboards and CI pipelines.

Quick Start

Use the metrics tool to generate a 30-day report from the current repo: python .agents/utilities/metrics/collect_metrics.py Last 90 days as markdown: python .agents/utilities/metrics/collect_metrics.py --since 90 --output markdown JSON output for automation: python .agents/utilities/metrics/collect_metrics.py --output json

Frequently Asked Questions about Agent Metrics Collection Utility

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

FAQPage Schema
How do I measure agent usage and adoption from my Git repository?

Agent metrics collection gathers adoption metrics directly from git history, analyzing commits and PRs to track agent invocation frequency, coverage by commit type, and infrastructure review rates. Run the utility on your repo to generate usage reports spanning your chosen time window.

Can I get agent metrics in multiple formats for dashboards and automation?

Yes. The utility outputs metrics in summary, markdown, and JSON formats. JSON output integrates directly into CI pipelines and dashboards, while markdown generates readable reports for teams and summaries for quick review.

How do I track agent health and system adoption over time?

Configure the time window using the --since parameter to analyze agent activity across 30, 90, or custom day ranges. Multi-format outputs let you build trend reports, dashboard widgets, and automated health checks from git commit and PR data.

Does this work with Python and PowerShell, or just one language?

The utility supports both Python and PowerShell scripts, enabling cross-platform metrics collection on Windows, macOS, and Linux environments without language-specific constraints.

What metrics does this tool collect from git history?

It detects agent references in commits and PRs, classifies them by conventional commit type, identifies infrastructure files, measures invocation frequency, and calculates coverage rates to assess adoption and system health.