PaperclipOrg
Claude Agent Skill · by Github

Copilot Usage Metrics

Pulls GitHub Copilot usage metrics from your org or enterprise using the GitHub CLI and REST API. You get both high-level stats (total active users, acceptance

Install
Terminal · npx
$npx skills add https://github.com/github/awesome-copilot --skill copilot-usage-metrics
Works with Paperclip

How Copilot Usage Metrics fits into a Paperclip company.

Copilot Usage Metrics drops into any Paperclip agent that handles this kind of work. Assign it to a specialist inside a pre-configured PaperclipOrg company and the skill becomes available on every heartbeat — no prompt engineering, no tool wiring.

S
SaaS FactoryPaired

Pre-configured AI company — 18 agents, 18 skills, one-time purchase.

$27$59
Explore pack
Source file
SKILL.md52 lines
Expand
---name: copilot-usage-metricsdescription: 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.