Copilot usage metrics
Retrieve and display GitHub Copilot usage metrics for organizations and enterprises using the GitHub CLI and REST API.From its SKILL.md
npx -y skills add github/awesome-copilot --skill copilot-usage-metricsAssembled from the repository path, not quoted from the project. Check it against their README if it does not work.
SKILL.md
2.4 KB, 503 tokens by cl100k_base, as published. Nobody here has run it
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
- 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.
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:enterprisescope). - 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.
What ships with it: 4 files
2.5 KB alongside SKILL.md, 4 of them executable
- get-enterprise-metrics.shruns678 B
- get-enterprise-user-metrics.shruns698 B
- get-org-metrics.shruns607 B
- get-org-user-metrics.shruns627 B