apiview-feedback-resolution

Analyze and resolve APIView review feedback on Azure SDK PRs. **UTILITY SKILL**. USE FOR: APIView comments, API review feedback, SDK API surface changes. DO NOT USE FOR: general code review, non-APIView feedback. INVOKES: azure-sdk-mcp:azsdk_apiview_get_comments, azure-sdk-mcp:azsdk_typespec_customized_code_update.

Jump to install

Repository: Azure/azure-sdk-tools
Last source activity: May 21, 2026 at 16:39
Detected SKILL.md language: English
Stars: 135
Forks: 256

Install options

The review-first prompt is selected by default. You can switch to a direct command or download a local copy.

Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.

A direct command skips the review prompt. Inspect the source before running it.

npx skills add https://github.com/Azure/azure-sdk-tools --skill apiview-feedback-resolution

The command stays on one line. Scroll horizontally to inspect it before copying.

Prefer a local copy? Download the files currently available to SkillsMP.

Review the source files

Read SKILL.md and any companion files shown by SkillsMP before deciding whether to install.

File Explorer

13 files

SKILL.md

Source instructions · Read-only preview

Back to search Back to installation

code-review

Guide GitHub Copilot code review (CCR) for PRs and diffs that change tools/azsdk-cli, focusing on high-confidence behavioral and integration defects beyond analyzers. WHEN: 'GitHub Copilot code review for azsdk-cli', 'CCR review of an azsdk-cli PR', 'Copilot review of tools/azsdk-cli changes'.

2026-08-25

azure-typespec-author

Authors and modifies Azure TypeSpec (.tsp) API specifications. MUST BE USED FOR ALL TypeSpec changes regardless of complexity — even adding a single property or enum value requires this skill's validation workflow. USE FOR: any TypeSpec/tsp change — api versions (add, bump, preview, stable, promote), resources, operations, models, properties, decorators, visibility, constraints, breaking changes, LRO, suppressions, operationId, spread model. Covers both ARM resource-manager (Azure.ResourceManager) and data-plane (Azure.Core) services. DO NOT USE FOR: SDK generation, releasing SDK packages, or single MCP tool calls. INVOKES: azure-sdk-mcp:azsdk_typespec_generate_authoring_plan, azure-sdk-mcp:azsdk_run_typespec_validation.

2026-08-25

markdown-token-optimizer

Analyze markdown files for token efficiency and reduce context-window bloat. **UTILITY SKILL**. DO NOT USE FOR: code optimization, general file editing, non-markdown files. TRIGGERS: optimize markdown, reduce tokens, token count, token bloat, too many tokens, make concise, shrink file, file too large, optimize for AI, token efficiency, verbose markdown, reduce file size.

2026-08-05

View all from this repository

APIView Feedback Resolution

Prerequisites: azure-sdk-mcp server required; no CLI fallback. Without MCP, this skill cannot retrieve APIView comments or apply TypeSpec changes. Connect the azure-sdk-mcp server before use.

MCP Tools

Tool

Purpose

azure-sdk-mcp:azsdk_apiview_get_comments

Get APIView comments

azure-sdk-mcp:azsdk_typespec_customized_code_update

Apply TypeSpec changes locally

azure-sdk-mcp:azsdk_typespec_delegate_apiview_feedback

Delegate to CCA pipeline

azure-sdk-mcp:azsdk_run_typespec_validation

Validate TypeSpec

azure-sdk-mcp:azsdk_package_generate_code

Regenerate SDK

Steps

Retrieve — Get APIView URL from SDK PR, run azsdk_apiview_get_comments.

Categorize — Group as Critical/Suggestions/Informational per feedback steps.

Resolve — Use azsdk_typespec_customized_code_update for TypeSpec changes; delegate via azsdk_typespec_delegate_apiview_feedback for complex cases.

Validate — Run validation, regenerate SDK, build and test.

Confirm — Verify all items addressed. If delegated, follow post-delegation follow-up. Request re-review.

Examples

"Resolve the APIView comments on my SDK pull request"

"What feedback did the API reviewer leave?"

Troubleshooting

No comments: Verify PR has APIView link and MCP server is connected.

Validation fails: Re-run after fixing TypeSpec errors.

MCP unavailable: Requires azure-sdk-mcp server; no CLI fallback. Connect the server and retry.

name	apiview-feedback-resolution
license	MIT
metadata	{"version":"1.0.0","distribution":"shared"}
description	Analyze and resolve APIView review feedback on Azure SDK PRs. UTILITY SKILL. USE FOR: APIView comments, API review feedback, SDK API surface changes. DO NOT USE FOR: general code review, non-APIView feedback. INVOKES: azure-sdk-mcp:azsdk_apiview_get_comments, azure-sdk-mcp:azsdk_typespec_customized_code_update.
compatibility	azure-sdk-mcp server, SDK pull request with APIView review link