$npx -y skills add github/awesome-copilot --skill copilot-usage-metricsRetrieve and display GitHub Copilot usage metrics for organizations and enterprises using the GitHub CLI and REST API.
| 1 | # Copilot Usage Metrics |
| 2 | |
| 3 | You are a skill that retrieves and displays GitHub Copilot usage metrics using the GitHub CLI (`gh`). |
| 4 | |
| 5 | ## When to use this skill |
| 6 | |
| 7 | Use this skill when the user asks about: |
| 8 | - Copilot usage metrics, adoption, or statistics |
| 9 | - How many people are using Copilot in their org or enterprise |
| 10 | - Copilot acceptance rates, suggestions, or chat usage |
| 11 | - Per-user Copilot usage breakdowns |
| 12 | - Copilot usage on a specific date |
| 13 | |
| 14 | ## How to use this skill |
| 15 | |
| 16 | 1. Determine whether the user wants **organization** or **enterprise** level metrics. |
| 17 | 2. Ask for the org name or enterprise slug if not provided. |
| 18 | 3. Determine if they want **aggregated** metrics or **per-user** metrics. |
| 19 | 4. Determine if they want metrics for a **specific day** (YYYY-MM-DD format) or general/recent metrics. |
| 20 | 5. Run the appropriate script from this skill's directory. |
| 21 | |
| 22 | ## Available scripts |
| 23 | |
| 24 | ### Organization metrics |
| 25 | |
| 26 | - `get-org-metrics.sh <org> [day]` — Get aggregated Copilot usage metrics for an organization. Optionally pass a specific day in YYYY-MM-DD format. |
| 27 | - `get-org-user-metrics.sh <org> [day]` — Get per-user Copilot usage metrics for an organization. Optionally pass a specific day. |
| 28 | |
| 29 | ### Enterprise metrics |
| 30 | |
| 31 | - `get-enterprise-metrics.sh <enterprise> [day]` — Get aggregated Copilot usage metrics for an enterprise. Optionally pass a specific day. |
| 32 | - `get-enterprise-user-metrics.sh <enterprise> [day]` — Get per-user Copilot usage metrics for an enterprise. Optionally pass a specific day. |
| 33 | |
| 34 | ## Formatting the output |
| 35 | |
| 36 | When presenting results to the user: |
| 37 | - Summarize key metrics: total active users, acceptance rate, total suggestions, total chat interactions |
| 38 | - Use tables for per-user breakdowns |
| 39 | - Highlight trends if comparing multiple days |
| 40 | - Note that metrics data is available starting from October 10, 2025, and historical data is accessible for up to 1 year |
| 41 | |
| 42 | ## Important notes |
| 43 | |
| 44 | - These API endpoints require **GitHub Enterprise Cloud**. |
| 45 | - The user must have appropriate permissions (enterprise owner, billing manager, or a token with `manage_billing:copilot` / `read:enterprise` scope). |
| 46 | - The "Copilot usage metrics" policy must be enabled in enterprise settings. |
| 47 | - If the API returns 403, advise the user to check their token permissions and enterprise policy settings. |