AutoGineer
Generated banner for Copilot Usage Metrics
Generated logo for Copilot Usage Metrics

Copilot Usage Metrics

GitHubOfficialContributed by @codeHysteria28 via pull request #745Distributed by GitHub

  • Skill
  • Tool integration
  • Software development
  • MIT
  • Low risk
  • Has scripts
Download ZIP

From the author

Retrieve and display GitHub Copilot usage metrics for organizations and enterprises using the GitHub CLI and REST API.
— the description by codeHysteria28

AutoGineer summary

Written by AutoGineer from the skill’s own files, not by the author

This skill provides a structured way to query and visualize GitHub Copilot adoption and usage statistics. By leveraging the GitHub CLI and REST API, it allows administrators to pull aggregated or per-user data for both organizations and enterprises. It supports specific date filtering and provides guidance on presenting the data, including key performance indicators like acceptance rates and chat interactions.

What it does

  • Fetches aggregated Copilot usage metrics for organizations and enterprises.
  • Retrieves detailed per-user Copilot usage breakdowns.
  • Supports filtering metrics by specific dates in YYYY-MM-DD format.
  • Provides guidance on summarizing key metrics like acceptance rates and total suggestions.
  • Assists in troubleshooting API access issues related to permissions and enterprise settings.

When to use it

  • When you need to report on Copilot adoption rates within your organization.
  • When analyzing per-user productivity trends related to Copilot usage.
  • When auditing Copilot usage statistics for billing or performance reviews.
  • When you need to verify if Copilot features are being actively utilized by team members.

Advantages

  • Automates the extraction of complex usage data from the GitHub API.
  • Simplifies the generation of reports for enterprise and organization owners.
  • Provides consistent formatting for usage metrics and user breakdowns.
  • Helps identify trends in developer tool adoption over time.

Usage examples

“Show me the aggregated Copilot usage for my organization 'acme-corp' for yesterday.”
The agent executes the organization metrics script and returns a summary of active users, acceptance rates, and total suggestions for the specified date.
“Can you list the per-user Copilot usage for the 'acme-enterprise' enterprise?”
The agent retrieves the per-user data and presents it in a clear table format, highlighting individual activity levels.

Install

  1. Download the skill as a ZIP:

    https://mp-staging.autogineer.com/agent-skills/github/copilot-usage-metrics/download

  2. Unzip it into the cross-client skills folder of your project:

    mkdir -p .agents/skills && unzip copilot-usage-metrics.zip -d .agents/skills

Documentation by codeHysteria28

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.

Files

Requirements and compatibility

Written for: GitHub Copilot

Works with: Claude Code, Claude apps, OpenAI Codex, GitHub Copilot, Cursor, Gemini CLI, Kiro, OpenCode, Goose, Amp, Roo Code, JetBrains Junie, Factory Droid, Devin (ex-Windsurf), Mistral Vibe, OpenHands, Letta

“Works with” means the tool reads the open Agent Skills format; a skill written for one tool may use features others lack.

Security

What our scanner noticed· Low risk

  • Scripts that your agent may run

This skill includes scripts that your agent may run. Read them before you use it.

A static scan is not a guarantee. Skills are third-party content: review a skill before you let an agent use it.

Attribution and licence

Contributed by
GitHub avatar of codeHysteria28@codeHysteria28via pull request #745
Publisher
GitHub (Official)
Distributed by
GitHub
Source
github/awesome-copilot · skills/copilot-usage-metrics · commit 797337f
Licence
MIT License (redistribution allowed)
  • LICENSE (added by AutoGineer from LICENSE)
  • ATTRIBUTION.md (written by AutoGineer)
Synced

AutoGineer is not affiliated with or endorsed by codeHysteria28 or GitHub.

Download ZIP

The ZIP holds the skill’s files, its licence files and an ATTRIBUTION.md. Download copilot-usage-metrics.zip