Skill
apiview-feedback-resolution
resolve APIView feedback on Azure SDKs
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.
SKILL.md
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_updatefor TypeSpec changes; delegate viaazsdk_typespec_delegate_apiview_feedbackfor 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-mcpserver; no CLI fallback. Connect the server and retry.
More skills from the azure-sdk-tools repository
View all 10 skillsazsdk-common-live-and-recorded-tests
deploy resources and run Azure SDK tests
Jul 12AzureDeploymentSDKTestingazsdk-common-prepare-release-plan
manage Azure SDK release plan work items
Jul 12AzureGitHubProject ManagementSDKazsdk-common-sdk-release
release Azure SDK packages
Jul 12AzureCI/CDDeploymentSDKazure-typespec-author
author and modify Azure TypeSpec API specifications
Jul 12API DevelopmentAzureOpenAPITechnical Writinggenerate-sdk-locally
generate and test Azure SDKs locally
Jul 12AzureCI/CDSDKTestingmarkdown-token-optimizer
optimize markdown files for token efficiency
Jul 12LLMPerformanceTechnical Writing
More from Azure (Microsoft)
View publisherazure-arg-external-evaluation-policy-author
author and test Azure Resource Graph policies
azure-policy
Jul 12AzureComplianceGovernancePolicyazure-blueprints-migration
migrate Azure Blueprints to Template Specs
azure-blueprints
Jul 12AzureDeploymentInfrastructure as CodeMigrationpipeline-troubleshooting
troubleshoot Azure SDK CI pipelines
azure-sdk-tools
Jul 12AzureCI/CDDebuggingSDKsensei
improve skill frontmatter compliance
azure-sdk-tools
Jul 12AzureComplianceProcess OptimizationTechnical Writingskill-authoring
author agent skills for agentskills.io
azure-sdk-tools
Jul 12DocumentationPlugin DevelopmentTechnical Writing