Open Pull Request
Gremlinq/ExRam.Gremlinq
A skill your agent uses when opening a pull request for the current branch, or when an existing pull request needs a better description - including when the check-description CI check has failed.
List APIView revisions created or actually opened/viewed in a date range, broken out by language and type.
Install Report Revisions
$ npx skills add Azure/azure-sdk-tools --skill report-revisions -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install Azure/azure-sdk-tools report-revisions --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ 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-revisions .claude/skills/report-revisions && rm -rf skills-srcUse ~/.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/
Install the "report-revisions" agent skill from https://github.com/Azure/azure-sdk-tools/tree/main/packages/python-packages/apiview-copilot/.github/skills/report-revisions into .claude/skills/report-revisions/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "report-revisions", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$skill-installer install https://github.com/Azure/azure-sdk-tools/tree/main/packages/python-packages/apiview-copilot/.github/skills/report-revisionsType this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
$ npx skills add Azure/azure-sdk-tools --skill report-revisions -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install Azure/azure-sdk-tools report-revisions --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/Azure/azure-sdk-tools.git skills-src && mkdir -p .agents/skills && cp -r skills-src/packages/python-packages/apiview-copilot/.github/skills/report-revisions .agents/skills/report-revisions && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "report-revisions" agent skill from https://github.com/Azure/azure-sdk-tools/tree/main/packages/python-packages/apiview-copilot/.github/skills/report-revisions into .agents/skills/report-revisions/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "report-revisions", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add Azure/azure-sdk-tools --skill report-revisions -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install Azure/azure-sdk-tools report-revisions --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/Azure/azure-sdk-tools.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/packages/python-packages/apiview-copilot/.github/skills/report-revisions .cursor/skills/report-revisions && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "report-revisions" agent skill from https://github.com/Azure/azure-sdk-tools/tree/main/packages/python-packages/apiview-copilot/.github/skills/report-revisions into .cursor/skills/report-revisions/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "report-revisions", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gemini skills install https://github.com/Azure/azure-sdk-tools.git --path packages/python-packages/apiview-copilot/.github/skills/report-revisions--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add Azure/azure-sdk-tools --skill report-revisions -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install Azure/azure-sdk-tools report-revisions --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/Azure/azure-sdk-tools.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/packages/python-packages/apiview-copilot/.github/skills/report-revisions .gemini/skills/report-revisions && rm -rf skills-srcUse ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "report-revisions" agent skill from https://github.com/Azure/azure-sdk-tools/tree/main/packages/python-packages/apiview-copilot/.github/skills/report-revisions into .gemini/skills/report-revisions/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "report-revisions", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install Azure/azure-sdk-tools report-revisionsInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add Azure/azure-sdk-tools --skill report-revisions -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/Azure/azure-sdk-tools.git skills-src && mkdir -p .github/skills && cp -r skills-src/packages/python-packages/apiview-copilot/.github/skills/report-revisions .github/skills/report-revisions && rm -rf skills-srcUse ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "report-revisions" agent skill from https://github.com/Azure/azure-sdk-tools/tree/main/packages/python-packages/apiview-copilot/.github/skills/report-revisions into .github/skills/report-revisions/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "report-revisions", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add Azure/azure-sdk-tools --skill report-revisions -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install Azure/azure-sdk-tools report-revisions --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/Azure/azure-sdk-tools.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/packages/python-packages/apiview-copilot/.github/skills/report-revisions .opencode/skills/report-revisions && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "report-revisions" agent skill from https://github.com/Azure/azure-sdk-tools/tree/main/packages/python-packages/apiview-copilot/.github/skills/report-revisions into .opencode/skills/report-revisions/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "report-revisions", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
Facts
- Skill name
report-revisions- GitHub stars
- 134
- Token cost
- ~1.3k tokens
- SKILL.md length
- 409 words
- Files
- 1
- Skills in repo
- 35
- Repo updated
- First seen
- Licence
- MIT
At a glance
List APIView revisions created or actually opened/viewed in a date range, broken out by language and type.
- Works in 2 steps: Run the Command → Answer Follow-up Questions
- : created revisions
- SKILL.md covers Defaults, Date Resolution, Running the Command and Available Flags (same for both…, plus 1 more section
- Calls python
What it does
Report Revisions is an agent skill from Azure/azure-sdk-tools, published by the product's own GitHub organization. List APIView revisions created or actually opened/viewed in a date range, broken out by language and type. Use for: created revisions, opened revisions, viewed revisions, revision counts, how many revisions, revisions for March, revision breakdown, revision types, automatic vs manual revisions, PR revisions, pull request revisions, page views, actually viewed, who opened reviews, opened revision breakdown.
Its SKILL.md is about 1.3k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.
It sits in Development, covering Pull requests. It works with Azure Monitor and Azure Cosmos DB. The repository describes itself as: Tools repository leveraged by the Azure SDK team. The licence is MIT.
When your agent uses it
- : created revisions
- Opened revisions
- Viewed revisions
- Revision counts
Example prompts
- “/report-revisions”
Requirements
- Python 3
Workflow steps
2 steps, taken from the step headings in SKILL.md.
What it can do on your machine
Read from SKILL.md and the folder at commit cc5ca24. 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 Revisions loads about 1.3k tokens when it runs. Until then it costs about 107 tokens; SKILL.md has 409 words of instructions outside code blocks.
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 cc5ca24, republished under its MIT licence (© Azure). 409 words, ~1,260 tokens.
Download SKILL.mdSave it as
.claude/skills/report-revisions/SKILL.md (or your agent's skills folder).- name
- report-revisions
- description
- List APIView revisions created or actually opened/viewed in a date range, broken out by language and type. Use for: created revisions, opened revisions, viewed revisions, revision counts, how many revisions, revisions for March, revision breakdown, revision types, automatic vs manual revisions, PR revisions, pull request revisions, page views, actually viewed, who opened reviews, opened revision breakdown.
- argument-hint
- Month name (e.g. 'March') or date range, optional --exclude languages
Report Revisions
Two commands for counting APIView revisions by language and type:
| Command | What it counts | Data source |
|---|---|---|
list-created-revisions | Revisions created in the date window | Cosmos DB |
list-opened-revisions | Revisions actually opened/viewed by users | Application Insights + Cosmos DB |
Choose the right command based on the user's intent. If they ask about "created" or "how many revisions", use list-created-revisions. If they ask about "opened", "viewed", "actually looked at", or "page views", use list-opened-revisions.
By default, list-opened-revisions counts all revisions belonging to viewed reviews regardless of when those revisions were created. If the user wants to limit to revisions created within the window (e.g. to pair with list-created-revisions), add --created-in-window.
Defaults
Unless the user says otherwise, always apply these defaults:
- Environment:
production - Exclude: Do NOT pass
--excludeunless the user explicitly asks to omit languages
Date Resolution
The user will typically specify a calendar month by name (e.g. "March", "January 2025"). Resolve to the full month date range:
| User says | start_date | end_date |
|---|---|---|
| "March" (current year) | YYYY-03-01 | YYYY-03-31 |
| "January 2025" | 2025-01-01 | 2025-01-31 |
| "March 1 to March 15" | YYYY-03-01 | YYYY-03-15 |
When only a month name is given without a year, use the current year. Be careful with month lengths (28/29/30/31 days).
Note:
list-opened-revisionsqueries Application Insights, which has a default retention of 90 days. Queries beyond that window may return incomplete data.
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). Always redirect output to a file so follow-up questions can be answered without re-querying.
Show full SKILL.md (152 more words)Show less
Created revisions
New-Item -ItemType Directory -Path output -Force | Out-Null; if (Test-Path output/created_revisions_output.txt) { Remove-Item output/created_revisions_output.txt }; python cli.py apiview list-created-revisions -s <start_date> -e <end_date> 2>&1 | Out-File -Encoding UTF8 output/created_revisions_output.txtOutput file: output/created_revisions_output.txt
Opened revisions
New-Item -ItemType Directory -Path output -Force | Out-Null; if (Test-Path output/opened_revisions_output.txt) { Remove-Item output/opened_revisions_output.txt }; python cli.py apiview list-opened-revisions -s <start_date> -e <end_date> 2>&1 | Out-File -Encoding UTF8 output/opened_revisions_output.txtOutput file: output/opened_revisions_output.txt
With --exclude
Append --exclude Java Go (or whatever languages) to either command.
After the command completes, read the output file with read_file to get the results. Summarize the findings for the user.
Step 2: Answer Follow-up Questions
For follow-up questions about the same data, read the output file instead of re-running the command.
Examples
# Created revisions for March 2026
python cli.py apiview list-created-revisions -s 2026-03-01 -e 2026-03-31
# Opened revisions for March 2026
python cli.py apiview list-opened-revisions -s 2026-03-01 -e 2026-03-31
# Exclude Java and Go
python cli.py apiview list-created-revisions -s 2026-03-01 -e 2026-03-31 --exclude Java Go
python cli.py apiview list-opened-revisions -s 2026-03-01 -e 2026-03-31 --exclude Java Go
# Staging environment
python cli.py apiview list-created-revisions -s 2026-03-01 -e 2026-03-31 --environment stagingAvailable Flags (same for both commands)
| Flag | Type | Default | Description |
|---|---|---|---|
--start-date / -s | string | required | Start date (YYYY-MM-DD) |
--end-date / -e | string | required | End date (YYYY-MM-DD) |
--environment | string | production | production or staging |
--exclude | string(s) | None | Languages to exclude (e.g., --exclude Java Go) |
Output Format
Both commands print a table with one row per language and one column per revision type (Automatic, Manual, PullRequest). Each type cell shows the count and its percentage of that column's total. The Total column shows the language's count and its percentage of the grand total.
© 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-revisions of Azure/azure-sdk-tools.
Open the folder on GitHubat commit cc5ca24
Compare with similar skills
Report Revisions 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.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| Report Revisions this skillAzure/azure-sdk-tools | 134 | — | ~1.3k | Automated safety check: Pass | MIT | |
| Open Pull RequestGremlinq/ExRam.Gremlinq | 187 | — | ~1.5k | Automated safety check: Pass | MIT | |
| Finishing a Development Branchobra/superpowers | 297k | 5 repos | ~1.9k | Automated safety check: Pass | MIT | |
| PR Babysitteropeninterpreter/openinterpreter | 69k | 3 repos | ~4.2k | Automated safety check: Pass | Apache-2.0 | |
| Check PRonyx-dot-app/onyx | 32k | 2 repos | ~2.3k | Automated safety check: Pass | MIT | |
| PR Design DocOpenHands/OpenHands | 90k | — | ~2.4k | Automated safety check: Pass | MIT |
Similar skills
Finishing a Development Branch
obra/superpowers
Walks the last step of a branch: confirm tests pass, detect the git environment, ask how to integrate, carry out your choice and clean up the worktree.
PR Babysitter
openinterpreter/openinterpreter
Watches an open GitHub pull request until it merges, handling review comments, diagnosing CI failures and retrying flaky checks along the way.
Check PR
onyx-dot-app/onyx
Checks a GitHub, GitLab, or Perforce (p4) pull request (or merge request, or shelved changelist) for unresolved review comments, failing status checks, and incomplete PR descriptions.
PR Design Doc
OpenHands/OpenHands
For a non-trivial pull request, write a self-contained HTML design doc under the temporary .pr/ directory and link a visibility-appropriate preview in the PR description, so maintainers grasp the…
WooCommerce Code Review
woocommerce/woocommerce
Reviews WooCommerce code changes against the project's standards, flagging backend PHP architecture, naming, documentation, data integrity and testing violations.
More from Azure/azure-sdk-tools
All 35 skills in this repo- Official
Apiview Feedback Resolution
Azure/azure-sdk-tools
Analyze and resolve APIView review feedback on Azure SDK PRs.
- Official
Azsdk Common Apiview Feedback Resolution
Azure/azure-sdk-tools
Analyze and resolve APIView review feedback on Azure SDK PRs.
- Official
Azsdk Common Live And Recorded Tests
Azure/azure-sdk-tools
Deploy test resources and run Azure SDK tests in live, record, or playback mode.
- Official
Azsdk Common Pipeline Analysis
Azure/azure-sdk-tools
Analyze Azure SDK CI/CD pipeline failures into a structured diagnosis, and define the required output format.
- Official
Azsdk Common Prepare Release Plan
Azure/azure-sdk-tools
Create, get, update, abandon, and link SDK PRs to release plan work items for Azure SDK releases.
- Official
Azure Typespec Assessment
Azure/azure-sdk-tools
Assess Azure TypeSpec Git diffs for semantic intent, REST and downstream SDK breaking changes, Azure Guidelines compliance, and documentation completeness.
Related
Works with
Categories
Questions about Report Revisions
What does Report Revisions do?
List APIView revisions created or actually opened/viewed in a date range, broken out by language and type. Report Revisions is an agent skill from Azure/azure-sdk-tools, published by the product's own GitHub organization. List APIView revisions created or actually opened/viewed in a date range, broken out by language and type.
When should I use Report Revisions?
Report Revisions fits situations like: : created revisions; opened revisions; viewed revisions; revision counts.
How do I install Report Revisions in Claude Code?
Run `npx skills add Azure/azure-sdk-tools --skill report-revisions -a claude-code`. Or copy the skill folder (packages/python-packages/apiview-copilot/.github/skills/report-revisions in Azure/azure-sdk-tools) into .claude/skills/report-revisions in your project. Claude Code loads it when a task matches its description.
How do I install Report Revisions in Codex?
Run `npx skills add Azure/azure-sdk-tools --skill report-revisions -a codex`. Or copy the skill folder (packages/python-packages/apiview-copilot/.github/skills/report-revisions in Azure/azure-sdk-tools) into .agents/skills/report-revisions in your project. Codex loads it when a task matches its description.
Can I use Report Revisions 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-revisions -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-revisions, .gemini/skills/report-revisions, .github/skills/report-revisions and .opencode/skills/report-revisions in your project.
What does Report Revisions need to run?
Going by SKILL.md and its folder, Report Revisions needs the command-line tools its instructions call (python). Our summary lists: Python 3.
Does Report Revisions 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 Revisions 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 Revisions use?
Report Revisions 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 Revisions use?
About 1.3k tokens (SKILL.md is roughly 5k 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 Revisions?
Skills that share tags, products or a category with Report Revisions: Open Pull Request (Gremlinq/ExRam.Gremlinq, 187 stars), Finishing a Development Branch (obra/superpowers, 297k stars), PR Babysitter (openinterpreter/openinterpreter, 69k stars) and Check PR (onyx-dot-app/onyx, 32k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
Who maintains Report Revisions?
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 9, 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.