copilot-usage-metrics

Original：🇺🇸 English

Translated

4 scriptsChecked / no sensitive code detected

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

7.2kinstalls

Added on2026-02-23

NPX Install

npx skill4agent add github/awesome-copilot copilot-usage-metrics

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

gh

).

Use this skill when the user asks about:

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

```
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.

```
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.

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

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.