mcpField
C
copilot-usage-metrics

copilot-usage-metrics

github.com/githubData & databases40.5k8.7k installsUpdated today
Repository

About copilot-usage-metrics

A skill that retrieves and presents GitHub Copilot usage metrics through the GitHub CLI. It supports organization- or enterprise-level aggregates, per-user breakdowns, and queries for a specific date.

Key features

  1. 01Retrieves organization-level aggregate metrics
  2. 02Retrieves enterprise-level aggregate metrics
  3. 03Shows per-user metric breakdowns
  4. 04Queries metrics for a specified date

Use cases

  1. 01Review Copilot usage across an organization
  2. 02Compare usage metrics for enterprise users
  3. 03Look up suggestions or chat activity for a day

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/github/awesome-copilot --skill copilot-usage-metrics

After installing, type/copilot-usage-metricsin Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

get-enterprise-metrics.sh
get-org-metrics.sh
get-enterprise-user-metrics.sh
get-org-user-metrics.sh

Details

From the project README

Copilot Usage Metrics

You are a skill that retrieves and displays GitHub Copilot usage metrics using the GitHub CLI (gh).

When to use this skill

Use this skill when the user asks about:

  • Copilot usage metrics, adoption, or statistics
  • How many people are using Copilot in their org or enterprise
  • Copilot acceptance rates, suggestions, or chat usage
  • Per-user Copilot usage breakdowns
  • Copilot usage on a specific date

How to use this skill

  1. Determine whether the user wants organization or enterprise level metrics.
  2. Ask for the org name or enterprise slug if not provided.
  3. Determine if they want aggregated metrics or per-user metrics.
  4. Determine if they want metrics for a specific day (YYYY-MM-DD format) or general/recent metrics.
  5. Run the appropriate script from this skill's directory.

Available scripts

Organization metrics
  • get-org-metrics.sh <org> [day] — Get aggregated Copilot usage metrics for an organization. Optionally pass a specific day in YYYY-MM-DD format.
  • get-org-user-metrics.sh <org> [day] — Get per-user Copilot usage metrics for an organization. Optionally pass a specific day.
Enterprise metrics
  • get-enterprise-metrics.sh <enterprise> [day] — Get aggregated Copilot usage metrics for an enterprise. Optionally pass a specific day.
  • get-enterprise-user-metrics.sh <enterprise> [day] — Get per-user Copilot usage metrics for an enterprise. Optionally pass a specific day.

Formatting the output

When presenting results to the user:

  • Summarize key metrics: total active users, acceptance rate, total suggestions, total chat interactions
  • Use tables for per-user breakdowns
  • Highlight trends if comparing multiple days
  • Note that metrics data is available starting from October 10, 2025, and historical data is accessible for up to 1 year

Important notes

  • These API endpoints require GitHub Enterprise Cloud.
  • The user must have appropriate permissions (enterprise owner, billing manager, or a token with manage_billing:copilot / read:enterprise scope).
  • The "Copilot usage metrics" policy must be enabled in enterprise settings.
  • If the API returns 403, advise the user to check their token permissions and enterprise policy settings.

Comments

Markdown supported