Skip to main content
affpapa.org
RU EN
skill GitHub Copilot official · GitHub

copilot-usage-metrics — GitHub Copilot skill

This skill retrieves GitHub Copilot usage metrics for organizations and enterprises through GitHub CLI and the REST API. Use it to review adoption, suggestions, acceptance rates, or chat activity.

Install into GitHub Copilot · Skills CLI (Vercel) All methods and platforms ↓ 
npx skills add github/awesome-copilot --skill copilot-usage-metrics
Open on GitHub

What copilot-usage-metrics does

copilot-usage-metrics retrieves aggregated or per-user data for an organization or enterprise. It reports active users, acceptance rate, suggestion counts, and Copilot Chat interactions. Per-user results are shown in tables.

The skill includes four shell scripts: get-org-metrics.sh, get-org-user-metrics.sh, get-enterprise-metrics.sh, and get-enterprise-user-metrics.sh. A day can be passed in YYYY-MM-DD format, and comparisons across days highlight trends. History reaches up to 1 year, with data starting October 10, 2025.

It requires GitHub Enterprise Cloud, gh, an enabled “Copilot usage metrics” policy, and suitable access. Use an enterprise owner or billing manager role, or a token with manage_billing:copilot or read:enterprise. If the API returns 403, check the token scopes and enterprise policy. Install it for organization-level reporting; it does not fit personal Copilot statistics.

What it helps with

  • retrieve aggregated Copilot metrics for an organization
  • list Copilot usage for each user
  • check Copilot suggestion acceptance rates
  • compare Copilot figures across dates
  • investigate a 403 response from the metrics API

Example prompts for the agent

  • Show aggregated Copilot usage metrics for my organization.
  • Give me a per-user Copilot breakdown for a day in `YYYY-MM-DD` format.
  • Compare enterprise Copilot metrics across several dates and highlight trends.

How to install copilot-usage-metrics

1Skills CLI (Vercel)

npx skills add github/awesome-copilot --skill copilot-usage-metrics

2GitHub CLI

gh skill install github/awesome-copilot copilot-usage-metrics

3Manually: put the files in place

.github/skills/copilot-usage-metrics/SKILL.md

From the same set554

The whole set →
git-commit official github This skill reviews Git changes, stages related files, and creates Conventional Commits. Use it when you want an agent to make one commit or split work into separate commits. GitHub Copilot 47,165installs excalidraw-diagram-generator official github Turn a plain-language description into an Excalidraw diagram. Useful for mapping processes, system structure, and relationships between entities. GitHub Copilot 31,639installs multi-stage-dockerfile official github This skill guides GitHub Copilot in writing multi-stage Dockerfiles for different languages and frameworks. Use it when the final runtime image should contain fewer build dependencies. GitHub Copilot 29,688installs documentation-writer official github Skill that turns the agent into a technical writer following the Diátaxis framework: tutorials, how-to guides, reference, and explanation. Proposes structure before writing. GitHub Copilot 27,757installs prd official github Turns a feature idea into a structured PRD with user stories, technical requirements, and risks. Use it when planning a software feature or an AI-powered one. GitHub Copilot 24,035installs refactor official github This skill reshapes existing code without changing its external behavior. Use it for gradual cleanup of large functions, duplication, weak types, and code smells. GitHub Copilot 22,321installs java-springboot official github Gives GitHub Copilot Spring Boot development practices, from project layout to tests and security. Use it when writing or reviewing Java application code. GitHub Copilot 21,272installs create-readme official github This skill reviews a project and creates a structured README.md. Use it when the repository needs clear documentation based on its actual files and code. GitHub Copilot 19,081installs

Similar

check tw93 Reviews diffs and release readiness without modifying your worktree unprompted. Runs read-only checks before you merge or ship code. Claude Code CX Codex Cursor +1 15,800installs no-mistakes kunchenguid Runs committed changes through review, tests, lint, docs, push, PR, and CI before they reach the configured push target. Use it to validate completed work. Claude Code CX Codex Cursor +1 5,600installs electron-chromium-upgrade electron Guides Chromium version rolls in the Electron repository on the roller/chromium/main branch. Resolves patch conflicts during e sync --3 and handles commit formatting. Claude Code CX Codex Cursor +1 617installs triage Matt Pocock This skill moves issues and external PRs through triage states, verification, and agent briefs. It fits maintainers managing an issue queue. Claude Code 990,453installs code-review Matt Pocock Reviews changes from a chosen reference point against repository standards and the originating spec. Use it for a branch, PR, or work in progress. Claude Code 789,521installs implement Matt Pocock Implements work from a specification or tickets, following a test-driven flow and ending with review and a commit. Use it when a coding task needs a defined delivery routine. Claude Code 774,700installs git-guardrails-claude-code Matt Pocock This skill adds a Claude Code hook that stops risky Git commands before they run. Use it when an agent must not push or discard working-tree changes. Claude Code 499,069installs setup-pre-commit Matt Pocock This skill configures pre-commit checks for a JavaScript repository, running Prettier, type checking, and tests before each commit. Claude Code 489,289installs

Questions about copilot-usage-metrics

How do I install copilot-usage-metrics in GitHub Copilot?

Run npx skills add github/awesome-copilot --skill copilot-usage-metrics. You can also use gh skill install github/awesome-copilot copilot-usage-metrics.

What does copilot-usage-metrics do?

The skill uses gh and the REST API to retrieve aggregated or per-user GitHub Copilot metrics for organizations and enterprises. It reports active users, suggestions, acceptance rate, and Copilot Chat interactions.

What is required to use Copilot usage metrics?

You need GitHub Enterprise Cloud, an enabled “Copilot usage metrics” policy, and suitable permissions. Use an enterprise owner or billing manager role, or a token with manage_billing:copilot or read:enterprise.

Source text

SKILL.md · MIT 
---
name: copilot-usage-metrics
description: Retrieve and display GitHub Copilot usage metrics for organizations and enterprises using the GitHub CLI and REST API.
---

# 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.

© github · MIT · github/awesome-copilot

See also

Project sponsors

Companies that keep this analytics open
Gold sponsor
Nutra.Club

Impressions, clicks and code copies — open statistics. We keep the numbers public for the same reason NeBlask itself is public. Become a sponsor