copilot-usage-metrics
We need to translate the given text from English to Brazilian Portuguese. The text is a description of an agent skill for retrieving GitHub Copilot usage metrics. We must preserve the name "copilot-usage-metrics" but it's not in the text, so we don't include it. We must not add any extra commentary, labels, or formatting. Just translate the text as is. The text: "Retrieve and display GitHub Copilot usage metrics for organizations and enterprises. Supports both organization-level and enterprise-level metrics queries, with optional filtering by specific date (YYYY-MM-DD format) Provides aggregated metrics (total active users, acceptance rates, suggestions, chat interactions) and per-user breakdowns via separate commands Requires GitHub Enterprise Cloud, appropriate token permissions ( manage_billing:copilot or read:enterprise scope), and the "Copilot..." We need to translate accurately, preserving technical terms like "GitHub Copilot", "organization-level", "enterprise-level", "YYYY-MM-DD", "manage_billing:copilot", "read:enterprise", "GitHub Enterprise
npx skills add https://github.com/github/awesome-copilot --skill copilot-usage-metricsCopilot 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:enterprisescope). - 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.