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 Architect Comments

by Azure in Azure/azure-sdk-tools

Retrieve human architect review comments from APIView for a date range.

OfficialMITAuto-check passed

Install Report Architect Comments

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

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

GitHub CLI
$ gh skill install Azure/azure-sdk-tools report-architect-comments --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-architect-comments .claude/skills/report-architect-comments && 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-architect-comments
GitHub stars
134
Token cost
~1.4k tokens
SKILL.md length
517 words
Files
1
Skills in repo
35
Repo updated
First seen
Licence
MIT

At a glance

Retrieve human architect review comments from APIView for a date range.

  • Works in 2 steps: Run the Command → Answer Follow-up Questions
  • : architect comments
  • SKILL.md covers When to Use, Understanding Architect Comments, Defaults and Date Resolution, plus 3 more sections
  • Calls python

What it does

Report Architect Comments is an agent skill from Azure/azure-sdk-tools, published by the product's own GitHub organization. Retrieve human architect review comments from APIView for a date range. Use for: architect comments, human comments, reviewer comments, board comments, architect comments for March, what did architects say, human review comments.

Its SKILL.md is about 1.4k 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

  • : architect comments
  • Reviewer comments
  • Architect comments for March
  • What did architects say

Example prompts

  • “/report-architect-comments”

Requirements

  • Python 3

Workflow steps

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

  1. Run the Command
  2. Answer Follow-up Questions

What it can do on your machine

Read from SKILL.md and the folder at commit 6e4fb2b. 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 Architect Comments loads about 1.4k tokens when it runs. Until then it costs about 64 tokens; SKILL.md has 517 words of instructions outside code blocks.

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

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 6e4fb2b, republished under its MIT licence (© Azure). 517 words, ~1,360 tokens.

Download SKILL.mdSave it as .claude/skills/report-architect-comments/SKILL.md (or your agent's skills folder).
name
report-architect-comments
description
Retrieve human architect review comments from APIView for a date range. Use for: architect comments, human comments, reviewer comments, board comments, architect comments for March, what did architects say, human review comments.
argument-hint
Month name (e.g. 'March') or language + month (e.g. 'Python for March')

Report Architect Comments

When to Use

  • Reviewing what human architects (language board approvers) commented on during a period
  • Analyzing review themes or patterns from human reviewers
  • Comparing human review feedback against AI-generated comments
  • Understanding what architects focus on for a specific language

Understanding Architect Comments

This command returns comments written by human language board approvers in APIView. It excludes:

  • Diagnostic comments (auto-generated by tooling)
  • AIGenerated comments (written by APIView Copilot)
  • Deleted comments

The set of approvers is determined from the APIView Permissions container — members of groups whose roles include "Architect" or "Deputy Architect" for the specified language. When no language is specified, all architect and deputy-architect group members are included.

Use --all-commenters to skip approver filtering and return comments from all users.

Defaults

Unless the user says otherwise, always apply these defaults:

  • Environment: production
  • Language: All languages (do not pass --language unless user specifies one)
  • Format: JSON (do not pass --format)

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 saysstart_dateend_date
"March" (current year)YYYY-03-01YYYY-03-31
"January 2025"2025-01-012025-01-31
"March 1 to March 15"YYYY-03-01YYYY-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).

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). Redirect to a file since output can be very large.

Full terminal command (cleanup + run):

powershell
New-Item -ItemType Directory -Path output -Force | Out-Null; if (Test-Path output/architect_comments_output.json) { Remove-Item output/architect_comments_output.json }; python cli.py report architect-comments -s <start_date> -e <end_date> | Out-File -Encoding UTF8 output/architect_comments_output.json

After the command completes, read the output file with read_file to get the JSON results. Summarize the findings for the user (total count, languages covered, common themes, etc.).

Step 2: Answer Follow-up Questions

For follow-up questions about the same data (filtering, counting, searching), read the output file with read_file instead of re-running the command. The file is at output/architect_comments_output.json.

Show full SKILL.md (202 more words)Show less
Examples
powershell
# All architect comments for March 2026
python cli.py report architect-comments -s 2026-03-01 -e 2026-03-31

# Python architect comments only
python cli.py report architect-comments -s 2026-03-01 -e 2026-03-31 -l python

# All commenters (not just approvers)
python cli.py report architect-comments -s 2026-03-01 -e 2026-03-31 -l python --all-commenters

# Include reply comments (by default only first comment per thread is returned)
python cli.py report architect-comments -s 2026-03-01 -e 2026-03-31 -l java --include-replies

# YAML output
python cli.py report architect-comments -s 2026-03-01 -e 2026-03-31 --format yaml

# Staging environment
python cli.py report architect-comments -s 2026-03-01 -e 2026-03-31 --environment staging

Available Flags

FlagTypeDefaultDescription
--start-date / -sstringrequiredStart date (YYYY-MM-DD)
--end-date / -estringrequiredEnd date (YYYY-MM-DD)
--language / -lstringallLanguage to filter by (e.g., python, Go, C#)
--environmentstringproductionproduction or staging
--format / -fstringjsonOutput format: json or yaml
--all-commentersflagfalseInclude comments from all users, not just approvers
--include-repliesflagfalseInclude reply comments. By default only the first comment per thread is returned

Gotchas

  • Output can be large: Redirect to file and use read_file rather than relying on terminal output.
  • Date range filters by thread start time: Only threads whose first comment falls within the date window are included. A reply created during the window is excluded if the thread itself started before the window.
  • Use python cli.py not .\avc: The avc.bat script may resolve to system Python.
  • Do NOT use 2>&1: Merges stderr into stdout, corrupting JSON. Only redirect stdout.
  • Do NOT use >: Produces UTF-16 in PowerShell 5.1. Use | Out-File -Encoding UTF8.
  • Month end dates: February has 28/29 days, April/June/Sept/Nov have 30 days.
  • Approver filtering: If no approvers are found for a language, no comments are returned. This can happen for less common languages with no registered board members.

© 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-architect-comments of Azure/azure-sdk-tools.

Open the folder on GitHubat commit 6e4fb2b

Compare with similar skills

Report Architect Comments 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 Architect Comments compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Report Architect Comments this skillAzure/azure-sdk-tools134—~1.4kAutomated safety check: PassMIT
Iterative Retrievalaffaan-m/ECC275k7 repos~1.6kAutomated safety check: PassMIT
No Commentscursor/plugins10k7 repos~640Automated safety check: PassNone
Commentsanthropics/claude-for-legal9.6k1 repos~1kAutomated safety check: PassApache-2.0
Agent Repo Architectruvnet/ruflo74k2 repos~3kAutomated safety check: PassMIT
Clean Up Commentsthedaviddias/Front-End-Checklist74k—~435Automated safety check: PassMIT

Similar skills

  • Iterative Retrieval

    affaan-m/ECC

    Pattern for progressively refining context retrieval to solve the subagent context problem.

    275k GitHub starsUsed in 7 repos~1.6k tokens
    Agent WorkflowsAuto-check passed

  • No Comments

    cursor/plugins

    Official

    Spawn Comment Sicko, fix accepted findings, and offer encodings for claimed constraints.

    10k GitHub starsUsed in 7 repos~640 tokens
    Auto-check passed

  • Comments

    anthropics/claude-for-legal

    Official

    Review open NPRM comment periods, log decisions, track deadlines.

    9.6k GitHub starsUsed in 1 repo~1k tokens
    Auto-check passed

  • Agent Repo Architect

    ruvnet/ruflo

    Agent skill for repo-architect - invoke with $agent-repo-architect

    74k GitHub starsUsed in 2 repos~3k tokens
    Auto-check passed

  • Clean Up Comments

    thedaviddias/Front-End-Checklist

    A skill your agent uses when reviewing templates, rendered HTML, or shared components related to Remove comments and debug code in production.

    74k GitHub stars~435 tokensUpdated 2 days ago
    Auto-check passed

  • Comment Checker

    code-yeongyu/oh-my-openagent

    A skill your agent uses when Codex needs to understand or respond to automatic comment-checker feedback emitted after an edit-like PostToolUse hook.

    70k GitHub stars~160 tokensUpdated today
    Auto-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 today
    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 today
    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 today
    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 today
    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 today
    Auto-check passed

Questions about Report Architect Comments

What does Report Architect Comments do?

Retrieve human architect review comments from APIView for a date range. Report Architect Comments is an agent skill from Azure/azure-sdk-tools, published by the product's own GitHub organization. Retrieve human architect review comments from APIView for a date range.

When should I use Report Architect Comments?

Report Architect Comments fits situations like: : architect comments; reviewer comments; architect comments for March; what did architects say.

How do I install Report Architect Comments in Claude Code?

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

How do I install Report Architect Comments in Codex?

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

Can I use Report Architect Comments 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-architect-comments -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-architect-comments, .gemini/skills/report-architect-comments, .github/skills/report-architect-comments and .opencode/skills/report-architect-comments in your project.

What does Report Architect Comments need to run?

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

Does Report Architect Comments 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 Architect Comments 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 Architect Comments use?

Report Architect Comments 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 Architect Comments use?

About 1.4k tokens (SKILL.md is roughly 5.4k 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 Architect Comments?

Skills that share tags, products or a category with Report Architect Comments: Iterative Retrieval (affaan-m/ECC, 275k stars), No Comments (cursor/plugins, 10k stars), Comments (anthropics/claude-for-legal, 9.6k stars) and Agent Repo Architect (ruvnet/ruflo, 74k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Report Architect Comments?

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 8, 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.