Add copilot-usage-metrics skill

A Copilot CLI agent skill that retrieves and displays GitHub Copilot
usage metrics for organizations and enterprises via the REST API.

Features:
- Organization-level aggregated and per-user metrics
- Enterprise-level aggregated and per-user metrics
- Query metrics for specific dates
- Uses gh CLI for API authentication

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

skills/copilot-usage-metrics/SKILL.md

@@ -0,0 +1,52 @@
+---
+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.

skills/copilot-usage-metrics/get-enterprise-metrics.sh

@@ -0,0 +1,22 @@
+#!/usr/bin/env bash
+# Fetch aggregated Copilot usage metrics for an enterprise
+# Usage: get-enterprise-metrics.sh <enterprise> [day]
+#   enterprise - GitHub enterprise slug
+#   day        - (optional) specific day in YYYY-MM-DD format
+
+set -euo pipefail
+
+ENTERPRISE="${1:?Usage: get-enterprise-metrics.sh <enterprise> [day]}"
+DAY="${2:-}"
+
+if [ -n "$DAY" ]; then
+  gh api \
+    -H "Accept: application/vnd.github+json" \
+    -H "X-GitHub-Api-Version: 2022-11-28" \
+    "/enterprises/$ENTERPRISE/copilot/usage/day?day=$DAY"
+else
+  gh api \
+    -H "Accept: application/vnd.github+json" \
+    -H "X-GitHub-Api-Version: 2022-11-28" \
+    "/enterprises/$ENTERPRISE/copilot/usage"
+fi

skills/copilot-usage-metrics/get-enterprise-user-metrics.sh

@@ -0,0 +1,22 @@
+#!/usr/bin/env bash
+# Fetch per-user Copilot usage metrics for an enterprise
+# Usage: get-enterprise-user-metrics.sh <enterprise> [day]
+#   enterprise - GitHub enterprise slug
+#   day        - (optional) specific day in YYYY-MM-DD format
+
+set -euo pipefail
+
+ENTERPRISE="${1:?Usage: get-enterprise-user-metrics.sh <enterprise> [day]}"
+DAY="${2:-}"
+
+if [ -n "$DAY" ]; then
+  gh api \
+    -H "Accept: application/vnd.github+json" \
+    -H "X-GitHub-Api-Version: 2022-11-28" \
+    "/enterprises/$ENTERPRISE/copilot/usage/users/day?day=$DAY"
+else
+  gh api \
+    -H "Accept: application/vnd.github+json" \
+    -H "X-GitHub-Api-Version: 2022-11-28" \
+    "/enterprises/$ENTERPRISE/copilot/usage/users"
+fi

skills/copilot-usage-metrics/get-org-metrics.sh

@@ -0,0 +1,22 @@
+#!/usr/bin/env bash
+# Fetch aggregated Copilot usage metrics for an organization
+# Usage: get-org-metrics.sh <org> [day]
+#   org  - GitHub organization name
+#   day  - (optional) specific day in YYYY-MM-DD format
+
+set -euo pipefail
+
+ORG="${1:?Usage: get-org-metrics.sh <org> [day]}"
+DAY="${2:-}"
+
+if [ -n "$DAY" ]; then
+  gh api \
+    -H "Accept: application/vnd.github+json" \
+    -H "X-GitHub-Api-Version: 2022-11-28" \
+    "/orgs/$ORG/copilot/usage/day?day=$DAY"
+else
+  gh api \
+    -H "Accept: application/vnd.github+json" \
+    -H "X-GitHub-Api-Version: 2022-11-28" \
+    "/orgs/$ORG/copilot/usage"
+fi

skills/copilot-usage-metrics/get-org-user-metrics.sh

@@ -0,0 +1,22 @@
+#!/usr/bin/env bash
+# Fetch per-user Copilot usage metrics for an organization
+# Usage: get-org-user-metrics.sh <org> [day]
+#   org  - GitHub organization name
+#   day  - (optional) specific day in YYYY-MM-DD format
+
+set -euo pipefail
+
+ORG="${1:?Usage: get-org-user-metrics.sh <org> [day]}"
+DAY="${2:-}"
+
+if [ -n "$DAY" ]; then
+  gh api \
+    -H "Accept: application/vnd.github+json" \
+    -H "X-GitHub-Api-Version: 2022-11-28" \
+    "/orgs/$ORG/copilot/usage/users/day?day=$DAY"
+else
+  gh api \
+    -H "Accept: application/vnd.github+json" \
+    -H "X-GitHub-Api-Version: 2022-11-28" \
+    "/orgs/$ORG/copilot/usage/users"
+fi