New: 98,000+ skills indexed from GitHub repos with 100+ stars · every skill safety-checkedBrowse top skillsTop skills
Esc to closeBrowse all skills
Submit a skillBrowse skills
Submit a skillBrowse skills

Official agent skill

Report Apiview Metrics

by Azure in Azure/azure-sdk-tools

Run APIView platform metrics (versioned revisions and cross-language compliance).

OfficialMITAuto-check passed

Install Report Apiview Metrics

skills CLI
$ npx skills add Azure/azure-sdk-tools --skill report-apiview-metrics -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install Azure/azure-sdk-tools report-apiview-metrics --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/Azure/azure-sdk-tools.git skills-src && mkdir -p .claude/skills && cp -r skills-src/packages/python-packages/apiview-copilot/.github/skills/report-apiview-metrics .claude/skills/report-apiview-metrics && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
report-apiview-metrics
GitHub stars
134
Token cost
~1.2k tokens
SKILL.md length
393 words
Files
1
Skills in repo
35
Repo updated
First seen
Licence
MIT

At a glance

Run APIView platform metrics (versioned revisions and cross-language compliance).

  • Works in 3 steps: Run the Command → Present Results → Answer Follow-up Questions
  • : apiview metrics
  • SKILL.md covers When to Use, What It Produces, Defaults and Running the Command, plus 2 more sections
  • Calls python

What it does

Report Apiview Metrics is an agent skill from Azure/azure-sdk-tools, published by the product's own GitHub organization. Run APIView platform metrics (versioned revisions and cross-language compliance). Use for: apiview metrics, platform metrics, version coverage, versioned revisions, cross-language compliance, compliance metrics, PackageVersion coverage, CrossLanguagePackageId, apiview-metrics, parser compliance.

Its SKILL.md is about 1.2k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

The repository describes itself as: Tools repository leveraged by the Azure SDK team. The licence is MIT.

When your agent uses it

  • : apiview metrics
  • Platform metrics
  • Version coverage
  • Versioned revisions

Example prompts

  • “/report-apiview-metrics”

Requirements

  • Python 3

Workflow steps

3 steps, taken from the step headings in SKILL.md.

  1. Run the Command
  2. Present Results
  3. Answer Follow-up Questions

What it can do on your machine

Read from SKILL.md and the folder at commit 942ef24. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • python

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Report Apiview Metrics loads about 1.2k tokens when it runs. Until then it costs about 80 tokens; SKILL.md has 393 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~80
When it runs · the whole SKILL.md, loaded when a task matches
~1.2k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from Azure/azure-sdk-tools at commit 942ef24, republished under its MIT licence (© Azure). 393 words, ~1,162 tokens.

Download SKILL.mdSave it as .claude/skills/report-apiview-metrics/SKILL.md (or your agent's skills folder).
name
report-apiview-metrics
description
Run APIView platform metrics (versioned revisions and cross-language compliance). Use for: apiview metrics, platform metrics, version coverage, versioned revisions, cross-language compliance, compliance metrics, PackageVersion coverage, CrossLanguagePackageId, apiview-metrics, parser compliance.
argument-hint
Optional: --months N, --end-date YYYY-MM-DD, --languages Python Java, --chart, --summary

Report APIView Metrics

When to Use

  • Monitoring progress toward 100% versioned revisions across languages
  • Checking cross-language metadata compliance (CrossLanguagePackageId)
  • Generating trend charts for APIView platform health
  • Reviewing parser compliance over time

What It Produces

A combined report with two metric buckets:

BucketWhat it measures
versions% of revisions with a valid PackageVersion, broken out by language and revision type (Automatic, Manual, PullRequest)
compliance% of reviews whose latest revision includes CrossLanguagePackageId (from CrossLanguageMetadata)

Output is JSON with top-level "versions" and "compliance" keys. With --summary, human-readable tables are printed to stderr.

Defaults

Unless the user says otherwise, always apply these defaults:

  • Environment: production
  • Months: 6
  • Languages: Python, C#, Java, JavaScript, Go (all included by default — do not pass --languages unless user restricts)
  • Chart: Include --chart unless user says no charts

Running the Command

Step 1: Run the Command

Show the resolved command and run it immediately in a foreground terminal with a 120-second timeout (timeout: 120000). Clean up stale output first.

powershell
New-Item -ItemType Directory -Path output -Force | Out-Null; New-Item -ItemType Directory -Path output/charts -Force | Out-Null; if (Test-Path output/apiview_metrics_output.json) { Remove-Item output/apiview_metrics_output.json }; python cli.py report apiview-metrics --chart --summary 2>$null | Out-File -Encoding UTF8 output/apiview_metrics_output.json

After the command completes, read the output file with read_file to get the JSON results. Then use view_image to display charts at:

  • output/charts/apiview_version_trends.png
  • output/charts/cross_language_compliance.png
Examples
powershell
# Default: 6 months, all languages, production, with charts
python cli.py report apiview-metrics --chart

# With human-readable summary tables on stderr
python cli.py report apiview-metrics --chart --summary

# Custom lookback
python cli.py report apiview-metrics --months 3 --chart

# Specific end date
python cli.py report apiview-metrics --months 6 --end-date 2026-04-30 --chart

# Specific languages only
python cli.py report apiview-metrics --languages Python Java --chart

# Staging environment
python cli.py report apiview-metrics --chart --environment staging
Step 2: Present Results

After reading the output file:

  1. Summarize the version-coverage trends (highlight languages below 100%)
  2. Summarize the compliance trends (highlight languages below 100%)
  3. Show the chart images with view_image
Step 3: Answer Follow-up Questions

For follow-up questions about the same data, read the output file instead of re-running the command.

Show full SKILL.md (154 more words)Show less

Available Flags

FlagTypeDefaultDescription
--monthsint6Number of calendar months to look back from end date
--end-date / -estringtodayInclusive query end date (YYYY-MM-DD)
--languageslistall 5Space-separated language names to include
--chartflagoffGenerate PNG trend charts to output/charts/
--summaryflagoffPrint human-readable summary tables to stderr
--environmentstringproductionproduction or staging

Gotchas

  • Redirect stdout to a file: Always pipe through | Out-File -Encoding UTF8 output/apiview_metrics_output.json. Do NOT use > which produces UTF-16 in PowerShell 5.1.
  • Do NOT use 2>&1: This merges stderr log lines into the JSON output, producing invalid JSON.
  • Clean up before running: Delete previous output files before running to avoid presenting stale results.
  • Use python cli.py not .\avc: Ensures the correct Python environment is used.
  • Use read_file and view_image: Do NOT use additional terminal commands to read output files or display charts.
  • Built-in exclusions: c, c++, typespec, swagger, xml are always excluded automatically.

© Azure, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in packages/python-packages/apiview-copilot/.github/skills/report-apiview-metrics of Azure/azure-sdk-tools.

Open the folder on GitHubat commit 942ef24

Compare with similar skills

Report Apiview Metrics next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Report Apiview Metrics compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Report Apiview Metrics this skillAzure/azure-sdk-tools134—~1.2kAutomated safety check: PassMIT
North Star Metricphuryn/pm-skills27k—~1kAutomated safety check: PassMIT
Investigate MetricPostHog/posthog40k—~1.9kAutomated safety check: PassCustom licence
Product Metrics Dashboard Designphuryn/pm-skills27k—~1.3kAutomated safety check: PassMIT
Semantic Versioningsickn33/agentic-awesome-skills47k1 repos~2.6kAutomated safety check: PassMIT
CI Metricspytorch/pytorch104k—~1.1kAutomated safety check: PassCustom licence

Similar skills

  • North Star Metric

    phuryn/pm-skills

    Define a North Star Metric and 3-5 supporting input metrics that form a metrics constellation.

    27k GitHub stars~1k tokensUpdated yesterday
    Product & Project ManagementAuto-check passed

  • Investigate Metric

    PostHog/posthog

    Official

    Diagnose why a product metric changed (dropped, spiked, or plateaued) by orchestrating breakdowns, actors, paths, lifecycle, retention, and annotations queries.

    40k GitHub stars~1.9k tokensUpdated today
    Product & Project ManagementAuto-check passed

  • Product Metrics Dashboard Design

    phuryn/pm-skills

    Designs a product metrics dashboard: a North Star and input metrics, a definition table with data sources, chart types and alert thresholds, and a screen layout.

    27k GitHub stars~1.3k tokensUpdated yesterday
    Product & Project ManagementAuto-check passed

  • Semantic Versioning

    sickn33/agentic-awesome-skills

    Automate versioning and changelog generation using semantic versioning principles.

    47k GitHub starsUsed in 1 repo~2.6k tokens
    DevelopmentAuto-check passed

  • CI Metrics

    pytorch/pytorch

    Query PyTorch CI, GitHub Actions, HUD, Grafana, and infrastructure metrics.

    104k GitHub stars~1.1k tokensUpdated today
    AI & LLM EngineeringAuto-check passed

  • Startup Metrics Framework

    wshobson/agents

    Track, calculate, and optimize key performance metrics for SaaS, marketplace, consumer, and B2B startups from seed through Series A, including unit economics, growth efficiency, and cash management.

    40k GitHub stars~2.5k tokensUpdated 6 days ago
    Business, Finance & HRAuto-check passed

More from Azure/azure-sdk-tools

All 35 skills in this repo

  • Apiview Feedback Resolution

    Azure/azure-sdk-tools

    Official

    Analyze and resolve APIView review feedback on Azure SDK PRs.

    134 GitHub stars~547 tokensUpdated yesterday
    Auto-check passed

  • Azsdk Common Live And Recorded Tests

    Azure/azure-sdk-tools

    Official

    Deploy test resources and run Azure SDK tests in live, record, or playback mode.

    134 GitHub stars~1.5k tokensUpdated yesterday
    Auto-check: notes

  • Azsdk Common Pipeline Analysis

    Azure/azure-sdk-tools

    Official

    Analyze Azure SDK CI/CD pipeline failures into a structured diagnosis, and define the required output format.

    134 GitHub stars~1.2k tokensUpdated yesterday
    Auto-check passed

  • Azsdk Common Prepare Release Plan

    Azure/azure-sdk-tools

    Official

    Create, get, update, abandon, and link SDK PRs to release plan work items for Azure SDK releases.

    134 GitHub stars~2.7k tokensUpdated yesterday
    Auto-check passed

  • Azure Typespec Assessment

    Azure/azure-sdk-tools

    Official

    Assess Azure TypeSpec Git diffs for semantic intent, REST and downstream SDK breaking changes, Azure Guidelines compliance, and documentation completeness.

    134 GitHub stars~1.9k tokensUpdated yesterday
    Auto-check passed

Questions about Report Apiview Metrics

What does Report Apiview Metrics do?

Run APIView platform metrics (versioned revisions and cross-language compliance). Report Apiview Metrics is an agent skill from Azure/azure-sdk-tools, published by the product's own GitHub organization. Run APIView platform metrics (versioned revisions and cross-language compliance).

When should I use Report Apiview Metrics?

Report Apiview Metrics fits situations like: : apiview metrics; platform metrics; version coverage; versioned revisions.

How do I install Report Apiview Metrics in Claude Code?

Run `npx skills add Azure/azure-sdk-tools --skill report-apiview-metrics -a claude-code`. Or copy the skill folder (packages/python-packages/apiview-copilot/.github/skills/report-apiview-metrics in Azure/azure-sdk-tools) into .claude/skills/report-apiview-metrics in your project. Claude Code loads it when a task matches its description.

How do I install Report Apiview Metrics in Codex?

Run `npx skills add Azure/azure-sdk-tools --skill report-apiview-metrics -a codex`. Or copy the skill folder (packages/python-packages/apiview-copilot/.github/skills/report-apiview-metrics in Azure/azure-sdk-tools) into .agents/skills/report-apiview-metrics in your project. Codex loads it when a task matches its description.

Can I use Report Apiview Metrics in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add Azure/azure-sdk-tools --skill report-apiview-metrics -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/report-apiview-metrics, .gemini/skills/report-apiview-metrics, .github/skills/report-apiview-metrics and .opencode/skills/report-apiview-metrics in your project.

What does Report Apiview Metrics need to run?

Going by SKILL.md and its folder, Report Apiview Metrics needs the command-line tools its instructions call (python). Our summary lists: Python 3.

Does Report Apiview Metrics access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Report Apiview Metrics safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Report Apiview Metrics use?

Report Apiview Metrics is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Report Apiview Metrics use?

About 1.2k tokens (SKILL.md is roughly 4.6k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Report Apiview Metrics?

Skills that share tags, products or a category with Report Apiview Metrics: North Star Metric (phuryn/pm-skills, 27k stars), Investigate Metric (PostHog/posthog, 40k stars), Product Metrics Dashboard Design (phuryn/pm-skills, 27k stars) and Semantic Versioning (sickn33/agentic-awesome-skills, 47k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Report Apiview Metrics?

Azure (a GitHub organization, an official publisher) maintains it in Azure/azure-sdk-tools, which has 134 GitHub stars. The repository holds 35 skills in this directory. The repository was last updated on October 10, 2026.

Source: Azure/azure-sdk-tools on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.