New to Claude Skills? Learn how to install them →

github on GitHub

Copilot Usage Metrics

OfficialFree

Easily retrieve GitHub Copilot usage statistics for your organization.

by github37.7k stars on github/awesome-copilot
5 views
Updated Aug 10, 2026
Get this skill

Free · Opens the source repo

What Copilot Usage Metrics does

Copilot Usage Metrics is a skill designed for organizations and enterprises using GitHub Copilot. It leverages the GitHub CLI and REST API to retrieve detailed usage metrics, providing insights into how Copilot is being utilized across teams. This skill is particularly useful for managers and team leads who want to understand the adoption rate of Copilot within their organization, track user engagement, and evaluate the effectiveness of the tool in enhancing productivity.

The skill offers a straightforward way to gather both aggregated metrics and per-user statistics. Users can obtain information such as total active users, acceptance rates, and suggestions made by Copilot. Additionally, it allows for the retrieval of metrics for specific days, enabling organizations to analyze trends over time. The output is formatted for clarity, often using tables for detailed breakdowns, making it easy to interpret the data.

To utilize this skill, users need to determine whether they require organization-level or enterprise-level metrics and specify the relevant organization or enterprise name. The skill supports various scripts that cater to different metrics needs, ensuring flexibility in data retrieval. However, it is important to note that access to these metrics requires appropriate permissions within GitHub Enterprise Cloud, including having the necessary scopes for API tokens.

Overall, Copilot Usage Metrics is an essential tool for organizations looking to optimize their use of GitHub Copilot, providing actionable insights that can drive better decision-making regarding AI-assisted development practices.

When to use it

Use this skill when you need to gather statistics on GitHub Copilot usage within your organization or enterprise.

When not to use it

This skill is not suitable for individuals or those without access to GitHub Enterprise Cloud, as it requires specific permissions and settings.

What you can build with it

Tracking Adoption Rates

Use this skill to monitor how many users in your organization are actively using GitHub Copilot over time.

Evaluating User Engagement

Retrieve per-user metrics to assess individual engagement with Copilot, helping identify power users and those who may need additional training.

Analyzing Trends

Request metrics for specific dates to analyze how Copilot usage trends change over time, allowing for data-driven decisions.

How to install Copilot Usage Metrics

View source

1. Install with the skills CLI

npx skills add github/awesome-copilot/copilot-usage-metrics --agent claude-code

2. Or install it manually

Download the skill folder and drop it into ~/.claude/skills/ for all projects, or .claude/skills/ to scope it to one repo. Restart Claude Code so it picks up the new skill.

Anthropic's agentic coding CLI, and the reference implementation of Agent Skills. Drop a skill folder into ~/.claude/skills and Claude Code loads it automatically whenever a task matches the skill's description. Claude Code docs

Inside SKILL.md

Written by github

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.

Frequently asked questions about Copilot Usage Metrics

Similar skills