copilot-usage-metrics

Retrieves Copilot usage metrics for GitHub organizations and enterprises via REST API and CLI scripts.

Updated Apr 14, 2026
One-click install
npx skills add https://github.com/BrunoAMSilva/my-config --skill copilot-usage-metrics-brunoamsilva
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: copilot-usage-metrics
Source: https://github.com/BrunoAMSilva/my-config/tree/main/coding/skills/copilot-usage-metrics
Command: npx skills add https://github.com/BrunoAMSilva/my-config --skill copilot-usage-metrics-brunoamsilva

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires gh.

What problem does it solve?

Centralizing and retrieving GitHub Copilot usage metrics across organizations and enterprises can be time-consuming and requires privileged API access; this Skill streamlines fetching, summarizing, and presenting adoption and usage data for administrators and billing teams.

Core Features & Use Cases

  • Aggregated organization and enterprise-level Copilot usage metrics for recent or specific dates.
  • Per-user usage breakdowns to identify active users, acceptance rates, suggestion counts, and chat interactions.
  • Use Cases: auditing Copilot adoption for licensing and cost allocation, investigating day-specific usage spikes, and generating reports for enterprise owners or billing managers.

Quick Start

Run the appropriate get-org-metrics.sh or get-enterprise-metrics.sh script with the organization or enterprise and an optional YYYY-MM-DD date to retrieve aggregated or per-user Copilot metrics.

Frequently Asked Questions about copilot-usage-metrics

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I retrieve GitHub Copilot usage metrics for my organization?

You can retrieve GitHub Copilot usage metrics by running the get-org-metrics.sh script with the GitHub CLI, providing your organization name and an optional YYYY-MM-DD date to get aggregated daily stats and per-user breakdowns.

What permissions are needed to fetch enterprise Copilot adoption stats?

Fetching enterprise Copilot adoption stats requires appropriate enterprise permissions or token scopes, specifically manage_billing:copilot or read:enterprise, along with the Copilot usage metrics policy enabled in your GitHub Enterprise Cloud environment.

Can I get per-user Copilot usage breakdowns to identify active users and acceptance rates?

Yes, you can get per-user Copilot usage breakdowns to identify active users, acceptance rates, suggestion counts, and chat interactions by executing the provided metrics scripts via the GitHub CLI and REST API.

Does this tool work with GitHub Enterprise Cloud for billing and cost allocation reports?

Yes, this tool works with GitHub Enterprise Cloud, streamlining the retrieval of Copilot usage data to support auditing adoption for licensing, cost allocation, and generating reports for enterprise owners and billing managers.

Do I need the GitHub CLI installed to pull Copilot metrics?

Yes, you need the GitHub CLI (gh) installed and properly authenticated to pull Copilot metrics, as the Skill relies on it to interact with the GitHub REST API for fetching aggregated and per-user data.