skilld
All skills
github avatar

/copilot-usage-metrics

@5de0d98 official
by githubgithub/awesome-copilot40k stars
5,040

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

Ask your Agent

Use this Skill: https://skilld.dev/gh/github/awesome-copilot/copilot-usage-metrics

This session only. Nothing lands on disk.

SKILL.md

≈35 tokens always: the name and description. ≈568 when used: this file.

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.

Source: SKILL.md on GitHub

Third-party checks

1 warning16d5 checks · Risk SAFE
  • Gen Agent Trust Hub16d

    This skill allows users to retrieve GitHub Copilot usage statistics for organizations and enterprises using the official GitHub CLI tool. It is a legitimate utility provided by GitHub.

  • Socket16d

    No alerts

  • Snyk16d

    Risk: LOW · No issues

  • Runlayer7mo

    5/5 files flagged

  • ZeroLeaks5mo

    Score: 93/100 · 2 sections analyzed

Provenance

Signed by skilld at 5de0d98. This ties the file your Agent reads to that commit on GitHub. It does not review the instructions.

Last checked against GitHub 18 hours ago.

Activeupdated 8 months ago

Topics

  • API
  • CLI
  • github
  • copilot
  • metrics
  • usage
  • enterprise
  • organization
  • analytics

README badge

README badge for github/awesome-copilot/copilot-usage-metrics

What it does

Retrieves GitHub Copilot usage metrics for organizations and enterprises via the GitHub CLI and REST API, supporting both aggregated and per-user breakdowns. Use this skill to report on adoption rates, suggestion acceptance, and chat interactions across your org or enterprise for a specific date or recent trends.

Generated from the current SKILL.md.

Frequently asked

Does this work with GitHub Free or Pro accounts?
No. Copilot usage metrics require GitHub Enterprise Cloud. The endpoints are not available for organizations or users on Free or Pro plans.
What permissions do I need to retrieve metrics?
You must be an enterprise owner or billing manager, or have a token with `manage_billing:copilot` or `read:enterprise` scope. The Copilot usage metrics policy must also be enabled in enterprise settings.
How far back can I retrieve historical metrics?
Metrics data is available starting from October 10, 2025, and you can access historical data for up to 1 year from that start date.
Can I get per-user breakdowns or only aggregated numbers?
Both. Use the aggregated scripts (get-org-metrics.sh, get-enterprise-metrics.sh) for totals and summary stats, or the per-user scripts (get-org-user-metrics.sh, get-enterprise-user-metrics.sh) for individual user breakdowns.

Generated from the current SKILL.md. These answers refresh after source changes.