Run any Skill in Manus with one click

azsdk-common-generate-sdk-locally

Generate, build, and test Azure SDKs locally from TypeSpec with automatic customization. WHEN: "generate SDK locally", "build SDK", "run SDK tests", "run CI checks", "validate package", "run checks", "update changelog", "fix SDK build errors", "fix breaking changes", "resolve SDK generation errors", "customize TypeSpec", "rename SDK client", "rename SDK model", "hide operation from SDK", "fix analyzer errors", "resolve customization drift", "create subclient", "update metadata", "update version". DO NOT USE FOR: publishing to package registries, CI pipeline configuration, API design review. INVOKES: azsdk_verify_setup, azsdk_package_generate_code, azsdk_package_build_code, azsdk_package_run_check, azsdk_package_run_tests, azsdk_customized_code_update, azsdk_package_update_changelog_content, azsdk_package_update_metadata, azsdk_package_update_version.

Run Skill in Manus

Stars5,555

Forks3,311

UpdatedJune 12, 2026 at 20:26

Source

Azure

Azure/azure-sdk-for-python

View GitHub Repository View Creator Repositories

Install command

Download

Run Skill in Manus

Useful forSOC

Software DevelopersComputer and Mathematical Occupations15-1252L4

File Explorer

6 files

SKILL.md

readonly

name	azsdk-common-generate-sdk-locally
license	MIT
metadata	{"version":"1.1.0","distribution":"shared"}
description	Generate, build, and test Azure SDKs locally from TypeSpec with automatic customization. WHEN: "generate SDK locally", "build SDK", "run SDK tests", "run CI checks", "validate package", "run checks", "update changelog", "fix SDK build errors", "fix breaking changes", "resolve SDK generation errors", "customize TypeSpec", "rename SDK client", "rename SDK model", "hide operation from SDK", "fix analyzer errors", "resolve customization drift", "create subclient", "update metadata", "update version". DO NOT USE FOR: publishing to package registries, CI pipeline configuration, API design review. INVOKES: azsdk_verify_setup, azsdk_package_generate_code, azsdk_package_build_code, azsdk_package_run_check, azsdk_package_run_tests, azsdk_customized_code_update, azsdk_package_update_changelog_content, azsdk_package_update_metadata, azsdk_package_update_version.
compatibility	azure-sdk-mcp server, local azure-sdk-for-{language} clone, language build tools

Generate SDK Locally

This skill generates, builds, and tests Azure SDKs locally from TypeSpec with automatic customization support, covering the end-to-end workflow for fixing generation issues, applying SDK-specific updates, and refreshing package metadata when needed.

Triggers

USE FOR: generate, build, and test Azure SDKs locally from TypeSpec with automatic customization; update changelog; fix SDK build errors; fix breaking changes; resolve SDK generation errors; customize TypeSpec; rename SDK client or model; hide operation from SDK; fix analyzer errors; resolve customization drift; create subclient; update metadata; update version WHEN: "generate SDK locally", "build SDK", "run SDK tests", "update changelog", "fix SDK build errors", "fix breaking changes", "resolve SDK generation errors", "customize TypeSpec", "rename SDK client", "rename SDK model", "hide operation from SDK", "fix analyzer errors", "resolve customization drift", "create subclient", "update metadata", "update version" DO NOT USE FOR: publishing to package registries, CI pipeline configuration, API design review

Rules

Requires the azure-sdk-mcp server for the MCP workflow; without MCP, use npm exec --prefix eng/common/tsp-client -- tsp-client CLI.
Verify the target language repo and the correct TypeSpec configuration file before generation.
After generation or customization, run the check and test steps before updating metadata or finalizing changes.

MCP Tools

Tool	Purpose
`azure-sdk-mcp:azsdk_verify_setup`	Verify environment
`azure-sdk-mcp:azsdk_package_generate_code`	Generate SDK
`azure-sdk-mcp:azsdk_package_build_code`	Build package
`azure-sdk-mcp:azsdk_package_run_check`	Validate package
`azure-sdk-mcp:azsdk_package_run_tests`	Run tests
`azure-sdk-mcp:azsdk_customized_code_update`	Apply customizations (includes regeneration and build)
`azure-sdk-mcp:azsdk_package_update_changelog_content`	Update changelog
`azure-sdk-mcp:azsdk_package_update_metadata`	Update metadata including ci.yml
`azure-sdk-mcp:azsdk_package_update_version`	Update version

Prerequisites: azure-sdk-mcp server must be running. Without MCP, use npx tsp-client CLI.

Steps

Select language — Confirm target language: .NET, Java, JavaScript, Python, Go, or Rust.
Verify repo — Ensure the user has a local clone of the correct SDK repo. If not cloned, instruct user to clone it.
Identify config file — Determine the path to the TypeSpec configuration file. See config file details.
- From azure-rest-api-specs repo: use path to tspconfig.yaml.
- From an SDK language repo: use path to tsp-location.yaml.
Verify setup — Run azure-sdk-mcp:azsdk_verify_setup to confirm environment.
Generate — Run azure-sdk-mcp:azsdk_package_generate_code with the config file path.
Build — Run azure-sdk-mcp:azsdk_package_build_code. If build succeeds, proceed to step 8.
Customize — If build fails, or if user requests SDK modifications, run azure-sdk-mcp:azsdk_customized_code_update with the build errors or user request. The tool handles the full workflow internally: it classifies the issue, applies TypeSpec decorators and/or code patches, regenerates the SDK, and builds — all in one call. See customization workflow.
Commit checkpoint — Prompt the user to commit generated changes before proceeding. See commit checkpoint details.
Validate — Run azure-sdk-mcp:azsdk_package_run_check and azure-sdk-mcp:azsdk_package_run_tests.
Metadata — Run azure-sdk-mcp:azsdk_package_update_changelog_content, azure-sdk-mcp:azsdk_package_update_metadata, and azure-sdk-mcp:azsdk_package_update_version. (Note: For .NET data plane, skip this step — metadata, changelog, and version updates are per-commit tasks, not part of the generate/build/test workflow.)
Final commit — Prompt the user to commit final changes (changelog, metadata, version). See commit checkpoint details.

SDK repos | Customization workflow | Detailed workflow

Guardrails

NEVER modify generated SDK code files directly for customizations. Always use azure-sdk-mcp:azsdk_customized_code_update. It handles classification, TypeSpec decorators, code patches, regeneration, and build as a single atomic workflow.
If azure-sdk-mcp:azsdk_customized_code_update fails or times out, report the error to the user and suggest retrying. Do not attempt to replicate its behavior by editing files manually.
Only the customization tool understands the correct layering of TypeSpec decorators vs code patches and ensures regenerated code stays consistent.

Examples

"Generate the SDK locally for my TypeSpec service"
"Build and test the Python SDK package"
"Run CI checks for my SDK package"
"Fix the SDK build errors on this PR"
"The SDK generation has breaking changes, resolve them"
"Rename FooClient to BarClient for .NET"
"Hide the internal polling operation from the Python SDK"
"Fix .NET analyzer errors AZC0030 and AZC0012"
"The build is failing because a customization references a renamed property"
"Create a subclient architecture for the Python SDK"
"Apply TypeSpec customizations to fix compilation errors"
"Update the changelog for this SDK package"
"Update the package version"
"Update the package metadata and ci.yml"

Troubleshooting

Run azure-sdk-mcp:azsdk_verify_setup to confirm MCP and tools.
If build fails with type conflicts, breaking changes, analyzer errors, or customization drift, use azure-sdk-mcp:azsdk_customized_code_update to apply customizations.
The customization tool uses a two-phase approach: TypeSpec decorators first (Phase A), then code repairs if needed (Phase B).
If azure-sdk-mcp:azsdk_customized_code_update fails or times out, report the error and retry. Do not manually edit generated SDK code — manual edits will be overwritten on the next regeneration.
Without MCP, use npx tsp-client CLI.

More from this repository

same repository

create-package-skill

Azure/azure-sdk-for-python

Interactive wizard that walks service teams through creating a package-specific skill for their Azure SDK package. Scans the package, detects customization patterns, scaffolds a SKILL.md with references, and validates with vally lint. The skill is placed inside the package's .github/skills/ directory so find-package-skill discovers it automatically. WHEN: create package skill; add service skill; bootstrap skill for package; new package skill; skill for my SDK package; write skill for search; write skill for cosmos.

2026-06-155.6k

find-package-skill

Azure/azure-sdk-for-python

**UTILITY SKILL** — Must be consulted before making any changes to packages under sdk/. Discovers and loads package-specific domain knowledge that prevents common mistakes. WHEN: "add feature to package", "fix bug in package", "modify package code", "regenerate from typespec", "change client library".

2026-06-155.6k

azsdk-common-prepare-release-plan

Azure/azure-sdk-for-python

Create, get, update, abandon, and link SDK PRs to release plan work items for Azure SDK releases. **UTILITY SKILL**. USE FOR: "create release plan", "get release plan", "update release plan", "update API spec in release plan", "update SDK details in release plan", "abandon release plan", "link SDK PR to plan", "namespace approval", "check release plan status". DO NOT USE FOR: SDK code generation, pipeline troubleshooting, API review feedback. INVOKES: azure-sdk-mcp:azsdk_create_release_plan, azure-sdk-mcp:azsdk_get_release_plan, azure-sdk-mcp:azsdk_get_release_plan_for_spec_pr, azure-sdk-mcp:azsdk_update_release_plan, azure-sdk-mcp:azsdk_update_api_spec_pull_request_in_release_plan, azure-sdk-mcp:azsdk_update_sdk_details_in_release_plan, azure-sdk-mcp:azsdk_abandon_release_plan, azure-sdk-mcp:azsdk_link_sdk_pull_request_to_release_plan, azure-sdk-mcp:azsdk_link_namespace_approval_issue.

2026-06-155.6k

create-api-review-pr

Azure/azure-sdk-for-python

Create a GitHub PR for API review by comparing a baseline API surface against a target tag or branch. Use this when the user wants to create an API review PR, compare API changes between versions, or review API surface differences for a package.

2026-06-125.6k

generate-api-markdown

Azure/azure-sdk-for-python

Generate an API markdown file and token file using ApiView. Use this when the user wants to generate an API markdown file and review API changes.

2026-06-125.6k

azsdk-common-apiview-feedback-resolution

Azure/azure-sdk-for-python

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_customized_code_update, azure-sdk-mcp:azsdk_typespec_delegate_apiview_feedback, azure-sdk-mcp:azsdk_run_typespec_validation, azure-sdk-mcp:azsdk_package_generate_code.

2026-06-125.6k

name	azsdk-common-generate-sdk-locally
license	MIT
metadata	{"version":"1.1.0","distribution":"shared"}
description	Generate, build, and test Azure SDKs locally from TypeSpec with automatic customization. WHEN: "generate SDK locally", "build SDK", "run SDK tests", "run CI checks", "validate package", "run checks", "update changelog", "fix SDK build errors", "fix breaking changes", "resolve SDK generation errors", "customize TypeSpec", "rename SDK client", "rename SDK model", "hide operation from SDK", "fix analyzer errors", "resolve customization drift", "create subclient", "update metadata", "update version". DO NOT USE FOR: publishing to package registries, CI pipeline configuration, API design review. INVOKES: azsdk_verify_setup, azsdk_package_generate_code, azsdk_package_build_code, azsdk_package_run_check, azsdk_package_run_tests, azsdk_customized_code_update, azsdk_package_update_changelog_content, azsdk_package_update_metadata, azsdk_package_update_version.
compatibility	azure-sdk-mcp server, local azure-sdk-for-{language} clone, language build tools

Generate SDK Locally

Triggers

Rules

Requires the azure-sdk-mcp server for the MCP workflow; without MCP, use npm exec --prefix eng/common/tsp-client -- tsp-client CLI.
Verify the target language repo and the correct TypeSpec configuration file before generation.
After generation or customization, run the check and test steps before updating metadata or finalizing changes.

MCP Tools

Tool	Purpose
`azure-sdk-mcp:azsdk_verify_setup`	Verify environment
`azure-sdk-mcp:azsdk_package_generate_code`	Generate SDK
`azure-sdk-mcp:azsdk_package_build_code`	Build package
`azure-sdk-mcp:azsdk_package_run_check`	Validate package
`azure-sdk-mcp:azsdk_package_run_tests`	Run tests
`azure-sdk-mcp:azsdk_customized_code_update`	Apply customizations (includes regeneration and build)
`azure-sdk-mcp:azsdk_package_update_changelog_content`	Update changelog
`azure-sdk-mcp:azsdk_package_update_metadata`	Update metadata including ci.yml
`azure-sdk-mcp:azsdk_package_update_version`	Update version

Prerequisites: azure-sdk-mcp server must be running. Without MCP, use npx tsp-client CLI.

Steps

Select language — Confirm target language: .NET, Java, JavaScript, Python, Go, or Rust.
Verify repo — Ensure the user has a local clone of the correct SDK repo. If not cloned, instruct user to clone it.
Identify config file — Determine the path to the TypeSpec configuration file. See config file details.
- From azure-rest-api-specs repo: use path to tspconfig.yaml.
- From an SDK language repo: use path to tsp-location.yaml.
Verify setup — Run azure-sdk-mcp:azsdk_verify_setup to confirm environment.
Generate — Run azure-sdk-mcp:azsdk_package_generate_code with the config file path.
Build — Run azure-sdk-mcp:azsdk_package_build_code. If build succeeds, proceed to step 8.
Customize — If build fails, or if user requests SDK modifications, run azure-sdk-mcp:azsdk_customized_code_update with the build errors or user request. The tool handles the full workflow internally: it classifies the issue, applies TypeSpec decorators and/or code patches, regenerates the SDK, and builds — all in one call. See customization workflow.
Commit checkpoint — Prompt the user to commit generated changes before proceeding. See commit checkpoint details.
Validate — Run azure-sdk-mcp:azsdk_package_run_check and azure-sdk-mcp:azsdk_package_run_tests.
Metadata — Run azure-sdk-mcp:azsdk_package_update_changelog_content, azure-sdk-mcp:azsdk_package_update_metadata, and azure-sdk-mcp:azsdk_package_update_version. (Note: For .NET data plane, skip this step — metadata, changelog, and version updates are per-commit tasks, not part of the generate/build/test workflow.)
Final commit — Prompt the user to commit final changes (changelog, metadata, version). See commit checkpoint details.

SDK repos | Customization workflow | Detailed workflow

Guardrails

NEVER modify generated SDK code files directly for customizations. Always use azure-sdk-mcp:azsdk_customized_code_update. It handles classification, TypeSpec decorators, code patches, regeneration, and build as a single atomic workflow.
If azure-sdk-mcp:azsdk_customized_code_update fails or times out, report the error to the user and suggest retrying. Do not attempt to replicate its behavior by editing files manually.
Only the customization tool understands the correct layering of TypeSpec decorators vs code patches and ensures regenerated code stays consistent.

Examples

"Generate the SDK locally for my TypeSpec service"
"Build and test the Python SDK package"
"Run CI checks for my SDK package"
"Fix the SDK build errors on this PR"
"The SDK generation has breaking changes, resolve them"
"Rename FooClient to BarClient for .NET"
"Hide the internal polling operation from the Python SDK"
"Fix .NET analyzer errors AZC0030 and AZC0012"
"The build is failing because a customization references a renamed property"
"Create a subclient architecture for the Python SDK"
"Apply TypeSpec customizations to fix compilation errors"
"Update the changelog for this SDK package"
"Update the package version"
"Update the package metadata and ci.yml"

Troubleshooting

Run azure-sdk-mcp:azsdk_verify_setup to confirm MCP and tools.
If build fails with type conflicts, breaking changes, analyzer errors, or customization drift, use azure-sdk-mcp:azsdk_customized_code_update to apply customizations.
The customization tool uses a two-phase approach: TypeSpec decorators first (Phase A), then code repairs if needed (Phase B).
If azure-sdk-mcp:azsdk_customized_code_update fails or times out, report the error and retry. Do not manually edit generated SDK code — manual edits will be overwritten on the next regeneration.
Without MCP, use npx tsp-client CLI.