copilot-usage-metrics

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

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

Software EngineeringNo license★ 38398⑂ 4850commit f11a4e4

Install skillView source on GitHub

What this skill does

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.

Installation

Copy a source-pinned command for your client. You run it yourself.

Destination: .claude/skills/copilot-usage-metrics · pinned to the source commit

# Run from your project root
git clone https://github.com/github/awesome-copilot.git .skillboard-tmp
git -C .skillboard-tmp checkout f11a4e441c5ff061b4f8ae37952be8c602e4034e
mkdir -p ".claude/skills"
cp -r ".skillboard-tmp/skills/copilot-usage-metrics" ".claude/skills/"
rm -rf .skillboard-tmp

Review the source before running. This copies files into your project; it is not a one-click install and does not verify runtime safety.

New here? Step-by-step setup – from installing the agent to using the skill

Operating systemAgentI already use Claude Code

1
Install Git
Install Git with your package manager (Debian/Ubuntu shown; use dnf/pacman on others). Official download.
```
sudo apt update && sudo apt install -y git
```
2
Install Claude Code
Requires Node.js 18+. Install the CLI globally: Official docs. (command-line tool)
```
npm install -g @anthropic-ai/claude-code
```

Get the skill, pinned to its exact version

Open a terminal and run these steps (they clone the source, check out the exact commit, and copy the skill into place):

# Run from your project root
git clone https://github.com/github/awesome-copilot.git .skillboard-tmp
git -C .skillboard-tmp checkout f11a4e441c5ff061b4f8ae37952be8c602e4034e
mkdir -p ".claude/skills"
cp -r ".skillboard-tmp/skills/copilot-usage-metrics" ".claude/skills/"
rm -rf .skillboard-tmp

Destination: .claude/skills/copilot-usage-metrics

4
Use it in Claude Code
Open Claude Code in your project. It reads skills from the folder above, so copilot-usage-metrics is now available. Always review the source before using it – static checks cannot prove runtime safety.

Security & Audits

Scanner static-checks@0.1.0 · commit f11a4e441c5f. Static checks cannot prove runtime safety – review the source and the exact diff before installing. How checks work.

No static rules matched. This is not a safety guarantee.

copilot-usage-metrics

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

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

Software EngineeringNo license★ 38398⑂ 4850commit f11a4e4

Install skillView source on GitHub

What this skill does

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.

Installation

Copy a source-pinned command for your client. You run it yourself.

Destination: .claude/skills/copilot-usage-metrics · pinned to the source commit

# Run from your project root
git clone https://github.com/github/awesome-copilot.git .skillboard-tmp
git -C .skillboard-tmp checkout f11a4e441c5ff061b4f8ae37952be8c602e4034e
mkdir -p ".claude/skills"
cp -r ".skillboard-tmp/skills/copilot-usage-metrics" ".claude/skills/"
rm -rf .skillboard-tmp

Review the source before running. This copies files into your project; it is not a one-click install and does not verify runtime safety.

New here? Step-by-step setup – from installing the agent to using the skill

Operating systemAgentI already use Claude Code

1
Install Git
Install Git with your package manager (Debian/Ubuntu shown; use dnf/pacman on others). Official download.
```
sudo apt update && sudo apt install -y git
```
2
Install Claude Code
Requires Node.js 18+. Install the CLI globally: Official docs. (command-line tool)
```
npm install -g @anthropic-ai/claude-code
```

Get the skill, pinned to its exact version

Open a terminal and run these steps (they clone the source, check out the exact commit, and copy the skill into place):

# Run from your project root
git clone https://github.com/github/awesome-copilot.git .skillboard-tmp
git -C .skillboard-tmp checkout f11a4e441c5ff061b4f8ae37952be8c602e4034e
mkdir -p ".claude/skills"
cp -r ".skillboard-tmp/skills/copilot-usage-metrics" ".claude/skills/"
rm -rf .skillboard-tmp

Destination: .claude/skills/copilot-usage-metrics

4
Use it in Claude Code
Open Claude Code in your project. It reads skills from the folder above, so copilot-usage-metrics is now available. Always review the source before using it – static checks cannot prove runtime safety.

Security & Audits

Scanner static-checks@0.1.0 · commit f11a4e441c5f. Static checks cannot prove runtime safety – review the source and the exact diff before installing. How checks work.

No static rules matched. This is not a safety guarantee.

copilot-usage-metrics

What this skill does

Copilot Usage Metrics

When to use this skill

How to use this skill

Available scripts

Organization metrics

Enterprise metrics

Formatting the output

Important notes

Installation

Install Git

Install Claude Code

Get the skill, pinned to its exact version

Use it in Claude Code

Security & Audits

copilot-usage-metrics

What this skill does

Copilot Usage Metrics

When to use this skill

How to use this skill

Available scripts

Organization metrics

Enterprise metrics

Formatting the output

Important notes

Installation

Install Git

Install Claude Code

Get the skill, pinned to its exact version

Use it in Claude Code

Security & Audits