copilot-usage-metrics
Retrieve and display GitHub Copilot usage metrics for organizations and enterprises using the GitHub CLI and REST API.
By github · 8,783 installs
npx skills add github/awesome-copilot --skill copilot-usage-metrics
Source repository · Upstream listing
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.