copilot-usage-metrics

Retrieve and display GitHub Copilot usage metrics for organizations and enterprises. Supports both organization-level and enterprise-level metrics queries, with optional filtering by specific date (YYYY-MM-DD format) Provides aggregated metrics (total active users, acceptance rates, suggestions, chat interactions) and per-user breakdowns via separate commands Requires GitHub Enterprise Cloud, appropriate token permissions ( manage_billing:copilot or read:enterprise scope), and the "Copilot usage metrics" policy enabled Metrics data available from October 10, 2025 onward with up to 1 year of historical access

INSTALLATION
npx skills add https://github.com/github/awesome-copilot --skill copilot-usage-metrics
Run in your project or agent environment. Adjust flags if your CLI version differs.

SKILL.md

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: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.
BrowserAct

Let your agent run on any real-world website

Bypass CAPTCHA & anti-bot for free. Start local, scale to cloud.

Explore BrowserAct Skills →

Stop writing automation&scrapers

Install the CLI. Run your first Skill in 30 seconds. Scale when you're ready.

Start free
free · no credit card