{"owner":"Azure","repo":"azure-sdk-for-python","hasSkills":true,"totalSkillsCount":118,"totalTokensCount":45712,"categories":["anthropic-skill","root-instruction","copilot-instructions","mcp-config","subagent-persona","plugin-manifest"],"hasMcp":true,"mcpConfig":{"mcpServers":{"azure-sdk-for-python":{"command":"npx","args":["-y","@modelcontextprotocol/server-azure-sdk-for-python"]}}},"found":[".github/skills/azsdk-common-pipeline-fixer/SKILL.md",".github/skills/azsdk-common-apiview-feedback-resolution/SKILL.md",".github/skills/azsdk-common-pipeline-analysis/SKILL.md",".github/skills/agentic-workflows/SKILL.md",".github/skills/azsdk-common-prepare-release-plan/SKILL.md",".github/skills/azsdk-common-generate-sdk-locally/SKILL.md",".github/skills/azsdk-common-sdk-breaking-change/SKILL.md",".github/skills/code-review/SKILL.md",".github/skills/create-api-review/SKILL.md",".github/skills/create-package-skill/SKILL.md",".github/skills/azsdk-common-sdk-release/SKILL.md",".github/skills/find-package-skill/SKILL.md",".github/skills/fix-black/SKILL.md",".github/skills/fix-mypy/SKILL.md",".github/skills/fix-pylint/SKILL.md",".github/skills/fix-sphinx/SKILL.md",".github/skills/generate-api-markdown/SKILL.md",".github/skills/sdk-health/SKILL.md",".github/skills/create-package-skill/phases/01-scaffold-skill.md",".github/skills/eng/next-version-update/SKILL.md",".github/skills/ml/do-code-review/SKILL.md",".github/skills/ml/fix-mypy/SKILL.md",".github/skills/ml/fix-pylint/SKILL.md","sdk/ai/azure-ai-projects/.github/skills/azure-ai-projects-author-samples/SKILL.md","sdk/ai/azure-ai-projects/.github/skills/azure-ai-projects-author-tests/SKILL.md","sdk/ai/azure-ai-projects/.github/skills/azure-ai-projects-emit-from-typespec/SKILL.md","sdk/ai/azure-ai-projects/.github/skills/azure-ai-projects-model-reference-graph/SKILL.md","sdk/ai/azure-ai-projects/.github/skills/azure-ai-projects-run-issue-regeneration/SKILL.md","sdk/ai/azure-ai-projects/.github/skills/azure-ai-projects-update-changelog/SKILL.md","sdk/contentunderstanding/azure-ai-contentunderstanding/.github/skills/cu-sdk-author-analyzer-classify-route/SKILL.md","sdk/contentunderstanding/azure-ai-contentunderstanding/.github/skills/cu-sdk-author-analyzer/SKILL.md","sdk/contentunderstanding/azure-ai-contentunderstanding/.github/skills/cu-sdk-common-knowledge/SKILL.md","sdk/contentunderstanding/azure-ai-contentunderstanding/.github/skills/cu-sdk-sample-run/SKILL.md","sdk/contentunderstanding/azure-ai-contentunderstanding/.github/skills/cu-sdk-setup/SKILL.md","sdk/ai/azure-ai-projects/samples/skills/assets/canvas-design/SKILL.md","sdk/ai/azure-ai-projects/samples/skills/assets/team-status-update/SKILL.md","AGENTS.md",".github/copilot-instructions.md",".vscode/mcp.json",".github/agents/agentic-workflows.md","scripts/old_packages/README.md","eng/tools/azure-sdk-tools/README.md","eng/tools/azure-sdk-tools/changelog_generics.md","sdk/kubernetesconfiguration/azure-mgmt-kubernetesconfiguration-extensions/README.md",".github/skills/azsdk-common-apiview-feedback-resolution/evals/eval.yaml",".github/skills/azsdk-common-apiview-feedback-resolution/evals/trigger.eval.yaml",".github/skills/azsdk-common-apiview-feedback-resolution/fixtures/apiview-comment.json",".github/skills/azsdk-common-apiview-feedback-resolution/references/feedback-resolution-steps.md",".github/skills/azsdk-common-generate-sdk-locally/evals/eval.yaml",".github/skills/azsdk-common-generate-sdk-locally/evals/trigger.eval.yaml",".github/skills/azsdk-common-generate-sdk-locally/fixtures/tspconfig.yaml",".github/skills/azsdk-common-generate-sdk-locally/references/customization-workflow.md",".github/skills/azsdk-common-generate-sdk-locally/references/detailed-workflow.md",".github/skills/azsdk-common-generate-sdk-locally/references/sdk-repos.md",".github/skills/azsdk-common-pipeline-analysis/evals/trigger.eval.yaml",".github/skills/azsdk-common-pipeline-analysis/references/failure-patterns.md",".github/skills/azsdk-common-pipeline-analysis/references/output-format.md",".github/skills/azsdk-common-pipeline-fixer/evals/trigger.eval.yaml",".github/skills/azsdk-common-prepare-release-plan/evals/eval.yaml",".github/skills/azsdk-common-prepare-release-plan/evals/schedule-risk.eval.yaml",".github/skills/azsdk-common-prepare-release-plan/evals/trigger.eval.yaml",".github/skills/azsdk-common-prepare-release-plan/fixtures/tspconfig.yaml",".github/skills/azsdk-common-prepare-release-plan/references/release-plan-details.md",".github/skills/azsdk-common-sdk-breaking-change/evals/eval.yaml",".github/skills/azsdk-common-sdk-breaking-change/evals/trigger.eval.yaml",".github/skills/azsdk-common-sdk-release/evals/eval.yaml",".github/skills/azsdk-common-sdk-release/evals/trigger.eval.yaml",".github/skills/code-review/evals/trigger.eval.yaml",".github/skills/create-package-skill/phases/00-scan-package.md",".github/skills/create-package-skill/phases/02-generate-references.md",".github/skills/create-package-skill/phases/03-validate.md",".github/skills/create-package-skill/phases/04-finalize.md",".github/skills/create-package-skill/references/skill-template.md",".github/skills/create-package-skill/references/validation-tools.md",".github/skills/sdk-health/evals/trigger.eval.yaml","eng/tools/azure-sdk-tools/devtools_testutils/README.md","eng/tools/azure-sdk-tools/tests/data/azure-mgmt-containerservice-41.4.0b1-CHANGELOG.md","eng/tools/azure-sdk-tools/tests/data/azure-mgmt-containerservice-41.4.0b1-CHANGELOG.trimmed.md","eng/tools/azure-sdk-tools/tests/data/azure-mgmt-cosmosdb-10.0.0b6-CHANGELOG.md","eng/tools/azure-sdk-tools/tests/data/azure-mgmt-cosmosdb-10.0.0b6-CHANGELOG.trimmed.md","eng/tools/azure-sdk-tools/tests/data/azure-mgmt-datafactory-10.0.0b1-CHANGELOG.md","eng/tools/azure-sdk-tools/tests/data/azure-mgmt-datafactory-10.0.0b1-CHANGELOG.trimmed.md","eng/tools/azure-sdk-tools/tests/data/azure-mgmt-network-31.0.0-CHANGELOG.md","eng/tools/azure-sdk-tools/tests/data/azure-mgmt-network-31.0.0-CHANGELOG.trimmed.md","eng/tools/azure-sdk-tools/tests/data/azure-mgmt-sql-4.0.0-CHANGELOG.md","eng/tools/azure-sdk-tools/tests/data/azure-mgmt-sql-4.0.0-CHANGELOG.trimmed.md","eng/tools/azure-sdk-tools/tests/integration/README.md","sdk/ai/azure-ai-projects/.github/skills/README.md","eng/tools/azure-sdk-tools/devtools_testutils/perfstress_tests/system_perfstress/README.md","eng/tools/azure-sdk-tools/packaging_tools/templates/packaging_files/CHANGELOG.md","eng/tools/azure-sdk-tools/packaging_tools/templates/packaging_files/README.md","sdk/ai/azure-ai-projects/samples/agents/assets/product_info.md","sdk/ai/azure-ai-projects/samples/agents/assets/tripadvisor_openapi.json","sdk/ai/azure-ai-projects/samples/agents/assets/weather_openapi.json","sdk/contentunderstanding/azure-ai-contentunderstanding/.github/skills/_shared/README.md","eng/tools/azure-sdk-tools/tests/integration/scenarios/dev_requirement_samples/README.md","eng/tools/azure-sdk-tools/tests/integration/scenarios/optional_environment_two_options/README.md","eng/tools/azure-sdk-tools/tests/integration/scenarios/optional_environment_zero_options/README.md","eng/tools/azure-sdk-tools/tests/integration/scenarios/pyproject_beta_invalid_metadata/README.md","eng/tools/azure-sdk-tools/tests/integration/scenarios/pyproject_beta_metadata/README.md","eng/tools/azure-sdk-tools/tests/integration/scenarios/pyproject_build_config/README.md","eng/tools/azure-sdk-tools/tests/integration/scenarios/pyproject_invalid_metadata/README.md","eng/tools/azure-sdk-tools/tests/integration/scenarios/pyproject_metadata/README.md","eng/tools/azure-sdk-tools/tests/integration/scenarios/pyproject_project_def/README.md","eng/tools/azure-sdk-tools/tests/integration/scenarios/pyproject_project_def_beta/README.md","eng/tools/azure-sdk-tools/tests/integration/scenarios/pyproject_project_def_with_extension/README.md","eng/tools/azure-sdk-tools/tests/integration/scenarios/setup_py_metapackage/README.md","eng/tools/azure-sdk-tools/tests/integration/scenarios/setup_py_project_def/README.md","eng/tools/azure-sdk-tools/tests/integration/scenarios/snippet-updater/README.md","eng/tools/azure-sdk-tools/tests/integration/scenarios/snippet-updater/README_missing_snippet.md","eng/tools/azure-sdk-tools/tests/integration/scenarios/snippet-updater/README_out_of_sync.md","sdk/ai/azure-ai-projects/.github/skills/azure-ai-projects-author-samples/prompts/diff-api-surface.prompt.md","sdk/ai/azure-ai-projects/.github/skills/azure-ai-projects-author-samples/references/sample-conventions.md","sdk/ai/azure-ai-projects/.github/skills/azure-ai-projects-author-tests/references/test-conventions.md","sdk/ai/azure-ai-projects/samples/skills/assets/team-status-update/status-update-template.md","sdk/contentunderstanding/azure-ai-contentunderstanding/.github/skills/cu-sdk-author-analyzer-classify-route/templates/classifier_template.json","sdk/contentunderstanding/azure-ai-contentunderstanding/.github/skills/cu-sdk-author-analyzer/scripts/README.md","sdk/contentunderstanding/azure-ai-contentunderstanding/.github/skills/cu-sdk-author-analyzer/templates/schema_template.json"],"skills":{".github/skills/azsdk-common-pipeline-fixer/SKILL.md":"---\nname: azsdk-common-pipeline-fixer\nlicense: MIT\nmetadata:\n version: \"1.0.0\"\n distribution: shared\ndescription: 'Automatically fix Azure SDK CI/CD pipeline failures by applying code changes and verifying locally. USE FOR: \"fix pipeline failure\", \"fix CI\", \"fix failing tests\", \"auto-fix and commit the fix\", \"fix build error\", \"fix mypy/pylint/type-check/lint errors\", \"auto-fix pipeline\", \"resolve pipeline failure\". DO NOT USE FOR: pipeline analysis (instead use azsdk-common-pipeline-analysis), API design review, SDK publishing. INVOKES: azure-sdk-mcp:azsdk_package_build_code, azure-sdk-mcp:azsdk_package_run_check, azure-sdk-mcp:azsdk_package_run_tests, azure-sdk-mcp:azsdk_verify_setup.'\ncompatibility: \"azure-sdk-mcp server, local azure-sdk-for-{language} clone, language build tools\"\n---\n\n# Pipeline Fixer\n\nThis skill automatically fixes Azure SDK CI/CD pipeline failures. It analyzes the failure, identifies the root cause, applies code changes, and verifies the fix locally using build, check, and test tools before committing.\n\n## Rules\n\n- Requires the `azure-sdk-mcp` server and a local clone of the SDK language repo.\n- Work on the PR branch — the failing code is there, not main.\n- Analyze first, then apply the minimal code change for the root cause.\n- Verify ONLY via the azsdk MCP package tools (build → check → tests); never raw shell build/test commands.\n- Never fix infrastructure failures (timeouts, crashes, throttling) — recommend retry. Iterate up to 3 times, then report.\n\n## MCP Tools\n\n| Tool | Purpose |\n| ---------------------------------------- | ------------------------------------- |\n| `azure-sdk-mcp:azsdk_verify_setup` | Verify local environment is ready |\n| `azure-sdk-mcp:azsdk_package_build_code` | Build the package locally |\n| `azure-sdk-mcp:azsdk_package_run_check` | Run validation/lint/typecheck locally |\n| `azure-sdk-mcp:azsdk_package_run_tests` | Run tests locally |\n\n**Prerequisites:** azure-sdk-mcp server required. Local clone of the affected SDK language repo. Language build tools installed.\n\n## Steps\n\n1. **Find analysis** - Reuse an existing analysis from the PR comments; if none, view the `azsdk-common-pipeline-analysis` skill.\n2. **Classify** - Fixable (test, type, lint, import, assertion errors) vs retry (infrastructure) vs escalate (breaking API, credentials).\n3. **Locate** - Identify the affected package, its path, and the files/lines to change.\n4. **Fix** - Read the failing code at the cited lines and apply the minimal fix.\n5. **Verify** - Run `azsdk_package_build_code` → `azsdk_package_run_check` → `azsdk_package_run_tests` on the package; all must pass. If the environment isn't ready, run `azsdk_verify_setup`. Never substitute raw shell build/test commands.\n6. **Iterate & commit** - On failure, revise and re-verify (max 3 attempts). Once all pass, commit with a descriptive message.\n\n## Examples\n\n- \"Fix the pipeline failure for build 6447834\"\n- \"My Python SDK CI is failing with a type error, fix it\"\n- \"Auto-fix the failing tests in my PR\"\n\n## Troubleshooting\n\n- If the verify tools fail because the environment isn't ready, run `azsdk_verify_setup`, report its error, and stop — don't fall back to raw shell build/test commands.\n",".github/skills/azsdk-common-apiview-feedback-resolution/SKILL.md":"---\nname: azsdk-common-apiview-feedback-resolution\nlicense: MIT\nmetadata:\n version: \"1.0.0\"\n distribution: shared\ndescription: \"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.\"\ncompatibility: \"azure-sdk-mcp server, SDK pull request with APIView review link\"\n---\n\n# APIView Feedback Resolution\n\nThis skill analyzes and resolves APIView review feedback on Azure SDK pull requests by retrieving reviewer comments, categorizing them, and applying TypeSpec or customization updates that bring the SDK API surface into compliance before re-review.\n\n## Triggers\n\nUSE FOR: APIView comments, API review feedback, SDK API surface changes\nWHEN: \"resolve APIView comments\", \"address API review feedback\", \"update SDK API surface after APIView\"\nDO NOT USE FOR: general code review, non-APIView feedback\n\n## Rules\n\n- Requires the `azure-sdk-mcp` server; there is no CLI fallback for retrieving APIView comments or applying TypeSpec changes.\n- Retrieve and categorize APIView comments before making changes so fixes map to reviewer intent.\n- Validate, regenerate, build, and test after applying fixes before requesting re-review.\n\n## MCP Tools\n\n| Tool | Purpose |\n| -------------------------------------------------------- | --------------------------------------------------- |\n| `azure-sdk-mcp:azsdk_apiview_get_comments` | Get APIView comments |\n| `azure-sdk-mcp:azsdk_customized_code_update` | Apply TypeSpec & code customization changes locally |\n| `azure-sdk-mcp:azsdk_typespec_delegate_apiview_feedback` | Delegate to CCA pipeline |\n| `azure-sdk-mcp:azsdk_run_typespec_validation` | Validate TypeSpec |\n| `azure-sdk-mcp:azsdk_package_generate_code` | Regenerate SDK |\n\n## Steps\n\n1. **Retrieve** — Get APIView URL from SDK PR, run `azsdk_apiview_get_comments`.\n2. **Categorize** — Group as Critical/Suggestions/Informational per [feedback steps](references/feedback-resolution-steps.md).\n3. **Resolve** — Use `azsdk_customized_code_update` for TypeSpec changes; delegate via `azsdk_typespec_delegate_apiview_feedback` for complex cases.\n4. **Validate** — Run validation, regenerate SDK, build and test.\n5. **Confirm** — Verify all items addressed. If delegated, follow [post-delegation follow-up](references/feedback-resolution-steps.md#post-delegation-follow-up). Request re-review.\n\n## Examples\n\n- \"Resolve the APIView comments on my SDK pull request\"\n- \"What feedback did the API reviewer leave?\"\n\n## Troubleshooting\n\n- **No comments**: Verify PR has APIView link and MCP server is connected.\n- **Validation fails**: Re-run after fixing TypeSpec errors.\n- **MCP unavailable**: Requires `azure-sdk-mcp` server; no CLI fallback. Connect the server and retry.\n",".github/skills/azsdk-common-pipeline-analysis/SKILL.md":"---\nname: azsdk-common-pipeline-analysis\nlicense: MIT\nmetadata:\n version: \"1.0.0\"\n distribution: shared\ndescription: 'Analyze Azure SDK CI/CD pipeline failures into a structured diagnosis, and define the required output format. Load this skill before calling azsdk_analyze_pipeline, which returns raw failure data that this skill interprets and formats. USE FOR: \"pipeline failed\", \"build failure\", \"CI check failing\", \"tests failing in CI\", \"analyze pipeline\", \"debug SDK pipeline\". DO NOT USE FOR: local build issues without pipeline context, API design review, SDK publishing, applying code fixes (instead use azsdk-common-pipeline-fixer). INVOKES: azure-sdk-mcp:azsdk_analyze_pipeline, azure-sdk-mcp:azsdk_get_pipeline_llm_artifacts, azure-sdk-mcp:azsdk_get_failed_test_run_data, azure-sdk-mcp:azsdk_get_failed_test_case_data, azure-sdk-mcp:azsdk_get_pr_checks, azure-sdk-mcp:azsdk_get_pipeline_status.'\ncompatibility: \"azure-sdk-mcp server, Azure DevOps pipeline build ID or GitHub PR link\"\n---\n\n# Pipeline Analysis\n\nThis skill analyzes Azure SDK CI/CD pipeline failures and provides a structured diagnosis including root cause, affected files, and concrete instructions for how to fix each issue. It does NOT apply fixes - it tells you exactly what's wrong and how to resolve it.\n\n## Rules\n\n- Load this skill **before** running `azsdk_analyze_pipeline` — the tool returns raw failure data that this skill interprets and formats per [output format](references/output-format.md).\n- Requires the `azure-sdk-mcp` server; without it, inspect logs in the Azure DevOps UI.\n- Analysis-only: never edit files or apply fixes — use `azsdk-common-pipeline-fixer` for changes.\n- Run `azsdk_analyze_pipeline` first, then categorize each failure and cite specific files/lines.\n- For infrastructure failures (network timeouts, agent crashes, throttling), recommend retry, not code changes.\n\n## MCP Tools\n\n| Tool | Purpose |\n| ------------------------------------------------ | --------------------------------------------------- |\n| `azure-sdk-mcp:azsdk_analyze_pipeline` | Analyze pipeline failure (logs + test results) |\n| `azure-sdk-mcp:azsdk_get_pipeline_llm_artifacts` | Download test result artifacts from pipeline |\n| `azure-sdk-mcp:azsdk_get_failed_test_run_data` | Full details for every failure in one artifact file |\n| `azure-sdk-mcp:azsdk_get_failed_test_case_data` | Full details for a single failing test in a file |\n| `azure-sdk-mcp:azsdk_get_pr_checks` | Get pipeline/check results linked to a PR |\n| `azure-sdk-mcp:azsdk_get_pipeline_status` | Get pipeline run status |\n\n## Steps\n\n1. **Identify** - Get the build ID, pipeline URL, or PR link (use the PR link when triggered from a PR comment).\n2. **Analyze** - Run `azsdk_analyze_pipeline`. It returns `failed_pipeline_tasks` (log errors from failed steps) and `failed_pipeline_tests`, a lightweight index of failed tests grouped by artifact file. Each entry has `artifact_file_path`, `platform`, and `failed_test_titles` — titles only, no error text, to keep the response small.\n3. **Fetch failure details** - Fetch failure details lazily so you don't overload context: call `azsdk_get_failed_test_run_data` with the parameter `failedTestRunsPath` set to `artifact_file_path` once per file to get every failure in it. Or call `azsdk_get_failed_test_case_data` with\n `failedTestRunsPath` set to `artifact_file_path` and `testCaseTitle` set to one exact title from `failed_test_titles`. Prefer the per-file call when triaging a whole file's failures.\n4. **Categorize** each failure: test, build/compilation, validation/lint, or infrastructure.\n5. **Diagnose** - Give each failure's root cause and affected file(s)/line(s), and note if several share one root cause. See [failure patterns](references/failure-patterns.md).\n6. **Report** - Use the [output format](references/output-format.md): root cause, affected files, per-failure fix + verify command, and fixable vs infrastructure. Recommend `azsdk-common-pipeline-fixer` to apply fixes.\n\n## Examples\n\n- \"My pipeline build 6447834 failed, what went wrong?\"\n- PR comment: `@copilot Analyze the failed pipeline on this PR`\n- \"Why is my CI red? Build ID is 6455939\"\n\n## Troubleshooting\n\n- If `azsdk_analyze_pipeline` returns no data, verify the build ID is correct and the run has completed.\n- If `failed_pipeline_tests` is empty, rely on `failed_pipeline_tasks` log analysis (test-artifact upload may not be configured).\n- For a private/internal pipeline, the user may need to `az login`. See [failure patterns](references/failure-patterns.md).\n",".github/skills/agentic-workflows/SKILL.md":"---\nname: agentic-workflows\ndescription: Route gh-aw workflow design/create/debug/upgrade requests to the right prompts.\n---\n\n# Agentic Workflows Router\n\nUse this skill when a user asks to design, create, update, debug, or upgrade GitHub Agentic Workflows in this repository.\n\nThis skill is a dispatcher: identify the task type, load the matching workflow prompt/skill file, and follow it directly. Keep responses concise and ask a clarifying question if the correct prompt is unclear.\n\nRepository overlay (optional):\n- If `.github/aw/instructions.md` exists, load it with `@.github/aw/instructions.md` after loading the matched prompt/skill.\n- Precedence: repository overlay instructions override upstream defaults when they conflict.\n\nRead only the files you need:\nLoad these files from `github/gh-aw` (they are not available locally).\n- `.github/aw/action-container-substitutions.md`\n- `.github/aw/agent-runtime-instructions.md`\n- `.github/aw/agentic-chat.md`\n- `.github/aw/agentic-workflows-mcp.md`\n- `.github/aw/asciicharts.md`\n- `.github/aw/campaign.md`\n- `.github/aw/charts-trending.md`\n- `.github/aw/charts.md`\n- `.github/aw/cli-commands.md`\n- `.github/aw/compat.md`\n- `.github/aw/configure-agentic-engine.md`\n- `.github/aw/context.md`\n- `.github/aw/create-agentic-workflow-trigger-details.md`\n- `.github/aw/create-agentic-workflow.md`\n- `.github/aw/create-shared-agentic-workflow.md`\n- `.github/aw/debug-agentic-workflow.md`\n- `.github/aw/dependabot.md`\n- `.github/aw/deployment-status.md`\n- `.github/aw/designer-mappings.md`\n- `.github/aw/designer.md`\n- `.github/aw/drive-memory.md`\n- `.github/aw/enclaves.md`\n- `.github/aw/evals.md`\n- `.github/aw/experiments.md`\n- `.github/aw/github-agentic-workflows.md`\n- `.github/aw/github-mcp-server-pagination.md`\n- `.github/aw/github-mcp-server-tools.md`\n- `.github/aw/github-mcp-server.md`\n- `.github/aw/instructions.md`\n- `.github/aw/intent.md`\n- `.github/aw/jobs.md`\n- `.github/aw/linter-workflows.md`\n- `.github/aw/llms.md`\n- `.github/aw/loop.md`\n- `.github/aw/lsp.md`\n- `.github/aw/maintainer.md`\n- `.github/aw/mcp-clis.md`\n- `.github/aw/memory-stateful-patterns.md`\n- `.github/aw/memory.md`\n- `.github/aw/messages.md`\n- `.github/aw/multi-agent-research.md`\n- `.github/aw/network.md`\n- `.github/aw/optimize-agentic-workflow.md`\n- `.github/aw/patterns.md`\n- `.github/aw/playwright.md`\n- `.github/aw/pr-reviewer.md`\n- `.github/aw/release-workflow.md`\n- `.github/aw/report.md`\n- `.github/aw/reuse.md`\n- `.github/aw/safe-outputs-automation.md`\n- `.github/aw/safe-outputs-content.md`\n- `.github/aw/safe-outputs-management.md`\n- `.github/aw/safe-outputs-runtime.md`\n- `.github/aw/safe-outputs.md`\n- `.github/aw/serena-tool.md`\n- `.github/aw/shared-safe-jobs.md`\n- `.github/aw/skills.md`\n- `.github/aw/subagents.md`\n- `.github/aw/syntax-agentic.md`\n- `.github/aw/syntax-core.md`\n- `.github/aw/syntax-engine.md`\n- `.github/aw/syntax-tools-imports.md`\n- `.github/aw/syntax.md`\n- `.github/aw/test-coverage.md`\n- `.github/aw/test-expression.md`\n- `.github/aw/token-optimization-caching-budgets.md`\n- `.github/aw/token-optimization-observability.md`\n- `.github/aw/token-optimization.md`\n- `.github/aw/triggers.md`\n- `.github/aw/update-agentic-workflow.md`\n- `.github/aw/upgrade-agentic-workflows.md`\n- `.github/aw/visual-regression.md`\n- `.github/aw/workflow-constraints.md`\n- `.github/aw/workflow-editing.md`\n- `.github/aw/workflow-patterns.md`\n\nAfter loading the matching workflow prompt or skill, follow it directly:\n- Design workflows from scratch via interview: `.github/aw/designer.md`\n- Create new workflows: `.github/aw/create-agentic-workflow.md`\n- Configure or add declarative engines: `.github/aw/configure-agentic-engine.md`\n- Update existing workflows: `.github/aw/update-agentic-workflow.md`\n- Debug, audit, or investigate workflows: `.github/aw/debug-agentic-workflow.md`\n- Upgrade workflows and fix deprecations: `.github/aw/upgrade-agentic-workflows.md`\n- Create shared components or MCP wrappers: `.github/aw/create-shared-agentic-workflow.md`\n- Create report-generating workflows: `.github/aw/report.md`\n- Fix Dependabot manifest PRs: `.github/aw/dependabot.md`\n- Analyze coverage workflows: `.github/aw/test-coverage.md`\n- Render compact markdown charts: `.github/aw/asciicharts.md`\n- Map CLI commands to MCP usage: `.github/aw/cli-commands.md`\n- Choose workflow architecture and patterns: `.github/aw/patterns.md`\n- Optimize token usage and cost: `.github/aw/token-optimization.md`\n- Design long-running multi-agent research workflows: `.github/aw/multi-agent-research.md`\n- Add skills or agent plugins requested by the user (`skills:` / `plugins:` frontmatter, never on-the-fly installs): `.github/aw/skills.md`\n\nWhen the task involves OTEL, OTLP, traces, observability backends, or telemetry-driven analysis, also read and follow `skills/otel-queries/SKILL.md` after loading the matching workflow prompt or skill.\n",".github/skills/azsdk-common-prepare-release-plan/SKILL.md":"---\nname: azsdk-common-prepare-release-plan\nlicense: MIT\nmetadata:\n version: \"1.0.0\"\n distribution: shared\ndescription: '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_update_release_plan, azure-sdk-mcp:azsdk_update_release_plan_target, 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.'\ncompatibility: \"azure-sdk-mcp server, API spec PR in Azure/azure-rest-api-specs\"\n---\n\n# Prepare Release Plan\n\nThis skill creates, gets, updates, abandons, and links SDK PRs to release plan work items for Azure SDK releases, helping gather required release data, validate spec inputs, and link related approvals or SDK pull requests without exposing internal work item URLs.\n\n## Triggers\n\nUSE 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\nWHEN: \"create release plan\", \"get release plan\", \"update release plan\", \"abandon release plan\", \"link SDK PR to plan\", \"namespace approval\", \"check release plan status\"\nDO NOT USE FOR: SDK code generation, pipeline troubleshooting, API review feedback\n\n## Rules\n\n- Do not display Azure DevOps work item URLs; only provide the Release Plan Link and ID.\n- Require an API spec PR link or a TypeSpec project path before creating or updating a plan.\n- Validate that the spec PR repository matches the requested API release type before creation.\n- Release plan tools accept **either** a Release Plan ID or an Azure DevOps work item ID — pass whichever the user provides. Each tool resolves the value automatically (trying it as a Release Plan ID first, then as a work item ID), so you do not need to call `azure-sdk-mcp:azsdk_get_release_plan` first just to translate one ID into the other.\n- Always relay schedule-risk `warnings` and `next_steps` returned by release plan tools. For each past-due plan, show its Release Plan ID and dashboard link, then present both choices: update its target release month or abandon it and record the reason in the dashboard.\n\n## MCP Tools\n\n| Tool | Purpose |\n| ------------------------------------------------------------------ | ---------------------------------- |\n| `azure-sdk-mcp:azsdk_create_release_plan` | Create a new release plan |\n| `azure-sdk-mcp:azsdk_get_release_plan` | Get plan by ID, path, or spec PR |\n| `azure-sdk-mcp:azsdk_update_release_plan` | Update release plan metadata |\n| `azure-sdk-mcp:azsdk_update_release_plan_target` | Update the target release month |\n| `azure-sdk-mcp:azsdk_update_api_spec_pull_request_in_release_plan` | Update API spec PR URL in plan |\n| `azure-sdk-mcp:azsdk_update_sdk_details_in_release_plan` | Update SDK/package details in plan |\n| `azure-sdk-mcp:azsdk_abandon_release_plan` | Abandon a release plan |\n| `azure-sdk-mcp:azsdk_link_sdk_pull_request_to_release_plan` | Link SDK PR to release plan |\n| `azure-sdk-mcp:azsdk_link_namespace_approval_issue` | Link namespace approval issue |\n\n---\n\n## Use Cases\n\n### 1. Create Release Plan\n\n**When**: User wants to create a release plan for a TypeSpec project.\n\n**Steps**:\n\n1. **Get TypeSpec Project Path** — Ask the user for the relative TypeSpec project path (directory containing `tspconfig.yaml`, e.g. `specification/contosowidgetmanager/Contoso.WidgetManager`). Always use the relative path from the repo root, not an absolute path.\n2. **Check Existing** — Run `azure-sdk-mcp:azsdk_get_release_plan` with the relative `typeSpecProjectPath` to check if a release plan already exists.\n - If a release plan exists with the **same API release type** the user requested: inform the user that a release plan already exists, show the Release Plan ID, status, and API release type. Suggest the user use the existing release plan. Do NOT create a new one.\n - If a release plan exists but for a **different API release type**: inform the user about the existing plan and its API release type, then proceed to create a new release plan using `forceCreateReleasePlan: true` for the user's requested API release type. Do NOT attempt to update the existing release plan's API release type.\n - If no release plan exists, proceed to step 3.\n3. **Gather Info** — Collect required details from the user. See [details](references/release-plan-details.md):\n - Target release month/year (format: \"Month YYYY\", e.g. \"June 2026\"). Do NOT use formats like \"2026-06\" or \"06/2026\" — these are invalid.\n - API release type: Value must be one of the following: \"Private Preview\", \"Public Preview\", or \"GA\"\n - SDK release type: Value must be \"beta\" or \"stable\" — always ask the user explicitly\n - Spec PR URL (optional)\n - Service Tree ID (GUID) — optional if previously created\n - Product Tree ID (GUID) — optional if previously created\n4. **Create** — Run `azure-sdk-mcp:azsdk_create_release_plan` with the collected parameters including `sdkReleaseType`. Use `forceCreateReleasePlan: true` only if an existing release plan was found for a different API release type.\n5. **Namespace** — For first management plane releases, link namespace approval issue using `azure-sdk-mcp:azsdk_link_namespace_approval_issue`.\n\n> **IMPORTANT**: Do NOT default the API release type value as the SDK release type. These are separate fields — always ask the user explicitly for the SDK release type.\n>\n> **IMPORTANT**: Do NOT update an existing release plan to change its API release type. If a release plan exists for a different API release type, force-create a new one instead.\n\n**Tool**: `azure-sdk-mcp:azsdk_create_release_plan`\n\n---\n\n### 2. Get Release Plan\n\n**When**: User wants to check the status or details of an existing release plan.\n\n**Steps**:\n\n1. **Identify Plan** — Ask user for one of:\n - Release plan ID or work item ID\n - Relative TypeSpec project path (e.g. `specification/contosowidgetmanager/Contoso.WidgetManager`)\n - Spec PR URL\n2. **Query** — Run `azure-sdk-mcp:azsdk_get_release_plan` with the provided identifier. Always use a relative path for `typeSpecProjectPath`; use `specPullRequestUrl` when the user provides only a spec PR URL.\n3. **Display** — Show the release plan ID, status, linked PRs, and SDK details. Always relay schedule-risk warnings and recommended actions from the response.\n\n**Tool**: `azure-sdk-mcp:azsdk_get_release_plan`\n\n---\n\n### 3. Update Release Plan / Update API Spec in Release Plan\n\n**When**: User needs to update release plan metadata (spec PR URL, TypeSpec project path, SDK release type, service/product IDs) or update the API spec PR link.\n\n**Steps**:\n\n1. **Identify Plan** — Get the work item ID or TypeSpec project path from the user.\n2. **Update Metadata** — Run `azure-sdk-mcp:azsdk_update_release_plan` with:\n - `typeSpecProjectPath` (required)\n - `workItemId` (optional — resolved from TypeSpec path or spec PR if not provided)\n - `specPullRequestUrl` (optional)\n - `sdkReleaseType` (required — do NOT default this from API release type; always ask user explicitly)\n - `serviceTreeId` (optional)\n - `productTreeId` (optional)\n3. **Update API Spec PR** — If only the spec PR URL needs updating, run `azure-sdk-mcp:azsdk_update_api_spec_pull_request_in_release_plan` with:\n - `specPullRequestUrl` (required)\n - `workItemId` or `releasePlanId`\n\n**Tools**: `azure-sdk-mcp:azsdk_update_release_plan`, `azure-sdk-mcp:azsdk_update_api_spec_pull_request_in_release_plan`\n\n---\n\n### 4. Update SDK/Package Details in Release Plan\n\n**When**: User needs to update SDK language and package name details in the release plan after code generation or configuration changes.\n\n**Steps**:\n\n1. **Identify Plan** — Get the Release Plan ID or work item ID from the user (either is accepted).\n2. **Identify TypeSpec Project** — Get or confirm the TypeSpec project path.\n3. **Update** — Run `azure-sdk-mcp:azsdk_update_sdk_details_in_release_plan` with:\n - `workItemId` (required — accepts either the Release Plan ID or the work item ID)\n - `typeSpecProjectPath` (required)\n\n**Tool**: `azure-sdk-mcp:azsdk_update_sdk_details_in_release_plan`\n\n---\n\n### 5. Abandon a Release Plan\n\n**When**: User decides to cancel or discard a release plan that is no longer needed.\n\n**Steps**:\n\n1. **Identify Plan** — Get the work item ID or release plan ID from the user.\n2. **Confirm** — Ask user to confirm abandonment: \"Are you sure you want to abandon this release plan? This action updates the status to Abandoned.\"\n3. **Abandon** — Run `azure-sdk-mcp:azsdk_abandon_release_plan` with:\n - `workItemId` or `releasePlanId`\n\n**Tool**: `azure-sdk-mcp:azsdk_abandon_release_plan`\n\n---\n\n### 6. Link SDK Pull Request to Release Plan\n\n**When**: SDK pull requests have been created and need to be associated with the release plan.\n\n**Steps**:\n\n1. **Identify Plan** — Get the Release Plan ID or work item ID from the user (either is accepted).\n2. **Collect PR Info** — Get the SDK pull request URL and language from the user.\n3. **Link** — Run `azure-sdk-mcp:azsdk_link_sdk_pull_request_to_release_plan` with:\n - `pullRequestUrl` (required)\n - `language` (required — e.g., \".NET\", \"Java\", \"JavaScript\", \"Python\", \"Go\")\n - `workItemId` or `releasePlanId` (either accepts the Release Plan ID or the work item ID)\n4. **Repeat** — If multiple SDK PRs exist for different languages, repeat for each.\n\n**Tool**: `azure-sdk-mcp:azsdk_link_sdk_pull_request_to_release_plan`\n\n---\n\n## Examples\n\n- \"Create a release plan for my spec PR\"\n- \"Get the release plan for work item 12345\"\n- \"What is the status of my release plan?\"\n- \"Update the API spec PR in my release plan\"\n- \"Update SDK details in release plan 67890\"\n- \"Abandon release plan 11111\"\n- \"Link my SDK PR to release plan\"\n- \"Link Python SDK PR #100 to release plan 67890\"\n\n## Troubleshooting\n\n- Requires `azure-sdk-mcp` server; no CLI fallback — prompt user to configure MCP if unavailable.\n- If creation fails, verify spec PR URL and Service Tree IDs.\n- If update fails, ensure the Release Plan ID or work item ID is correct and the plan is not already abandoned.\n- If linking fails, verify the SDK PR URL is valid and the language matches a supported value.\n",".github/skills/azsdk-common-generate-sdk-locally/SKILL.md":"---\nname: azsdk-common-generate-sdk-locally\nlicense: MIT\nmetadata:\n version: \"1.1.1\"\n distribution: shared\ndescription: 'Generate and finalize Azure SDKs locally from TypeSpec, including build, checks, tests, changelog, metadata, and version updates by default. WHEN: \"generate SDK locally\", \"build SDK\", \"run SDK tests\", \"run CI checks\", \"validate package\", \"run checks\", \"update changelog\", \"fix SDK build errors\", \"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\". 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.'\ncompatibility: \"azure-sdk-mcp server, local azure-sdk-for-{language} clone, language build tools\"\n---\n\n# Generate SDK Locally\n\nThis 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.\n\n## Triggers\n\nUSE FOR: generate, build, and test Azure SDKs locally from TypeSpec with automatic customization; update changelog; fix SDK build errors; 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\nWHEN: \"generate SDK locally\", \"build SDK\", \"run SDK tests\", \"update changelog\", \"fix SDK build errors\", \"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\"\n\n## Boundaries\n\nDo not use this skill for:\n\n- Publishing SDK packages to package registries\n- CI pipeline configuration\n- API design review\n\n## Rules\n\n- Interpret **\"generate SDK\"** and **\"generate SDK locally\"** as requests for the complete workflow: generate, build, validate, test, update changelog, update metadata, and update version. Do not treat the word \"generate\" by itself as a generate-only request.\n- Stop after generation and a successful build when the user explicitly says **\"generate only\"**, **\"only generate\"**, or otherwise explicitly asks to skip checks, tests, changelog, metadata, and version updates. Bind `only` to the generation action even when a target qualifier follows: **\"generate SDK only for Web PubSub\"** is a generate-only request scoped to Web PubSub. By contrast, **\"generate the SDK for only the Web PubSub service\"** scopes the complete workflow to one service. Once a request is classified as generate-only, do not prompt for a commit or run steps 8–11. If the user's intent is unclear, default to the complete workflow.\n- This skill generates an SDK **locally** from a local clone. Use it to generate an SDK **only when the user indicates local generation** — they say \"local\"/\"locally\", or are working from a local clone. If the user asks to \"generate SDK for **all languages**\", to generate **for a release plan / release ID** (even a single language), to generate **without a local clone**, or wants SDK **pull requests created** for them, do **not** generate locally — use the `azsdk-common-generate-sdk-pipeline` skill, which runs the SDK generation pipeline for each language and produces the SDK pull requests.\n- Never use `azure-sdk-mcp:azsdk_get_sdk_pull_request_link` or `azure-sdk-mcp:azsdk_get_pull_request` to _generate_ an SDK; those only retrieve links for SDKs that were already generated.\n- Requires the `azure-sdk-mcp` server for the MCP workflow; without MCP, use `npm exec --prefix eng/common/tsp-client -- tsp-client` CLI.\n- Verify the target language repo and the correct TypeSpec configuration file before generation.\n- After generation or customization, run the check and test steps before updating metadata or finalizing changes.\n\n## MCP Tools\n\n| Tool | Purpose |\n| ------------------------------------------------------ | ------------------------------------------------------ |\n| `azure-sdk-mcp:azsdk_verify_setup` | Verify environment |\n| `azure-sdk-mcp:azsdk_package_generate_code` | Generate SDK |\n| `azure-sdk-mcp:azsdk_package_build_code` | Build package |\n| `azure-sdk-mcp:azsdk_package_run_check` | Validate package |\n| `azure-sdk-mcp:azsdk_package_run_tests` | Run tests |\n| `azure-sdk-mcp:azsdk_customized_code_update` | Apply customizations (includes regeneration and build) |\n| `azure-sdk-mcp:azsdk_package_update_changelog_content` | Update changelog |\n| `azure-sdk-mcp:azsdk_package_update_metadata` | Update metadata including ci.yml |\n| `azure-sdk-mcp:azsdk_package_update_version` | Update version |\n\nPrerequisites: azure-sdk-mcp server must be running. Without MCP, use `npx tsp-client` CLI.\n\n## Steps\n\n1. **Select language** — Confirm target language: .NET, Java, JavaScript, Python, Go, or Rust.\n2. **Verify repo** — Ensure the user has a local clone of the correct [SDK repo](references/sdk-repos.md). If not cloned, instruct user to clone it.\n3. **Identify config file** — Determine the path to the TypeSpec configuration file. See [config file details](references/detailed-workflow.md).\n - From `azure-rest-api-specs` repo: use path to `tspconfig.yaml`.\n - From an SDK language repo: use path to `tsp-location.yaml`.\n4. **Verify setup** — Run `azure-sdk-mcp:azsdk_verify_setup` to confirm environment.\n5. **Generate** — Run `azure-sdk-mcp:azsdk_package_generate_code` with the config file path.\n6. **Build** — Run `azure-sdk-mcp:azsdk_package_build_code`. For .NET, use the `additionalArguments: \"/p:RunApiCompat=false\"` to skip API compatibility checks if user requests to skip API compatibility check.\n7. **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](references/customization-workflow.md). _(If the user requested \"generate only\", stop here — skip steps 8–11.)_\n8. **Commit checkpoint** — Prompt the user to commit generated changes before proceeding. See [commit checkpoint details](references/detailed-workflow.md).\n9. **Validate** — Run `azure-sdk-mcp:azsdk_package_run_check` and `azure-sdk-mcp:azsdk_package_run_tests`.\n10. **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.)_\n11. **Final commit** — Prompt the user to commit final changes (changelog, metadata, version). See [commit checkpoint details](references/detailed-workflow.md).\n\n[SDK repos](references/sdk-repos.md) | [Customization workflow](references/customization-workflow.md) | [Detailed workflow](references/detailed-workflow.md)\n\n## Guardrails\n\n- **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.\n- 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.\n- Only the customization tool understands the correct layering of TypeSpec decorators vs code patches and ensures regenerated code stays consistent.\n\n## Examples\n\n- \"Generate the SDK locally for my TypeSpec service\"\n- \"Build and test the Python SDK package\"\n- \"Run CI checks for my SDK package\"\n- \"Fix the SDK build errors on this PR\"\n- \"Rename FooClient to BarClient for .NET\"\n- \"Hide the internal polling operation from the Python SDK\"\n- \"Fix .NET analyzer errors AZC0030 and AZC0012\"\n- \"The build is failing because a customization references a renamed property\"\n- \"Create a subclient architecture for the Python SDK\"\n- \"Apply TypeSpec customizations to fix compilation errors\"\n- \"Update the changelog for this SDK package\"\n- \"Update the package version\"\n- \"Update the package metadata and ci.yml\"\n\n## Troubleshooting\n\n- For \"generate SDK for all languages\", pipeline-based generation, or when no local SDK clone exists, call `azure-sdk-mcp:azsdk_run_generate_sdk` instead of the local generate flow, and never substitute `azure-sdk-mcp:azsdk_get_sdk_pull_request_link` / `azure-sdk-mcp:azsdk_get_pull_request` for generation.\n- Run `azure-sdk-mcp:azsdk_verify_setup` to confirm MCP and tools.\n- If build fails with type conflicts, breaking changes, analyzer errors, or customization drift, use `azure-sdk-mcp:azsdk_customized_code_update` to apply customizations.\n- The customization tool uses a two-phase approach: TypeSpec decorators first (Phase A), then code repairs if needed (Phase B).\n- 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.\n- Without MCP, use `npx tsp-client` CLI.\n",".github/skills/azsdk-common-sdk-breaking-change/SKILL.md":"---\nname: azsdk-common-sdk-breaking-change\nlicense: MIT\nmetadata:\n version: \"1.0.0\"\n distribution: shared\ndescription: 'Detect and mitigate SDK Breaking changes for an SDK package which is generated from TypeSpec. WHEN: \"Detect SDK breaking changes for a service\", \"Detect SDK breaking changes for an SDK package\", \"Detect and mitigate SDK breaking changes for a service\", \"Detect and mitigate SDK breaking changes for an SDK package\". INVOKES: skill: azsdk-common-generate-sdk-locally; MCP tools: azure-sdk-mcp:azsdk_customized_code_update, azure-sdk-mcp:azsdk_package_detect_breaking_change.'\ncompatibility: \"azure-sdk-mcp server, local azure-sdk-for-{language} clone, language build tools\"\n---\n\n# SDK Breaking Change Detection and Mitigation\n\n## MCP Tools\n\n| Tool | Purpose |\n| ---------------------------------------------------- | --------------------------- |\n| `azure-sdk-mcp:azsdk_customized_code_update` | Apply customizations |\n| `azure-sdk-mcp:azsdk_package_detect_breaking_change` | Detect SDK breaking changes |\n\nPrerequisites: azure-sdk-mcp server must be running.\n\n## Steps\n\n1. **Select language** — First extract one or more target languages from the user's prompt. If the prompt specifies any target languages, use them without asking the user to confirm. If it does not specify a target language, prompt the user to choose one or more from this list, presented in exactly this order: Go, Java, JavaScript, Python, .NET.\n\n- For each selected language in step 1, execute steps 2 through 6 **one language at a time** — fully complete all steps for one language before starting the next. Process multiple selected languages in the same order they appear in the list above.\n\n2. Follow `azsdk-common-generate-sdk-locally` skill to generate SDK only. For .NET, require the preparatory build to disable API compatibility checks using additionalArguments: \"/p:RunApiCompat=false\". This is a requirement of this workflow: compatibility findings must reach the detection and user-selection steps rather than be automatically repaired during generation.\n3. **Detect SDK breaking Changes** - Run `azure-sdk-mcp:azsdk_package_detect_breaking_change`\n4. **Display detected breaking changes** — If step 3 fails, display the `ResponseError` message and stop processing the current language. If step 3 detects breaking changes, display a `## Detected Breaking Changes` title followed by a Markdown table. Include exactly one breaking change per row with these columns: `Breaking Change`, `Category`, and `Resolution`. Preserve the category and resolution returned by the detection tool; do not replace them with a summary. If no breaking changes are detected, report that result and stop processing the current language.\n5. **Prompt the user to choose breaking changes to mitigate** — If the user requested detection only, stop processing the current language after displaying the results. Otherwise, present the list from step 3 as a multiple-choice selection.\n6. **Mitigate selected SDK breaking changes** — If the user selects no changes in step 5, stop processing the current language. Otherwise, run `azure-sdk-mcp:azsdk_customized_code_update` for the selected changes with these parameters:\n\n- packagePath: The SDK package path\n- customizationRequest: resolve the 'breakingChanges' chosen in step 5\n- tspProjectPath: the typespec project path\n- editScope: Set this based on the repository where the skill is running. When running in the target SDK language repository, use `'CustomCode'`. When running in `azure-rest-api-specs`, use `'All'` if the target SDK language repository is also available as a local clone; otherwise, use `'SpecInputs'`.\n\nAfter step 6, begin the next iteration. If the customization modified TypeSpec, first repeat step 2 to regenerate the SDK; otherwise, resume at step 3. Then repeat steps 3 through 6. Run at most three detection-and-mitigation iterations per language, stopping earlier if no breaking changes remain or the user declines further mitigation. After the third mitigation, run step 3 once more to identify and report any remaining breaking changes, then stop without offering a fourth mitigation.\n\n## Examples\n\n- \"Detect and mitigate SDK breaking changes for the service\"\n- \"Detect SDK breaking changes for the service\"\n- \"Detect SDK breaking changes for Go SDK package\"\n- \"Detect and mitigate SDK breaking changes for Go SDK package\"\n\n## Troubleshooting\n\n- Requires the `azure-sdk-mcp` server. If it is unavailable, direct the user to the [quick-start guide](https://github.com/Azure/azure-sdk-tools/blob/main/tools/azsdk-cli/Azure.Sdk.Tools.Cli/README.md#quick-start) to configure it before continuing.\n- Requires a local clone of the target SDK repository. If unavailable, prompt the user to clone it before continuing.\n",".github/skills/code-review/SKILL.md":"---\nname: code-review\ndescription: \"Review pull requests and code changes in the Azure SDK for Python repository. USE FOR: GitHub Copilot code review; CCR; review pull request; review PR; review diff; find bugs or regressions introduced by a PR; cross-package SDK review. Finds high-confidence correctness, security, API compatibility, dependency, documentation, and test issues. DO NOT USE FOR: implementing fixes; running tests; fixing CI; releases; APIView feedback.\"\n---\n\n# Azure SDK for Python Code Review\n\nUse this skill for GitHub Copilot code review (CCR) and other broad pull request reviews. If the task already assigns a narrower specialist role, that scope remains authoritative; use this skill's evidence and quality gates without expanding the specialist review.\n\n## Review Process\n\n1. Read the pull request description and identify the intended behavior.\n2. Categorize the changed files and apply only the relevant guidance below.\n3. Review correctness and behavioral regressions first, then apply the relevant SDK-specific checks.\n4. Trace changes through callers, exports, tests, API reports, documentation, and package metadata when those relationships affect correctness.\n5. Inspect enough unchanged context to verify existing guards, invariants, and behavior before reporting a finding.\n\nFor changes outside `sdk/`, review correctness, security, and test coverage\nwithout imposing SDK-specific conventions.\n\n## Load Guidance Progressively\n\n| Changed surface or risk | Guidance |\n| --- | --- |\n| SDK source or public API | `.github/instructions/reviewer/sdk-source.instructions.md` and the [Azure SDK Python Design Guidelines](https://azure.github.io/azure-sdk/python_design.html) |\n| Tests or coverage implications | `.github/instructions/reviewer/testing.instructions.md` |\n| README, CHANGELOG, docstrings, or samples | `.github/instructions/reviewer/documentation.instructions.md` |\n| Packaging or dependencies | `.github/instructions/reviewer/dependencies.instructions.md` |\n| `sdk/*/azure-mgmt-*/` | `.github/instructions/reviewer/management.instructions.md` |\n\nManagement-specific review scope and rules take precedence over generic SDK\nguidance: skip `generated_samples/` and `generated_tests/`, and review only\n`_client.py` under `azure/mgmt/**/`. Read metadata and documentation needed to\ncheck the management rules. Do not apply the JavaScript repo's TypeScript,\npnpm, or API-report conventions to Python packages.\n\nGenerated output is usually not the fix location: identify the actionable\nTypeSpec, customization, or generator cause when evidence supports it. Do not\nspeculate about the upstream fix or mistake a preview-only API change for a\nbreaking change in a released stable API.\n\n## Findings\n\n- Report actionable, high-confidence issues with changed file/line, the\n observed behavior, the scenario in which it fails, and a concrete remedy.\n- Prioritize correctness, compatibility, and security over stylistic\n preferences. Do not claim a tool or test failure without running it.\n- Do not duplicate the same root cause across multiple files. If evidence is\n incomplete, state what could not be verified instead of guessing.\n- If there are no findings, say so briefly; do not pad the review with passing\n checks or generic suggestions.\n",".github/skills/create-api-review/SKILL.md":"---\nname: create-api-review\nlicense: MIT\nmetadata:\n version: \"1.0.0\"\n distribution: shared\ndescription: 'Create an API review PR for an Azure SDK package using API Review Hub. **UTILITY SKILL**. USE FOR: \"create API review\", \"open API review\", \"compare package versions\", \"APIView PR\". DO NOT USE FOR: fixing APIView comments, SDK code generation, pipeline debugging. INVOKES: azure-sdk-mcp:azsdk_apireviewhub_request_review_pr.'\ncompatibility: \"azure-sdk-mcp server v0.6.32 or later\"\n---\n\n# Create API Review\n\nThis skill creates an API review pull request through API Review Hub for a package API surface comparison.\n\n## Triggers\n\nUSE FOR: create API review, open API review, compare package versions, APIView PR\nWHEN: \"create API review\", \"open API review\", \"compare package versions\", \"APIView PR\"\nDO NOT USE FOR: fixing APIView comments, SDK code generation, pipeline debugging\n\n## Rules\n\n- Requires `azure-sdk-mcp` version `0.6.32` or later.\n- Use `azure-sdk-mcp:azsdk_apireviewhub_request_review_pr` to create the review PR.\n- CLI equivalent is `azsdk api-review create`.\n- Language is fixed to `python` for this repository.\n- Required user inputs: `packageName`, `targetBranch`.\n- `baseTag` defines the baseline version. Use package tag format: `_`.\n- If `baseTag` is omitted, ask the user to choose one of:\n - Use the latest GA (non-beta) release tag for `packageName`.\n - Provide a specific tag or version to use as baseline.\n- Direct MCP calls require `targetRepo: azure-sdk-for-python`; `targetOwner` defaults to `Azure` unless explicitly provided (for example, a fork), so pass both explicitly when overriding defaults.\n- The CLI may supply repository defaults, but the MCP method does not.\n- `targetOwner`, `targetRepo`, and `targetBranch` define where the review PR branch is created.\n- Wait behavior mapping: `--no-wait` corresponds to `waitForCompletion: false`.\n- Poll behavior mapping: `--poll-interval-seconds` corresponds to `pollIntervalSeconds` (default `30`).\n- Optionally provide a ready-to-run `azsdk api-review create` command for the user with resolved values.\n\n## MCP Tools\n\n| Tool | Purpose |\n| ----------------------------------------------------- | ------------------------------- |\n| `azure-sdk-mcp:azsdk_apireviewhub_request_review_pr` | Create API review PR request |\n| `azure-sdk-mcp:azsdk_upgrade` | Check/upgrade MCP server version |\n\n## Steps\n\n1. **Collect Inputs** - Get required `packageName` and `targetBranch`. Optionally collect `baseTag`.\n2. **Prompt For Baseline** - If `baseTag` is not provided, ask the user to choose latest GA (non-beta) or provide a specific tag/version.\n3. **Resolve Baseline** - If the user chooses latest GA, resolve and use the latest GA (non-beta) release tag for `packageName`. If the user provides a tag/version, use that value.\n4. **Validate MCP Version** - Ensure `azure-sdk-mcp` is `0.6.32+`.\n5. **Set Wait Mode** - Default to wait for completion. Use `waitForCompletion: false` only when user asks for no-wait behavior.\n6. **Set Poll Interval** - If waiting for completion, use `pollIntervalSeconds` (default `30`, override only if requested).\n7. **Request Review PR** - Run `azure-sdk-mcp:azsdk_apireviewhub_request_review_pr` with `language: python`, `targetRepo: azure-sdk-for-python`, and `targetOwner` (default `Azure` unless explicitly provided), plus collected inputs.\n8. **Return Result** - Provide review PR URL and operation status.\n9. **Optional CLI Output** - If useful or requested, provide the equivalent `azsdk api-review create` command with all resolved arguments.\n\n## CLI Command Template\n\n```powershell\nazsdk api-review create `\n --language python `\n --package-name `\n --base-tag `\n --target-branch `\n --target-owner `\n --target-repo \n```\n\nOptional flags:\n\n- `--no-wait`\n- `--poll-interval-seconds 30`\n- `--output plain|json`\n\n## Example\n\nFor `azure-storage-blob` comparing `1.0.0` to the latest on main:\n\n- `packageName`: `azure-storage-blob`\n- `baseTag`: `azure-storage-blob_1.0.0`\n- `targetOwner`: `Azure`\n- `targetRepo`: `azure-sdk-for-python`\n- `targetBranch`: `main`\n\n## Troubleshooting\n\n- If tool is missing or unsupported, run `azure-sdk-mcp:azsdk_upgrade` with `checkOnly: true` to verify current version.\n- If `baseTag` is invalid, confirm the exact release tag name in the repository.\n- If `baseTag` is omitted, confirm the user's baseline choice before requesting the review PR.\n- If the generated review does not reflect expected changes, confirm `targetBranch` contains the intended newer API surface.\n",".github/skills/create-package-skill/SKILL.md":"---\nname: create-package-skill\ndescription: '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.'\n---\n\n# Create Package Skill Wizard\n\n> **Minimal beats comprehensive. Human-written beats auto-generated. Scaffold and iterate.**\n\n> Skills encode tribal knowledge — the \"I wish someone had told me\" stuff that's hard to learn from just reading code. Focus on what's non-obvious and package-specific.\n\n## Interaction Protocols\n\n**CONFIRM Protocol** (asset-producing steps — creating files):\n1. PRESENT the proposed assets and explain why.\n2. ASK exactly one question: \"Create now (recommended), edit first, or skip?\"\n3. ACT immediately. Create → write files this turn. Edit → refine, re-ask. Skip → move on.\n\n**DECIDE Protocol** (informational/correction steps — no files created):\n1. PRESENT the information or findings.\n2. ASK one specific question appropriate to the decision.\n3. PROCEED based on the answer.\n\nOne question at a time. Respect \"skip\" — never re-ask or defer.\n\n## Wizard Flow\n\nRun each phase in order. **Progressive loading:** Read only the current phase file.\n\n| Phase | Description | Instructions |\n|---|---|---|\n| **Phase 0** | 🧭 Scan Package — detect architecture, customizations, key files | [phases/00-scan-package.md](phases/00-scan-package.md) |\n| **Phase 1** | 📝 Scaffold SKILL.md — generate skill with step-by-step post-regen workflow (Option A) or reference-manual structure (Option B) | [phases/01-scaffold-skill.md](phases/01-scaffold-skill.md) |\n| **Phase 2** | 📚 Generate References — create customizations.md (required) and optionally architecture.md | [phases/02-generate-references.md](phases/02-generate-references.md) |\n| **Phase 3** | Validate -- run vally lint | [phases/03-validate.md](phases/03-validate.md) |\n| **Phase 4** | 📋 Finalize — confirm discoverable location, summarize | [phases/04-finalize.md](phases/04-finalize.md) |\n\n## Guardrails\n\n**Content:**\n- Every line must be non-obvious and package-specific. No generic Python/SDK boilerplate.\n- SKILL.md should be under 500 tokens (soft limit). Move details to references/.\n- References under 1000 tokens each. Split if larger.\n- Never duplicate repository-wide guidance from `AGENTS.md` or shared skills.\n\n**Relationship to existing SDK tools:**\n- Package skills **complement** the Azure SDK MCP tools (`azsdk_package_generate_code`, `azsdk_package_build_code`, `azsdk_customized_code_update`, etc.) — they do NOT replace them.\n- MCP tools handle deterministic operations (generate, build, test). Package skills provide the reasoning context an agent needs to use those tools correctly for a specific package, plus the package-specific verification commands the tools do not know about.\n- Reference the existing tools for the overall workflow (e.g., \"Run `tsp-client update` or `azsdk_package_generate_code`\"), but DO include the copy-pasteable verification commands an agent needs: import smoke tests (`python -c \"from ... import ...\"`), `ApiVersion` reconciliation (`grep`, `python -c \"import json; ...\"`), diff commands (`git diff --name-only | grep ...`), and the package validation invocation (`azsdk_package_run_check with checkType=\"All\"`).\n- Never paraphrase an MCP tool's entire contract. Do include the one-line invocations the agent will run.\n\n**Structure:**\n- Skill directory: `sdk///.github/skills//`\n- Directory name MUST match `name` field in frontmatter (vally lint enforces this).\n- `name` is the distribution package name, e.g. `azure-search-documents`, `azure-ai-projects`, `azure-mgmt-appconfiguration`.\n- Use semicolons to separate trigger phrases in description (YAML-safe).\n\n**Security:**\n- Never embed secrets or credentials in skill content.\n- Never instruct agents to bypass CI, pylint, mypy, pyright, or other gating tools.\n- Never instruct agents to edit files inside `_generated/` (or any file with the `\"Code generated by Microsoft (R) Python Code Generator\"` header) — always route through `_patch.py` or sibling hand-written modules.\n\n## Key Principles (from eval data)\n\nOur eval showed that skill **structure** matters more than **volume**:\n\n| Pattern | Impact |\n|---|---|\n| Numbered step-by-step post-regen workflow (Option A) | Agent executes verification top-to-bottom without inventing steps |\n| Copy-pasteable verification commands (import smoke tests, `ApiVersion` reconciliation, git diff of generated operations/models) | Agent actually runs the checks instead of guessing whether customizations still work |\n| \"Expose new generated methods through `_patch.py`\" step (mixin inheritance / override / polymorphic / create-or-update / list / `__all__` re-export) | Agent wires new generated operations into the public surface instead of leaving them unreachable |\n| \"Check `_patch.py` FIRST\" directives | Changes agent default from \"fix the error location\" to \"check the customization layer\" |\n| Per-file `Depends On` / `Defines` / `After Regeneration, Verify` inventory in `customizations.md` | Agent can pinpoint exactly which generated symbol a breakage maps to |\n| Generated-file detection guidance (directory OR header comment) | Agent correctly identifies auto-generated files under both `_generated/` and inline layouts |\n| Async parity checklist | Agent remembers to mirror sync changes into `aio/` |\n| CHANGELOG / README update step | Prevents \"silent\" releases that ship new operations without docs |\n\n## References (load on demand)\n\n- [references/skill-template.md](references/skill-template.md) -- SKILL.md template with required sections\n- [references/validation-tools.md](references/validation-tools.md) -- vally lint, CI workflow setup\n",".github/skills/azsdk-common-sdk-release/SKILL.md":"---\nname: azsdk-common-sdk-release\nlicense: MIT\nmetadata:\n version: \"1.0.0\"\n distribution: shared\ndescription: 'Check release readiness and trigger the release pipeline for Azure SDK packages. **UTILITY SKILL**. USE FOR: \"release SDK\", \"trigger release\", \"check release readiness\", \"release pipeline\", \"publish package\", \"ship SDK\". DO NOT USE FOR: SDK development, code generation, pipeline debugging, release plan creation. INVOKES: azure-sdk-mcp:azsdk_release_sdk.'\ncompatibility: \"azure-sdk-mcp server, SDK package merged on release branch. Supports .NET, Java, JavaScript, Python, Go\"\n---\n\n# SDK Release\n\nThis skill checks release readiness and triggers the Azure SDK release pipeline for packages that are already prepared, guiding the user through prerequisite validation, readiness review, and the final pipeline launch with required approval steps.\n\n## Triggers\n\nUSE FOR: release SDK, trigger release, check release readiness, release pipeline, publish package, ship SDK\nWHEN: \"release SDK\", \"trigger release\", \"check release readiness\", \"release pipeline\", \"publish package\", \"ship SDK\"\nDO NOT USE FOR: SDK development, code generation, pipeline debugging, release plan creation\n\n## Rules\n\n- Requires the `azure-sdk-mcp` server; there is no CLI fallback for the release workflow.\n- Collect `packageName` and `language`, then run the readiness check before attempting to trigger release.\n- If release is triggered, show the pipeline link and remind the user that the release stage still requires approval.\n\n## MCP Tools\n\n| Tool | Purpose |\n| --------------------------------- | ----------------------------------------------------------- |\n| `azure-sdk-mcp:azsdk_release_sdk` | Check release readiness and/or trigger the release pipeline |\n\n## Steps\n\n1. **Collect Info** — Get `packageName` and `language` from the user. Optionally get `branch` (defaults to main).\n2. **Determine Intent** — If the user explicitly asks to \"check readiness\" or \"check if ready\", run `azure-sdk-mcp:azsdk_release_sdk` with `checkReady: true`. Otherwise, proceed to trigger the release directly.\n3. **Trigger Release** — Run `azure-sdk-mcp:azsdk_release_sdk` with `checkReady: false` (the default). Show pipeline link and inform user they must approve the release stage.\n4. **Review Results** — If the release fails due to readiness issues, display failing checks and guide user to resolve.\n\n## Examples\n\n- \"Check if azure-storage-blob is ready for release\"\n- \"Trigger release for @azure/core-rest-pipeline on JavaScript\"\n\n## Troubleshooting\n\n- If readiness check fails, review each failing prerequisite individually before re-triggering.\n- Requires `azure-sdk-mcp` server. No CLI fallback — prompt user to configure MCP if unavailable.\n",".github/skills/find-package-skill/SKILL.md":"---\nname: find-package-skill\ndescription: '**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\".'\n---\n\n# Find Package Skill\n\nSome SDK packages in this monorepo have **package-specific skills** — tribal\nknowledge (architecture, data flows, type mappings, pitfalls) that prevents\ncommon mistakes. Before modifying any SDK package, check whether a skill exists\nfor it using the steps below.\n\n## How to Discover Package Skills\n\n1. **Determine the package directory.** If you already know the file path you're\n modifying, extract the package directory from it (e.g., a file at\n `sdk/search/azure-search-documents/azure/search/documents/_search_client.py`\n belongs to the package at `sdk/search/azure-search-documents/`). If you only\n have a package name, search for a matching directory under `sdk/` (package\n directories are named after the distribution package name, e.g.,\n `azure-search-documents` → `sdk/search/azure-search-documents/`).\n\n2. **Check for a `.github/skills/` directory** inside the package directory. For\n example, check whether `sdk/search/azure-search-documents/.github/skills/` exists.\n\n3. **If it exists**, read every `SKILL.md` found under that directory. If a\n `references/` subdirectory exists next to a `SKILL.md`, read all files in it\n too for additional context.\n\n4. **If no `.github/skills/` directory exists** for the package, no\n package-specific skill has been created yet — proceed normally.",".github/skills/fix-black/SKILL.md":"# fix-black\n\nPath: `.github/skills/fix-black/SKILL.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/.github/skills/fix-black/SKILL.md)",".github/skills/fix-mypy/SKILL.md":"# fix-mypy\n\nPath: `.github/skills/fix-mypy/SKILL.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/.github/skills/fix-mypy/SKILL.md)",".github/skills/fix-pylint/SKILL.md":"# fix-pylint\n\nPath: `.github/skills/fix-pylint/SKILL.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/.github/skills/fix-pylint/SKILL.md)",".github/skills/fix-sphinx/SKILL.md":"# fix-sphinx\n\nPath: `.github/skills/fix-sphinx/SKILL.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/.github/skills/fix-sphinx/SKILL.md)",".github/skills/generate-api-markdown/SKILL.md":"# generate-api-markdown\n\nPath: `.github/skills/generate-api-markdown/SKILL.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/.github/skills/generate-api-markdown/SKILL.md)",".github/skills/sdk-health/SKILL.md":"# sdk-health\n\nPath: `.github/skills/sdk-health/SKILL.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/.github/skills/sdk-health/SKILL.md)",".github/skills/create-package-skill/phases/01-scaffold-skill.md":"# Phases Skill\n\nPath: `.github/skills/create-package-skill/phases/01-scaffold-skill.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/.github/skills/create-package-skill/phases/01-scaffold-skill.md)",".github/skills/eng/next-version-update/SKILL.md":"# next-version-update\n\nPath: `.github/skills/eng/next-version-update/SKILL.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/.github/skills/eng/next-version-update/SKILL.md)",".github/skills/ml/do-code-review/SKILL.md":"# do-code-review\n\nPath: `.github/skills/ml/do-code-review/SKILL.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/.github/skills/ml/do-code-review/SKILL.md)",".github/skills/ml/fix-mypy/SKILL.md":"# fix-mypy\n\nPath: `.github/skills/ml/fix-mypy/SKILL.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/.github/skills/ml/fix-mypy/SKILL.md)",".github/skills/ml/fix-pylint/SKILL.md":"# fix-pylint\n\nPath: `.github/skills/ml/fix-pylint/SKILL.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/.github/skills/ml/fix-pylint/SKILL.md)","sdk/ai/azure-ai-projects/.github/skills/azure-ai-projects-author-samples/SKILL.md":"# azure-ai-projects-author-samples\n\nPath: `sdk/ai/azure-ai-projects/.github/skills/azure-ai-projects-author-samples/SKILL.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/sdk/ai/azure-ai-projects/.github/skills/azure-ai-projects-author-samples/SKILL.md)","sdk/ai/azure-ai-projects/.github/skills/azure-ai-projects-author-tests/SKILL.md":"# azure-ai-projects-author-tests\n\nPath: `sdk/ai/azure-ai-projects/.github/skills/azure-ai-projects-author-tests/SKILL.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/sdk/ai/azure-ai-projects/.github/skills/azure-ai-projects-author-tests/SKILL.md)","sdk/ai/azure-ai-projects/.github/skills/azure-ai-projects-emit-from-typespec/SKILL.md":"# azure-ai-projects-emit-from-typespec\n\nPath: `sdk/ai/azure-ai-projects/.github/skills/azure-ai-projects-emit-from-typespec/SKILL.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/sdk/ai/azure-ai-projects/.github/skills/azure-ai-projects-emit-from-typespec/SKILL.md)","sdk/ai/azure-ai-projects/.github/skills/azure-ai-projects-model-reference-graph/SKILL.md":"# azure-ai-projects-model-reference-graph\n\nPath: `sdk/ai/azure-ai-projects/.github/skills/azure-ai-projects-model-reference-graph/SKILL.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/sdk/ai/azure-ai-projects/.github/skills/azure-ai-projects-model-reference-graph/SKILL.md)","sdk/ai/azure-ai-projects/.github/skills/azure-ai-projects-run-issue-regeneration/SKILL.md":"# azure-ai-projects-run-issue-regeneration\n\nPath: `sdk/ai/azure-ai-projects/.github/skills/azure-ai-projects-run-issue-regeneration/SKILL.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/sdk/ai/azure-ai-projects/.github/skills/azure-ai-projects-run-issue-regeneration/SKILL.md)","sdk/ai/azure-ai-projects/.github/skills/azure-ai-projects-update-changelog/SKILL.md":"# azure-ai-projects-update-changelog\n\nPath: `sdk/ai/azure-ai-projects/.github/skills/azure-ai-projects-update-changelog/SKILL.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/sdk/ai/azure-ai-projects/.github/skills/azure-ai-projects-update-changelog/SKILL.md)","sdk/contentunderstanding/azure-ai-contentunderstanding/.github/skills/cu-sdk-author-analyzer-classify-route/SKILL.md":"# cu-sdk-author-analyzer-classify-route\n\nPath: `sdk/contentunderstanding/azure-ai-contentunderstanding/.github/skills/cu-sdk-author-analyzer-classify-route/SKILL.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/sdk/contentunderstanding/azure-ai-contentunderstanding/.github/skills/cu-sdk-author-analyzer-classify-route/SKILL.md)","sdk/contentunderstanding/azure-ai-contentunderstanding/.github/skills/cu-sdk-author-analyzer/SKILL.md":"# cu-sdk-author-analyzer\n\nPath: `sdk/contentunderstanding/azure-ai-contentunderstanding/.github/skills/cu-sdk-author-analyzer/SKILL.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/sdk/contentunderstanding/azure-ai-contentunderstanding/.github/skills/cu-sdk-author-analyzer/SKILL.md)","sdk/contentunderstanding/azure-ai-contentunderstanding/.github/skills/cu-sdk-common-knowledge/SKILL.md":"# cu-sdk-common-knowledge\n\nPath: `sdk/contentunderstanding/azure-ai-contentunderstanding/.github/skills/cu-sdk-common-knowledge/SKILL.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/sdk/contentunderstanding/azure-ai-contentunderstanding/.github/skills/cu-sdk-common-knowledge/SKILL.md)","sdk/contentunderstanding/azure-ai-contentunderstanding/.github/skills/cu-sdk-sample-run/SKILL.md":"# cu-sdk-sample-run\n\nPath: `sdk/contentunderstanding/azure-ai-contentunderstanding/.github/skills/cu-sdk-sample-run/SKILL.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/sdk/contentunderstanding/azure-ai-contentunderstanding/.github/skills/cu-sdk-sample-run/SKILL.md)","sdk/contentunderstanding/azure-ai-contentunderstanding/.github/skills/cu-sdk-setup/SKILL.md":"# cu-sdk-setup\n\nPath: `sdk/contentunderstanding/azure-ai-contentunderstanding/.github/skills/cu-sdk-setup/SKILL.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/sdk/contentunderstanding/azure-ai-contentunderstanding/.github/skills/cu-sdk-setup/SKILL.md)","sdk/ai/azure-ai-projects/samples/skills/assets/canvas-design/SKILL.md":"# canvas-design\n\nPath: `sdk/ai/azure-ai-projects/samples/skills/assets/canvas-design/SKILL.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/sdk/ai/azure-ai-projects/samples/skills/assets/canvas-design/SKILL.md)","sdk/ai/azure-ai-projects/samples/skills/assets/team-status-update/SKILL.md":"# team-status-update\n\nPath: `sdk/ai/azure-ai-projects/samples/skills/assets/team-status-update/SKILL.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/sdk/ai/azure-ai-projects/samples/skills/assets/team-status-update/SKILL.md)","AGENTS.md":"# AI Agent Protocol & Instructions\n\nPath: `AGENTS.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/AGENTS.md)",".github/copilot-instructions.md":"# GitHub Copilot Instructions\n\nPath: `.github/copilot-instructions.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/.github/copilot-instructions.md)",".vscode/mcp.json":"# Model Context Protocol (MCP) Configuration\n\nPath: `.vscode/mcp.json`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/.vscode/mcp.json)",".github/agents/agentic-workflows.md":"# Subagent: agentic-workflows\n\nPath: `.github/agents/agentic-workflows.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/.github/agents/agentic-workflows.md)","scripts/old_packages/README.md":"# old_packages Documentation\n\nPath: `scripts/old_packages/README.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/scripts/old_packages/README.md)","eng/tools/azure-sdk-tools/README.md":"# azure-sdk-tools Documentation\n\nPath: `eng/tools/azure-sdk-tools/README.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/eng/tools/azure-sdk-tools/README.md)","eng/tools/azure-sdk-tools/changelog_generics.md":"# Azure-sdk-tools Skill\n\nPath: `eng/tools/azure-sdk-tools/changelog_generics.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/eng/tools/azure-sdk-tools/changelog_generics.md)","sdk/kubernetesconfiguration/azure-mgmt-kubernetesconfiguration-extensions/README.md":"# azure-mgmt-kubernetesconfiguration-extensions Documentation\n\nPath: `sdk/kubernetesconfiguration/azure-mgmt-kubernetesconfiguration-extensions/README.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/sdk/kubernetesconfiguration/azure-mgmt-kubernetesconfiguration-extensions/README.md)",".github/skills/azsdk-common-apiview-feedback-resolution/evals/eval.yaml":"# Evals Skill\n\nPath: `.github/skills/azsdk-common-apiview-feedback-resolution/evals/eval.yaml`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/.github/skills/azsdk-common-apiview-feedback-resolution/evals/eval.yaml)",".github/skills/azsdk-common-apiview-feedback-resolution/evals/trigger.eval.yaml":"# Evals Skill\n\nPath: `.github/skills/azsdk-common-apiview-feedback-resolution/evals/trigger.eval.yaml`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/.github/skills/azsdk-common-apiview-feedback-resolution/evals/trigger.eval.yaml)",".github/skills/azsdk-common-apiview-feedback-resolution/fixtures/apiview-comment.json":"# Fixtures Skill\n\nPath: `.github/skills/azsdk-common-apiview-feedback-resolution/fixtures/apiview-comment.json`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/.github/skills/azsdk-common-apiview-feedback-resolution/fixtures/apiview-comment.json)",".github/skills/azsdk-common-apiview-feedback-resolution/references/feedback-resolution-steps.md":"# References Skill\n\nPath: `.github/skills/azsdk-common-apiview-feedback-resolution/references/feedback-resolution-steps.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/.github/skills/azsdk-common-apiview-feedback-resolution/references/feedback-resolution-steps.md)",".github/skills/azsdk-common-generate-sdk-locally/evals/eval.yaml":"# Evals Skill\n\nPath: `.github/skills/azsdk-common-generate-sdk-locally/evals/eval.yaml`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/.github/skills/azsdk-common-generate-sdk-locally/evals/eval.yaml)",".github/skills/azsdk-common-generate-sdk-locally/evals/trigger.eval.yaml":"# Evals Skill\n\nPath: `.github/skills/azsdk-common-generate-sdk-locally/evals/trigger.eval.yaml`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/.github/skills/azsdk-common-generate-sdk-locally/evals/trigger.eval.yaml)",".github/skills/azsdk-common-generate-sdk-locally/fixtures/tspconfig.yaml":"# Fixtures Skill\n\nPath: `.github/skills/azsdk-common-generate-sdk-locally/fixtures/tspconfig.yaml`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/.github/skills/azsdk-common-generate-sdk-locally/fixtures/tspconfig.yaml)",".github/skills/azsdk-common-generate-sdk-locally/references/customization-workflow.md":"# References Skill\n\nPath: `.github/skills/azsdk-common-generate-sdk-locally/references/customization-workflow.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/.github/skills/azsdk-common-generate-sdk-locally/references/customization-workflow.md)",".github/skills/azsdk-common-generate-sdk-locally/references/detailed-workflow.md":"# References Skill\n\nPath: `.github/skills/azsdk-common-generate-sdk-locally/references/detailed-workflow.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/.github/skills/azsdk-common-generate-sdk-locally/references/detailed-workflow.md)",".github/skills/azsdk-common-generate-sdk-locally/references/sdk-repos.md":"# References Skill\n\nPath: `.github/skills/azsdk-common-generate-sdk-locally/references/sdk-repos.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/.github/skills/azsdk-common-generate-sdk-locally/references/sdk-repos.md)",".github/skills/azsdk-common-pipeline-analysis/evals/trigger.eval.yaml":"# Evals Skill\n\nPath: `.github/skills/azsdk-common-pipeline-analysis/evals/trigger.eval.yaml`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/.github/skills/azsdk-common-pipeline-analysis/evals/trigger.eval.yaml)",".github/skills/azsdk-common-pipeline-analysis/references/failure-patterns.md":"# References Skill\n\nPath: `.github/skills/azsdk-common-pipeline-analysis/references/failure-patterns.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/.github/skills/azsdk-common-pipeline-analysis/references/failure-patterns.md)",".github/skills/azsdk-common-pipeline-analysis/references/output-format.md":"# References Skill\n\nPath: `.github/skills/azsdk-common-pipeline-analysis/references/output-format.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/.github/skills/azsdk-common-pipeline-analysis/references/output-format.md)",".github/skills/azsdk-common-pipeline-fixer/evals/trigger.eval.yaml":"# Evals Skill\n\nPath: `.github/skills/azsdk-common-pipeline-fixer/evals/trigger.eval.yaml`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/.github/skills/azsdk-common-pipeline-fixer/evals/trigger.eval.yaml)",".github/skills/azsdk-common-prepare-release-plan/evals/eval.yaml":"# Evals Skill\n\nPath: `.github/skills/azsdk-common-prepare-release-plan/evals/eval.yaml`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/.github/skills/azsdk-common-prepare-release-plan/evals/eval.yaml)",".github/skills/azsdk-common-prepare-release-plan/evals/schedule-risk.eval.yaml":"# Evals Skill\n\nPath: `.github/skills/azsdk-common-prepare-release-plan/evals/schedule-risk.eval.yaml`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/.github/skills/azsdk-common-prepare-release-plan/evals/schedule-risk.eval.yaml)",".github/skills/azsdk-common-prepare-release-plan/evals/trigger.eval.yaml":"# Evals Skill\n\nPath: `.github/skills/azsdk-common-prepare-release-plan/evals/trigger.eval.yaml`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/.github/skills/azsdk-common-prepare-release-plan/evals/trigger.eval.yaml)",".github/skills/azsdk-common-prepare-release-plan/fixtures/tspconfig.yaml":"# Fixtures Skill\n\nPath: `.github/skills/azsdk-common-prepare-release-plan/fixtures/tspconfig.yaml`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/.github/skills/azsdk-common-prepare-release-plan/fixtures/tspconfig.yaml)",".github/skills/azsdk-common-prepare-release-plan/references/release-plan-details.md":"# References Skill\n\nPath: `.github/skills/azsdk-common-prepare-release-plan/references/release-plan-details.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/.github/skills/azsdk-common-prepare-release-plan/references/release-plan-details.md)",".github/skills/azsdk-common-sdk-breaking-change/evals/eval.yaml":"# Evals Skill\n\nPath: `.github/skills/azsdk-common-sdk-breaking-change/evals/eval.yaml`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/.github/skills/azsdk-common-sdk-breaking-change/evals/eval.yaml)",".github/skills/azsdk-common-sdk-breaking-change/evals/trigger.eval.yaml":"# Evals Skill\n\nPath: `.github/skills/azsdk-common-sdk-breaking-change/evals/trigger.eval.yaml`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/.github/skills/azsdk-common-sdk-breaking-change/evals/trigger.eval.yaml)",".github/skills/azsdk-common-sdk-release/evals/eval.yaml":"# Evals Skill\n\nPath: `.github/skills/azsdk-common-sdk-release/evals/eval.yaml`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/.github/skills/azsdk-common-sdk-release/evals/eval.yaml)",".github/skills/azsdk-common-sdk-release/evals/trigger.eval.yaml":"# Evals Skill\n\nPath: `.github/skills/azsdk-common-sdk-release/evals/trigger.eval.yaml`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/.github/skills/azsdk-common-sdk-release/evals/trigger.eval.yaml)",".github/skills/code-review/evals/trigger.eval.yaml":"# Evals Skill\n\nPath: `.github/skills/code-review/evals/trigger.eval.yaml`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/.github/skills/code-review/evals/trigger.eval.yaml)",".github/skills/create-package-skill/phases/00-scan-package.md":"# Phases Skill\n\nPath: `.github/skills/create-package-skill/phases/00-scan-package.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/.github/skills/create-package-skill/phases/00-scan-package.md)",".github/skills/create-package-skill/phases/02-generate-references.md":"# Phases Skill\n\nPath: `.github/skills/create-package-skill/phases/02-generate-references.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/.github/skills/create-package-skill/phases/02-generate-references.md)",".github/skills/create-package-skill/phases/03-validate.md":"# Phases Skill\n\nPath: `.github/skills/create-package-skill/phases/03-validate.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/.github/skills/create-package-skill/phases/03-validate.md)",".github/skills/create-package-skill/phases/04-finalize.md":"# Phases Skill\n\nPath: `.github/skills/create-package-skill/phases/04-finalize.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/.github/skills/create-package-skill/phases/04-finalize.md)",".github/skills/create-package-skill/references/skill-template.md":"# References Skill\n\nPath: `.github/skills/create-package-skill/references/skill-template.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/.github/skills/create-package-skill/references/skill-template.md)",".github/skills/create-package-skill/references/validation-tools.md":"# References Skill\n\nPath: `.github/skills/create-package-skill/references/validation-tools.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/.github/skills/create-package-skill/references/validation-tools.md)",".github/skills/sdk-health/evals/trigger.eval.yaml":"# Evals Skill\n\nPath: `.github/skills/sdk-health/evals/trigger.eval.yaml`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/.github/skills/sdk-health/evals/trigger.eval.yaml)","eng/tools/azure-sdk-tools/devtools_testutils/README.md":"# devtools_testutils Documentation\n\nPath: `eng/tools/azure-sdk-tools/devtools_testutils/README.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/eng/tools/azure-sdk-tools/devtools_testutils/README.md)","eng/tools/azure-sdk-tools/tests/data/azure-mgmt-containerservice-41.4.0b1-CHANGELOG.md":"# Data Skill\n\nPath: `eng/tools/azure-sdk-tools/tests/data/azure-mgmt-containerservice-41.4.0b1-CHANGELOG.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/eng/tools/azure-sdk-tools/tests/data/azure-mgmt-containerservice-41.4.0b1-CHANGELOG.md)","eng/tools/azure-sdk-tools/tests/data/azure-mgmt-containerservice-41.4.0b1-CHANGELOG.trimmed.md":"# Data Skill\n\nPath: `eng/tools/azure-sdk-tools/tests/data/azure-mgmt-containerservice-41.4.0b1-CHANGELOG.trimmed.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/eng/tools/azure-sdk-tools/tests/data/azure-mgmt-containerservice-41.4.0b1-CHANGELOG.trimmed.md)","eng/tools/azure-sdk-tools/tests/data/azure-mgmt-cosmosdb-10.0.0b6-CHANGELOG.md":"# Data Skill\n\nPath: `eng/tools/azure-sdk-tools/tests/data/azure-mgmt-cosmosdb-10.0.0b6-CHANGELOG.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/eng/tools/azure-sdk-tools/tests/data/azure-mgmt-cosmosdb-10.0.0b6-CHANGELOG.md)","eng/tools/azure-sdk-tools/tests/data/azure-mgmt-cosmosdb-10.0.0b6-CHANGELOG.trimmed.md":"# Data Skill\n\nPath: `eng/tools/azure-sdk-tools/tests/data/azure-mgmt-cosmosdb-10.0.0b6-CHANGELOG.trimmed.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/eng/tools/azure-sdk-tools/tests/data/azure-mgmt-cosmosdb-10.0.0b6-CHANGELOG.trimmed.md)","eng/tools/azure-sdk-tools/tests/data/azure-mgmt-datafactory-10.0.0b1-CHANGELOG.md":"# Data Skill\n\nPath: `eng/tools/azure-sdk-tools/tests/data/azure-mgmt-datafactory-10.0.0b1-CHANGELOG.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/eng/tools/azure-sdk-tools/tests/data/azure-mgmt-datafactory-10.0.0b1-CHANGELOG.md)","eng/tools/azure-sdk-tools/tests/data/azure-mgmt-datafactory-10.0.0b1-CHANGELOG.trimmed.md":"# Data Skill\n\nPath: `eng/tools/azure-sdk-tools/tests/data/azure-mgmt-datafactory-10.0.0b1-CHANGELOG.trimmed.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/eng/tools/azure-sdk-tools/tests/data/azure-mgmt-datafactory-10.0.0b1-CHANGELOG.trimmed.md)","eng/tools/azure-sdk-tools/tests/data/azure-mgmt-network-31.0.0-CHANGELOG.md":"# Data Skill\n\nPath: `eng/tools/azure-sdk-tools/tests/data/azure-mgmt-network-31.0.0-CHANGELOG.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/eng/tools/azure-sdk-tools/tests/data/azure-mgmt-network-31.0.0-CHANGELOG.md)","eng/tools/azure-sdk-tools/tests/data/azure-mgmt-network-31.0.0-CHANGELOG.trimmed.md":"# Data Skill\n\nPath: `eng/tools/azure-sdk-tools/tests/data/azure-mgmt-network-31.0.0-CHANGELOG.trimmed.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/eng/tools/azure-sdk-tools/tests/data/azure-mgmt-network-31.0.0-CHANGELOG.trimmed.md)","eng/tools/azure-sdk-tools/tests/data/azure-mgmt-sql-4.0.0-CHANGELOG.md":"# Data Skill\n\nPath: `eng/tools/azure-sdk-tools/tests/data/azure-mgmt-sql-4.0.0-CHANGELOG.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/eng/tools/azure-sdk-tools/tests/data/azure-mgmt-sql-4.0.0-CHANGELOG.md)","eng/tools/azure-sdk-tools/tests/data/azure-mgmt-sql-4.0.0-CHANGELOG.trimmed.md":"# Data Skill\n\nPath: `eng/tools/azure-sdk-tools/tests/data/azure-mgmt-sql-4.0.0-CHANGELOG.trimmed.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/eng/tools/azure-sdk-tools/tests/data/azure-mgmt-sql-4.0.0-CHANGELOG.trimmed.md)","eng/tools/azure-sdk-tools/tests/integration/README.md":"# integration Documentation\n\nPath: `eng/tools/azure-sdk-tools/tests/integration/README.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/eng/tools/azure-sdk-tools/tests/integration/README.md)","sdk/ai/azure-ai-projects/.github/skills/README.md":"# Skills Skill\n\nPath: `sdk/ai/azure-ai-projects/.github/skills/README.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/sdk/ai/azure-ai-projects/.github/skills/README.md)","eng/tools/azure-sdk-tools/devtools_testutils/perfstress_tests/system_perfstress/README.md":"# system_perfstress Documentation\n\nPath: `eng/tools/azure-sdk-tools/devtools_testutils/perfstress_tests/system_perfstress/README.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/eng/tools/azure-sdk-tools/devtools_testutils/perfstress_tests/system_perfstress/README.md)","eng/tools/azure-sdk-tools/packaging_tools/templates/packaging_files/CHANGELOG.md":"# Packaging_files Skill\n\nPath: `eng/tools/azure-sdk-tools/packaging_tools/templates/packaging_files/CHANGELOG.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/eng/tools/azure-sdk-tools/packaging_tools/templates/packaging_files/CHANGELOG.md)","eng/tools/azure-sdk-tools/packaging_tools/templates/packaging_files/README.md":"# packaging_files Documentation\n\nPath: `eng/tools/azure-sdk-tools/packaging_tools/templates/packaging_files/README.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/eng/tools/azure-sdk-tools/packaging_tools/templates/packaging_files/README.md)","sdk/ai/azure-ai-projects/samples/agents/assets/product_info.md":"# Subagent: product_info\n\nPath: `sdk/ai/azure-ai-projects/samples/agents/assets/product_info.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/sdk/ai/azure-ai-projects/samples/agents/assets/product_info.md)","sdk/ai/azure-ai-projects/samples/agents/assets/tripadvisor_openapi.json":"# Assets Skill\n\nPath: `sdk/ai/azure-ai-projects/samples/agents/assets/tripadvisor_openapi.json`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/sdk/ai/azure-ai-projects/samples/agents/assets/tripadvisor_openapi.json)","sdk/ai/azure-ai-projects/samples/agents/assets/weather_openapi.json":"# Assets Skill\n\nPath: `sdk/ai/azure-ai-projects/samples/agents/assets/weather_openapi.json`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/sdk/ai/azure-ai-projects/samples/agents/assets/weather_openapi.json)","sdk/contentunderstanding/azure-ai-contentunderstanding/.github/skills/_shared/README.md":"# _shared Skill\n\nPath: `sdk/contentunderstanding/azure-ai-contentunderstanding/.github/skills/_shared/README.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/sdk/contentunderstanding/azure-ai-contentunderstanding/.github/skills/_shared/README.md)","eng/tools/azure-sdk-tools/tests/integration/scenarios/dev_requirement_samples/README.md":"# dev_requirement_samples Documentation\n\nPath: `eng/tools/azure-sdk-tools/tests/integration/scenarios/dev_requirement_samples/README.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/eng/tools/azure-sdk-tools/tests/integration/scenarios/dev_requirement_samples/README.md)","eng/tools/azure-sdk-tools/tests/integration/scenarios/optional_environment_two_options/README.md":"# optional_environment_two_options Documentation\n\nPath: `eng/tools/azure-sdk-tools/tests/integration/scenarios/optional_environment_two_options/README.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/eng/tools/azure-sdk-tools/tests/integration/scenarios/optional_environment_two_options/README.md)","eng/tools/azure-sdk-tools/tests/integration/scenarios/optional_environment_zero_options/README.md":"# optional_environment_zero_options Documentation\n\nPath: `eng/tools/azure-sdk-tools/tests/integration/scenarios/optional_environment_zero_options/README.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/eng/tools/azure-sdk-tools/tests/integration/scenarios/optional_environment_zero_options/README.md)","eng/tools/azure-sdk-tools/tests/integration/scenarios/pyproject_beta_invalid_metadata/README.md":"# pyproject_beta_invalid_metadata Documentation\n\nPath: `eng/tools/azure-sdk-tools/tests/integration/scenarios/pyproject_beta_invalid_metadata/README.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/eng/tools/azure-sdk-tools/tests/integration/scenarios/pyproject_beta_invalid_metadata/README.md)","eng/tools/azure-sdk-tools/tests/integration/scenarios/pyproject_beta_metadata/README.md":"# pyproject_beta_metadata Documentation\n\nPath: `eng/tools/azure-sdk-tools/tests/integration/scenarios/pyproject_beta_metadata/README.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/eng/tools/azure-sdk-tools/tests/integration/scenarios/pyproject_beta_metadata/README.md)","eng/tools/azure-sdk-tools/tests/integration/scenarios/pyproject_build_config/README.md":"# pyproject_build_config Documentation\n\nPath: `eng/tools/azure-sdk-tools/tests/integration/scenarios/pyproject_build_config/README.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/eng/tools/azure-sdk-tools/tests/integration/scenarios/pyproject_build_config/README.md)","eng/tools/azure-sdk-tools/tests/integration/scenarios/pyproject_invalid_metadata/README.md":"# pyproject_invalid_metadata Documentation\n\nPath: `eng/tools/azure-sdk-tools/tests/integration/scenarios/pyproject_invalid_metadata/README.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/eng/tools/azure-sdk-tools/tests/integration/scenarios/pyproject_invalid_metadata/README.md)","eng/tools/azure-sdk-tools/tests/integration/scenarios/pyproject_metadata/README.md":"# pyproject_metadata Documentation\n\nPath: `eng/tools/azure-sdk-tools/tests/integration/scenarios/pyproject_metadata/README.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/eng/tools/azure-sdk-tools/tests/integration/scenarios/pyproject_metadata/README.md)","eng/tools/azure-sdk-tools/tests/integration/scenarios/pyproject_project_def/README.md":"# pyproject_project_def Documentation\n\nPath: `eng/tools/azure-sdk-tools/tests/integration/scenarios/pyproject_project_def/README.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/eng/tools/azure-sdk-tools/tests/integration/scenarios/pyproject_project_def/README.md)","eng/tools/azure-sdk-tools/tests/integration/scenarios/pyproject_project_def_beta/README.md":"# pyproject_project_def_beta Documentation\n\nPath: `eng/tools/azure-sdk-tools/tests/integration/scenarios/pyproject_project_def_beta/README.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/eng/tools/azure-sdk-tools/tests/integration/scenarios/pyproject_project_def_beta/README.md)","eng/tools/azure-sdk-tools/tests/integration/scenarios/pyproject_project_def_with_extension/README.md":"# pyproject_project_def_with_extension Documentation\n\nPath: `eng/tools/azure-sdk-tools/tests/integration/scenarios/pyproject_project_def_with_extension/README.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/eng/tools/azure-sdk-tools/tests/integration/scenarios/pyproject_project_def_with_extension/README.md)","eng/tools/azure-sdk-tools/tests/integration/scenarios/setup_py_metapackage/README.md":"# setup_py_metapackage Documentation\n\nPath: `eng/tools/azure-sdk-tools/tests/integration/scenarios/setup_py_metapackage/README.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/eng/tools/azure-sdk-tools/tests/integration/scenarios/setup_py_metapackage/README.md)","eng/tools/azure-sdk-tools/tests/integration/scenarios/setup_py_project_def/README.md":"# setup_py_project_def Documentation\n\nPath: `eng/tools/azure-sdk-tools/tests/integration/scenarios/setup_py_project_def/README.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/eng/tools/azure-sdk-tools/tests/integration/scenarios/setup_py_project_def/README.md)","eng/tools/azure-sdk-tools/tests/integration/scenarios/snippet-updater/README.md":"# snippet-updater Documentation\n\nPath: `eng/tools/azure-sdk-tools/tests/integration/scenarios/snippet-updater/README.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/eng/tools/azure-sdk-tools/tests/integration/scenarios/snippet-updater/README.md)","eng/tools/azure-sdk-tools/tests/integration/scenarios/snippet-updater/README_missing_snippet.md":"# Snippet-updater Skill\n\nPath: `eng/tools/azure-sdk-tools/tests/integration/scenarios/snippet-updater/README_missing_snippet.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/eng/tools/azure-sdk-tools/tests/integration/scenarios/snippet-updater/README_missing_snippet.md)","eng/tools/azure-sdk-tools/tests/integration/scenarios/snippet-updater/README_out_of_sync.md":"# Snippet-updater Skill\n\nPath: `eng/tools/azure-sdk-tools/tests/integration/scenarios/snippet-updater/README_out_of_sync.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/eng/tools/azure-sdk-tools/tests/integration/scenarios/snippet-updater/README_out_of_sync.md)","sdk/ai/azure-ai-projects/.github/skills/azure-ai-projects-author-samples/prompts/diff-api-surface.prompt.md":"# Prompts Skill\n\nPath: `sdk/ai/azure-ai-projects/.github/skills/azure-ai-projects-author-samples/prompts/diff-api-surface.prompt.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/sdk/ai/azure-ai-projects/.github/skills/azure-ai-projects-author-samples/prompts/diff-api-surface.prompt.md)","sdk/ai/azure-ai-projects/.github/skills/azure-ai-projects-author-samples/references/sample-conventions.md":"# References Skill\n\nPath: `sdk/ai/azure-ai-projects/.github/skills/azure-ai-projects-author-samples/references/sample-conventions.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/sdk/ai/azure-ai-projects/.github/skills/azure-ai-projects-author-samples/references/sample-conventions.md)","sdk/ai/azure-ai-projects/.github/skills/azure-ai-projects-author-tests/references/test-conventions.md":"# References Skill\n\nPath: `sdk/ai/azure-ai-projects/.github/skills/azure-ai-projects-author-tests/references/test-conventions.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/sdk/ai/azure-ai-projects/.github/skills/azure-ai-projects-author-tests/references/test-conventions.md)","sdk/ai/azure-ai-projects/samples/skills/assets/team-status-update/status-update-template.md":"# Team-status-update Skill\n\nPath: `sdk/ai/azure-ai-projects/samples/skills/assets/team-status-update/status-update-template.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/sdk/ai/azure-ai-projects/samples/skills/assets/team-status-update/status-update-template.md)","sdk/contentunderstanding/azure-ai-contentunderstanding/.github/skills/cu-sdk-author-analyzer-classify-route/templates/classifier_template.json":"# Templates Skill\n\nPath: `sdk/contentunderstanding/azure-ai-contentunderstanding/.github/skills/cu-sdk-author-analyzer-classify-route/templates/classifier_template.json`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/sdk/contentunderstanding/azure-ai-contentunderstanding/.github/skills/cu-sdk-author-analyzer-classify-route/templates/classifier_template.json)","sdk/contentunderstanding/azure-ai-contentunderstanding/.github/skills/cu-sdk-author-analyzer/scripts/README.md":"# Scripts Skill\n\nPath: `sdk/contentunderstanding/azure-ai-contentunderstanding/.github/skills/cu-sdk-author-analyzer/scripts/README.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/sdk/contentunderstanding/azure-ai-contentunderstanding/.github/skills/cu-sdk-author-analyzer/scripts/README.md)","sdk/contentunderstanding/azure-ai-contentunderstanding/.github/skills/cu-sdk-author-analyzer/templates/schema_template.json":"# Templates Skill\n\nPath: `sdk/contentunderstanding/azure-ai-contentunderstanding/.github/skills/cu-sdk-author-analyzer/templates/schema_template.json`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/sdk/contentunderstanding/azure-ai-contentunderstanding/.github/skills/cu-sdk-author-analyzer/templates/schema_template.json)"},"files":{".github/skills/azsdk-common-pipeline-fixer/SKILL.md":"---\nname: azsdk-common-pipeline-fixer\nlicense: MIT\nmetadata:\n version: \"1.0.0\"\n distribution: shared\ndescription: 'Automatically fix Azure SDK CI/CD pipeline failures by applying code changes and verifying locally. USE FOR: \"fix pipeline failure\", \"fix CI\", \"fix failing tests\", \"auto-fix and commit the fix\", \"fix build error\", \"fix mypy/pylint/type-check/lint errors\", \"auto-fix pipeline\", \"resolve pipeline failure\". DO NOT USE FOR: pipeline analysis (instead use azsdk-common-pipeline-analysis), API design review, SDK publishing. INVOKES: azure-sdk-mcp:azsdk_package_build_code, azure-sdk-mcp:azsdk_package_run_check, azure-sdk-mcp:azsdk_package_run_tests, azure-sdk-mcp:azsdk_verify_setup.'\ncompatibility: \"azure-sdk-mcp server, local azure-sdk-for-{language} clone, language build tools\"\n---\n\n# Pipeline Fixer\n\nThis skill automatically fixes Azure SDK CI/CD pipeline failures. It analyzes the failure, identifies the root cause, applies code changes, and verifies the fix locally using build, check, and test tools before committing.\n\n## Rules\n\n- Requires the `azure-sdk-mcp` server and a local clone of the SDK language repo.\n- Work on the PR branch — the failing code is there, not main.\n- Analyze first, then apply the minimal code change for the root cause.\n- Verify ONLY via the azsdk MCP package tools (build → check → tests); never raw shell build/test commands.\n- Never fix infrastructure failures (timeouts, crashes, throttling) — recommend retry. Iterate up to 3 times, then report.\n\n## MCP Tools\n\n| Tool | Purpose |\n| ---------------------------------------- | ------------------------------------- |\n| `azure-sdk-mcp:azsdk_verify_setup` | Verify local environment is ready |\n| `azure-sdk-mcp:azsdk_package_build_code` | Build the package locally |\n| `azure-sdk-mcp:azsdk_package_run_check` | Run validation/lint/typecheck locally |\n| `azure-sdk-mcp:azsdk_package_run_tests` | Run tests locally |\n\n**Prerequisites:** azure-sdk-mcp server required. Local clone of the affected SDK language repo. Language build tools installed.\n\n## Steps\n\n1. **Find analysis** - Reuse an existing analysis from the PR comments; if none, view the `azsdk-common-pipeline-analysis` skill.\n2. **Classify** - Fixable (test, type, lint, import, assertion errors) vs retry (infrastructure) vs escalate (breaking API, credentials).\n3. **Locate** - Identify the affected package, its path, and the files/lines to change.\n4. **Fix** - Read the failing code at the cited lines and apply the minimal fix.\n5. **Verify** - Run `azsdk_package_build_code` → `azsdk_package_run_check` → `azsdk_package_run_tests` on the package; all must pass. If the environment isn't ready, run `azsdk_verify_setup`. Never substitute raw shell build/test commands.\n6. **Iterate & commit** - On failure, revise and re-verify (max 3 attempts). Once all pass, commit with a descriptive message.\n\n## Examples\n\n- \"Fix the pipeline failure for build 6447834\"\n- \"My Python SDK CI is failing with a type error, fix it\"\n- \"Auto-fix the failing tests in my PR\"\n\n## Troubleshooting\n\n- If the verify tools fail because the environment isn't ready, run `azsdk_verify_setup`, report its error, and stop — don't fall back to raw shell build/test commands.\n",".github/skills/azsdk-common-apiview-feedback-resolution/SKILL.md":"---\nname: azsdk-common-apiview-feedback-resolution\nlicense: MIT\nmetadata:\n version: \"1.0.0\"\n distribution: shared\ndescription: \"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.\"\ncompatibility: \"azure-sdk-mcp server, SDK pull request with APIView review link\"\n---\n\n# APIView Feedback Resolution\n\nThis skill analyzes and resolves APIView review feedback on Azure SDK pull requests by retrieving reviewer comments, categorizing them, and applying TypeSpec or customization updates that bring the SDK API surface into compliance before re-review.\n\n## Triggers\n\nUSE FOR: APIView comments, API review feedback, SDK API surface changes\nWHEN: \"resolve APIView comments\", \"address API review feedback\", \"update SDK API surface after APIView\"\nDO NOT USE FOR: general code review, non-APIView feedback\n\n## Rules\n\n- Requires the `azure-sdk-mcp` server; there is no CLI fallback for retrieving APIView comments or applying TypeSpec changes.\n- Retrieve and categorize APIView comments before making changes so fixes map to reviewer intent.\n- Validate, regenerate, build, and test after applying fixes before requesting re-review.\n\n## MCP Tools\n\n| Tool | Purpose |\n| -------------------------------------------------------- | --------------------------------------------------- |\n| `azure-sdk-mcp:azsdk_apiview_get_comments` | Get APIView comments |\n| `azure-sdk-mcp:azsdk_customized_code_update` | Apply TypeSpec & code customization changes locally |\n| `azure-sdk-mcp:azsdk_typespec_delegate_apiview_feedback` | Delegate to CCA pipeline |\n| `azure-sdk-mcp:azsdk_run_typespec_validation` | Validate TypeSpec |\n| `azure-sdk-mcp:azsdk_package_generate_code` | Regenerate SDK |\n\n## Steps\n\n1. **Retrieve** — Get APIView URL from SDK PR, run `azsdk_apiview_get_comments`.\n2. **Categorize** — Group as Critical/Suggestions/Informational per [feedback steps](references/feedback-resolution-steps.md).\n3. **Resolve** — Use `azsdk_customized_code_update` for TypeSpec changes; delegate via `azsdk_typespec_delegate_apiview_feedback` for complex cases.\n4. **Validate** — Run validation, regenerate SDK, build and test.\n5. **Confirm** — Verify all items addressed. If delegated, follow [post-delegation follow-up](references/feedback-resolution-steps.md#post-delegation-follow-up). Request re-review.\n\n## Examples\n\n- \"Resolve the APIView comments on my SDK pull request\"\n- \"What feedback did the API reviewer leave?\"\n\n## Troubleshooting\n\n- **No comments**: Verify PR has APIView link and MCP server is connected.\n- **Validation fails**: Re-run after fixing TypeSpec errors.\n- **MCP unavailable**: Requires `azure-sdk-mcp` server; no CLI fallback. Connect the server and retry.\n",".github/skills/azsdk-common-pipeline-analysis/SKILL.md":"---\nname: azsdk-common-pipeline-analysis\nlicense: MIT\nmetadata:\n version: \"1.0.0\"\n distribution: shared\ndescription: 'Analyze Azure SDK CI/CD pipeline failures into a structured diagnosis, and define the required output format. Load this skill before calling azsdk_analyze_pipeline, which returns raw failure data that this skill interprets and formats. USE FOR: \"pipeline failed\", \"build failure\", \"CI check failing\", \"tests failing in CI\", \"analyze pipeline\", \"debug SDK pipeline\". DO NOT USE FOR: local build issues without pipeline context, API design review, SDK publishing, applying code fixes (instead use azsdk-common-pipeline-fixer). INVOKES: azure-sdk-mcp:azsdk_analyze_pipeline, azure-sdk-mcp:azsdk_get_pipeline_llm_artifacts, azure-sdk-mcp:azsdk_get_failed_test_run_data, azure-sdk-mcp:azsdk_get_failed_test_case_data, azure-sdk-mcp:azsdk_get_pr_checks, azure-sdk-mcp:azsdk_get_pipeline_status.'\ncompatibility: \"azure-sdk-mcp server, Azure DevOps pipeline build ID or GitHub PR link\"\n---\n\n# Pipeline Analysis\n\nThis skill analyzes Azure SDK CI/CD pipeline failures and provides a structured diagnosis including root cause, affected files, and concrete instructions for how to fix each issue. It does NOT apply fixes - it tells you exactly what's wrong and how to resolve it.\n\n## Rules\n\n- Load this skill **before** running `azsdk_analyze_pipeline` — the tool returns raw failure data that this skill interprets and formats per [output format](references/output-format.md).\n- Requires the `azure-sdk-mcp` server; without it, inspect logs in the Azure DevOps UI.\n- Analysis-only: never edit files or apply fixes — use `azsdk-common-pipeline-fixer` for changes.\n- Run `azsdk_analyze_pipeline` first, then categorize each failure and cite specific files/lines.\n- For infrastructure failures (network timeouts, agent crashes, throttling), recommend retry, not code changes.\n\n## MCP Tools\n\n| Tool | Purpose |\n| ------------------------------------------------ | --------------------------------------------------- |\n| `azure-sdk-mcp:azsdk_analyze_pipeline` | Analyze pipeline failure (logs + test results) |\n| `azure-sdk-mcp:azsdk_get_pipeline_llm_artifacts` | Download test result artifacts from pipeline |\n| `azure-sdk-mcp:azsdk_get_failed_test_run_data` | Full details for every failure in one artifact file |\n| `azure-sdk-mcp:azsdk_get_failed_test_case_data` | Full details for a single failing test in a file |\n| `azure-sdk-mcp:azsdk_get_pr_checks` | Get pipeline/check results linked to a PR |\n| `azure-sdk-mcp:azsdk_get_pipeline_status` | Get pipeline run status |\n\n## Steps\n\n1. **Identify** - Get the build ID, pipeline URL, or PR link (use the PR link when triggered from a PR comment).\n2. **Analyze** - Run `azsdk_analyze_pipeline`. It returns `failed_pipeline_tasks` (log errors from failed steps) and `failed_pipeline_tests`, a lightweight index of failed tests grouped by artifact file. Each entry has `artifact_file_path`, `platform`, and `failed_test_titles` — titles only, no error text, to keep the response small.\n3. **Fetch failure details** - Fetch failure details lazily so you don't overload context: call `azsdk_get_failed_test_run_data` with the parameter `failedTestRunsPath` set to `artifact_file_path` once per file to get every failure in it. Or call `azsdk_get_failed_test_case_data` with\n `failedTestRunsPath` set to `artifact_file_path` and `testCaseTitle` set to one exact title from `failed_test_titles`. Prefer the per-file call when triaging a whole file's failures.\n4. **Categorize** each failure: test, build/compilation, validation/lint, or infrastructure.\n5. **Diagnose** - Give each failure's root cause and affected file(s)/line(s), and note if several share one root cause. See [failure patterns](references/failure-patterns.md).\n6. **Report** - Use the [output format](references/output-format.md): root cause, affected files, per-failure fix + verify command, and fixable vs infrastructure. Recommend `azsdk-common-pipeline-fixer` to apply fixes.\n\n## Examples\n\n- \"My pipeline build 6447834 failed, what went wrong?\"\n- PR comment: `@copilot Analyze the failed pipeline on this PR`\n- \"Why is my CI red? Build ID is 6455939\"\n\n## Troubleshooting\n\n- If `azsdk_analyze_pipeline` returns no data, verify the build ID is correct and the run has completed.\n- If `failed_pipeline_tests` is empty, rely on `failed_pipeline_tasks` log analysis (test-artifact upload may not be configured).\n- For a private/internal pipeline, the user may need to `az login`. See [failure patterns](references/failure-patterns.md).\n",".github/skills/agentic-workflows/SKILL.md":"---\nname: agentic-workflows\ndescription: Route gh-aw workflow design/create/debug/upgrade requests to the right prompts.\n---\n\n# Agentic Workflows Router\n\nUse this skill when a user asks to design, create, update, debug, or upgrade GitHub Agentic Workflows in this repository.\n\nThis skill is a dispatcher: identify the task type, load the matching workflow prompt/skill file, and follow it directly. Keep responses concise and ask a clarifying question if the correct prompt is unclear.\n\nRepository overlay (optional):\n- If `.github/aw/instructions.md` exists, load it with `@.github/aw/instructions.md` after loading the matched prompt/skill.\n- Precedence: repository overlay instructions override upstream defaults when they conflict.\n\nRead only the files you need:\nLoad these files from `github/gh-aw` (they are not available locally).\n- `.github/aw/action-container-substitutions.md`\n- `.github/aw/agent-runtime-instructions.md`\n- `.github/aw/agentic-chat.md`\n- `.github/aw/agentic-workflows-mcp.md`\n- `.github/aw/asciicharts.md`\n- `.github/aw/campaign.md`\n- `.github/aw/charts-trending.md`\n- `.github/aw/charts.md`\n- `.github/aw/cli-commands.md`\n- `.github/aw/compat.md`\n- `.github/aw/configure-agentic-engine.md`\n- `.github/aw/context.md`\n- `.github/aw/create-agentic-workflow-trigger-details.md`\n- `.github/aw/create-agentic-workflow.md`\n- `.github/aw/create-shared-agentic-workflow.md`\n- `.github/aw/debug-agentic-workflow.md`\n- `.github/aw/dependabot.md`\n- `.github/aw/deployment-status.md`\n- `.github/aw/designer-mappings.md`\n- `.github/aw/designer.md`\n- `.github/aw/drive-memory.md`\n- `.github/aw/enclaves.md`\n- `.github/aw/evals.md`\n- `.github/aw/experiments.md`\n- `.github/aw/github-agentic-workflows.md`\n- `.github/aw/github-mcp-server-pagination.md`\n- `.github/aw/github-mcp-server-tools.md`\n- `.github/aw/github-mcp-server.md`\n- `.github/aw/instructions.md`\n- `.github/aw/intent.md`\n- `.github/aw/jobs.md`\n- `.github/aw/linter-workflows.md`\n- `.github/aw/llms.md`\n- `.github/aw/loop.md`\n- `.github/aw/lsp.md`\n- `.github/aw/maintainer.md`\n- `.github/aw/mcp-clis.md`\n- `.github/aw/memory-stateful-patterns.md`\n- `.github/aw/memory.md`\n- `.github/aw/messages.md`\n- `.github/aw/multi-agent-research.md`\n- `.github/aw/network.md`\n- `.github/aw/optimize-agentic-workflow.md`\n- `.github/aw/patterns.md`\n- `.github/aw/playwright.md`\n- `.github/aw/pr-reviewer.md`\n- `.github/aw/release-workflow.md`\n- `.github/aw/report.md`\n- `.github/aw/reuse.md`\n- `.github/aw/safe-outputs-automation.md`\n- `.github/aw/safe-outputs-content.md`\n- `.github/aw/safe-outputs-management.md`\n- `.github/aw/safe-outputs-runtime.md`\n- `.github/aw/safe-outputs.md`\n- `.github/aw/serena-tool.md`\n- `.github/aw/shared-safe-jobs.md`\n- `.github/aw/skills.md`\n- `.github/aw/subagents.md`\n- `.github/aw/syntax-agentic.md`\n- `.github/aw/syntax-core.md`\n- `.github/aw/syntax-engine.md`\n- `.github/aw/syntax-tools-imports.md`\n- `.github/aw/syntax.md`\n- `.github/aw/test-coverage.md`\n- `.github/aw/test-expression.md`\n- `.github/aw/token-optimization-caching-budgets.md`\n- `.github/aw/token-optimization-observability.md`\n- `.github/aw/token-optimization.md`\n- `.github/aw/triggers.md`\n- `.github/aw/update-agentic-workflow.md`\n- `.github/aw/upgrade-agentic-workflows.md`\n- `.github/aw/visual-regression.md`\n- `.github/aw/workflow-constraints.md`\n- `.github/aw/workflow-editing.md`\n- `.github/aw/workflow-patterns.md`\n\nAfter loading the matching workflow prompt or skill, follow it directly:\n- Design workflows from scratch via interview: `.github/aw/designer.md`\n- Create new workflows: `.github/aw/create-agentic-workflow.md`\n- Configure or add declarative engines: `.github/aw/configure-agentic-engine.md`\n- Update existing workflows: `.github/aw/update-agentic-workflow.md`\n- Debug, audit, or investigate workflows: `.github/aw/debug-agentic-workflow.md`\n- Upgrade workflows and fix deprecations: `.github/aw/upgrade-agentic-workflows.md`\n- Create shared components or MCP wrappers: `.github/aw/create-shared-agentic-workflow.md`\n- Create report-generating workflows: `.github/aw/report.md`\n- Fix Dependabot manifest PRs: `.github/aw/dependabot.md`\n- Analyze coverage workflows: `.github/aw/test-coverage.md`\n- Render compact markdown charts: `.github/aw/asciicharts.md`\n- Map CLI commands to MCP usage: `.github/aw/cli-commands.md`\n- Choose workflow architecture and patterns: `.github/aw/patterns.md`\n- Optimize token usage and cost: `.github/aw/token-optimization.md`\n- Design long-running multi-agent research workflows: `.github/aw/multi-agent-research.md`\n- Add skills or agent plugins requested by the user (`skills:` / `plugins:` frontmatter, never on-the-fly installs): `.github/aw/skills.md`\n\nWhen the task involves OTEL, OTLP, traces, observability backends, or telemetry-driven analysis, also read and follow `skills/otel-queries/SKILL.md` after loading the matching workflow prompt or skill.\n",".github/skills/azsdk-common-prepare-release-plan/SKILL.md":"---\nname: azsdk-common-prepare-release-plan\nlicense: MIT\nmetadata:\n version: \"1.0.0\"\n distribution: shared\ndescription: '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_update_release_plan, azure-sdk-mcp:azsdk_update_release_plan_target, 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.'\ncompatibility: \"azure-sdk-mcp server, API spec PR in Azure/azure-rest-api-specs\"\n---\n\n# Prepare Release Plan\n\nThis skill creates, gets, updates, abandons, and links SDK PRs to release plan work items for Azure SDK releases, helping gather required release data, validate spec inputs, and link related approvals or SDK pull requests without exposing internal work item URLs.\n\n## Triggers\n\nUSE 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\nWHEN: \"create release plan\", \"get release plan\", \"update release plan\", \"abandon release plan\", \"link SDK PR to plan\", \"namespace approval\", \"check release plan status\"\nDO NOT USE FOR: SDK code generation, pipeline troubleshooting, API review feedback\n\n## Rules\n\n- Do not display Azure DevOps work item URLs; only provide the Release Plan Link and ID.\n- Require an API spec PR link or a TypeSpec project path before creating or updating a plan.\n- Validate that the spec PR repository matches the requested API release type before creation.\n- Release plan tools accept **either** a Release Plan ID or an Azure DevOps work item ID — pass whichever the user provides. Each tool resolves the value automatically (trying it as a Release Plan ID first, then as a work item ID), so you do not need to call `azure-sdk-mcp:azsdk_get_release_plan` first just to translate one ID into the other.\n- Always relay schedule-risk `warnings` and `next_steps` returned by release plan tools. For each past-due plan, show its Release Plan ID and dashboard link, then present both choices: update its target release month or abandon it and record the reason in the dashboard.\n\n## MCP Tools\n\n| Tool | Purpose |\n| ------------------------------------------------------------------ | ---------------------------------- |\n| `azure-sdk-mcp:azsdk_create_release_plan` | Create a new release plan |\n| `azure-sdk-mcp:azsdk_get_release_plan` | Get plan by ID, path, or spec PR |\n| `azure-sdk-mcp:azsdk_update_release_plan` | Update release plan metadata |\n| `azure-sdk-mcp:azsdk_update_release_plan_target` | Update the target release month |\n| `azure-sdk-mcp:azsdk_update_api_spec_pull_request_in_release_plan` | Update API spec PR URL in plan |\n| `azure-sdk-mcp:azsdk_update_sdk_details_in_release_plan` | Update SDK/package details in plan |\n| `azure-sdk-mcp:azsdk_abandon_release_plan` | Abandon a release plan |\n| `azure-sdk-mcp:azsdk_link_sdk_pull_request_to_release_plan` | Link SDK PR to release plan |\n| `azure-sdk-mcp:azsdk_link_namespace_approval_issue` | Link namespace approval issue |\n\n---\n\n## Use Cases\n\n### 1. Create Release Plan\n\n**When**: User wants to create a release plan for a TypeSpec project.\n\n**Steps**:\n\n1. **Get TypeSpec Project Path** — Ask the user for the relative TypeSpec project path (directory containing `tspconfig.yaml`, e.g. `specification/contosowidgetmanager/Contoso.WidgetManager`). Always use the relative path from the repo root, not an absolute path.\n2. **Check Existing** — Run `azure-sdk-mcp:azsdk_get_release_plan` with the relative `typeSpecProjectPath` to check if a release plan already exists.\n - If a release plan exists with the **same API release type** the user requested: inform the user that a release plan already exists, show the Release Plan ID, status, and API release type. Suggest the user use the existing release plan. Do NOT create a new one.\n - If a release plan exists but for a **different API release type**: inform the user about the existing plan and its API release type, then proceed to create a new release plan using `forceCreateReleasePlan: true` for the user's requested API release type. Do NOT attempt to update the existing release plan's API release type.\n - If no release plan exists, proceed to step 3.\n3. **Gather Info** — Collect required details from the user. See [details](references/release-plan-details.md):\n - Target release month/year (format: \"Month YYYY\", e.g. \"June 2026\"). Do NOT use formats like \"2026-06\" or \"06/2026\" — these are invalid.\n - API release type: Value must be one of the following: \"Private Preview\", \"Public Preview\", or \"GA\"\n - SDK release type: Value must be \"beta\" or \"stable\" — always ask the user explicitly\n - Spec PR URL (optional)\n - Service Tree ID (GUID) — optional if previously created\n - Product Tree ID (GUID) — optional if previously created\n4. **Create** — Run `azure-sdk-mcp:azsdk_create_release_plan` with the collected parameters including `sdkReleaseType`. Use `forceCreateReleasePlan: true` only if an existing release plan was found for a different API release type.\n5. **Namespace** — For first management plane releases, link namespace approval issue using `azure-sdk-mcp:azsdk_link_namespace_approval_issue`.\n\n> **IMPORTANT**: Do NOT default the API release type value as the SDK release type. These are separate fields — always ask the user explicitly for the SDK release type.\n>\n> **IMPORTANT**: Do NOT update an existing release plan to change its API release type. If a release plan exists for a different API release type, force-create a new one instead.\n\n**Tool**: `azure-sdk-mcp:azsdk_create_release_plan`\n\n---\n\n### 2. Get Release Plan\n\n**When**: User wants to check the status or details of an existing release plan.\n\n**Steps**:\n\n1. **Identify Plan** — Ask user for one of:\n - Release plan ID or work item ID\n - Relative TypeSpec project path (e.g. `specification/contosowidgetmanager/Contoso.WidgetManager`)\n - Spec PR URL\n2. **Query** — Run `azure-sdk-mcp:azsdk_get_release_plan` with the provided identifier. Always use a relative path for `typeSpecProjectPath`; use `specPullRequestUrl` when the user provides only a spec PR URL.\n3. **Display** — Show the release plan ID, status, linked PRs, and SDK details. Always relay schedule-risk warnings and recommended actions from the response.\n\n**Tool**: `azure-sdk-mcp:azsdk_get_release_plan`\n\n---\n\n### 3. Update Release Plan / Update API Spec in Release Plan\n\n**When**: User needs to update release plan metadata (spec PR URL, TypeSpec project path, SDK release type, service/product IDs) or update the API spec PR link.\n\n**Steps**:\n\n1. **Identify Plan** — Get the work item ID or TypeSpec project path from the user.\n2. **Update Metadata** — Run `azure-sdk-mcp:azsdk_update_release_plan` with:\n - `typeSpecProjectPath` (required)\n - `workItemId` (optional — resolved from TypeSpec path or spec PR if not provided)\n - `specPullRequestUrl` (optional)\n - `sdkReleaseType` (required — do NOT default this from API release type; always ask user explicitly)\n - `serviceTreeId` (optional)\n - `productTreeId` (optional)\n3. **Update API Spec PR** — If only the spec PR URL needs updating, run `azure-sdk-mcp:azsdk_update_api_spec_pull_request_in_release_plan` with:\n - `specPullRequestUrl` (required)\n - `workItemId` or `releasePlanId`\n\n**Tools**: `azure-sdk-mcp:azsdk_update_release_plan`, `azure-sdk-mcp:azsdk_update_api_spec_pull_request_in_release_plan`\n\n---\n\n### 4. Update SDK/Package Details in Release Plan\n\n**When**: User needs to update SDK language and package name details in the release plan after code generation or configuration changes.\n\n**Steps**:\n\n1. **Identify Plan** — Get the Release Plan ID or work item ID from the user (either is accepted).\n2. **Identify TypeSpec Project** — Get or confirm the TypeSpec project path.\n3. **Update** — Run `azure-sdk-mcp:azsdk_update_sdk_details_in_release_plan` with:\n - `workItemId` (required — accepts either the Release Plan ID or the work item ID)\n - `typeSpecProjectPath` (required)\n\n**Tool**: `azure-sdk-mcp:azsdk_update_sdk_details_in_release_plan`\n\n---\n\n### 5. Abandon a Release Plan\n\n**When**: User decides to cancel or discard a release plan that is no longer needed.\n\n**Steps**:\n\n1. **Identify Plan** — Get the work item ID or release plan ID from the user.\n2. **Confirm** — Ask user to confirm abandonment: \"Are you sure you want to abandon this release plan? This action updates the status to Abandoned.\"\n3. **Abandon** — Run `azure-sdk-mcp:azsdk_abandon_release_plan` with:\n - `workItemId` or `releasePlanId`\n\n**Tool**: `azure-sdk-mcp:azsdk_abandon_release_plan`\n\n---\n\n### 6. Link SDK Pull Request to Release Plan\n\n**When**: SDK pull requests have been created and need to be associated with the release plan.\n\n**Steps**:\n\n1. **Identify Plan** — Get the Release Plan ID or work item ID from the user (either is accepted).\n2. **Collect PR Info** — Get the SDK pull request URL and language from the user.\n3. **Link** — Run `azure-sdk-mcp:azsdk_link_sdk_pull_request_to_release_plan` with:\n - `pullRequestUrl` (required)\n - `language` (required — e.g., \".NET\", \"Java\", \"JavaScript\", \"Python\", \"Go\")\n - `workItemId` or `releasePlanId` (either accepts the Release Plan ID or the work item ID)\n4. **Repeat** — If multiple SDK PRs exist for different languages, repeat for each.\n\n**Tool**: `azure-sdk-mcp:azsdk_link_sdk_pull_request_to_release_plan`\n\n---\n\n## Examples\n\n- \"Create a release plan for my spec PR\"\n- \"Get the release plan for work item 12345\"\n- \"What is the status of my release plan?\"\n- \"Update the API spec PR in my release plan\"\n- \"Update SDK details in release plan 67890\"\n- \"Abandon release plan 11111\"\n- \"Link my SDK PR to release plan\"\n- \"Link Python SDK PR #100 to release plan 67890\"\n\n## Troubleshooting\n\n- Requires `azure-sdk-mcp` server; no CLI fallback — prompt user to configure MCP if unavailable.\n- If creation fails, verify spec PR URL and Service Tree IDs.\n- If update fails, ensure the Release Plan ID or work item ID is correct and the plan is not already abandoned.\n- If linking fails, verify the SDK PR URL is valid and the language matches a supported value.\n",".github/skills/azsdk-common-generate-sdk-locally/SKILL.md":"---\nname: azsdk-common-generate-sdk-locally\nlicense: MIT\nmetadata:\n version: \"1.1.1\"\n distribution: shared\ndescription: 'Generate and finalize Azure SDKs locally from TypeSpec, including build, checks, tests, changelog, metadata, and version updates by default. WHEN: \"generate SDK locally\", \"build SDK\", \"run SDK tests\", \"run CI checks\", \"validate package\", \"run checks\", \"update changelog\", \"fix SDK build errors\", \"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\". 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.'\ncompatibility: \"azure-sdk-mcp server, local azure-sdk-for-{language} clone, language build tools\"\n---\n\n# Generate SDK Locally\n\nThis 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.\n\n## Triggers\n\nUSE FOR: generate, build, and test Azure SDKs locally from TypeSpec with automatic customization; update changelog; fix SDK build errors; 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\nWHEN: \"generate SDK locally\", \"build SDK\", \"run SDK tests\", \"update changelog\", \"fix SDK build errors\", \"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\"\n\n## Boundaries\n\nDo not use this skill for:\n\n- Publishing SDK packages to package registries\n- CI pipeline configuration\n- API design review\n\n## Rules\n\n- Interpret **\"generate SDK\"** and **\"generate SDK locally\"** as requests for the complete workflow: generate, build, validate, test, update changelog, update metadata, and update version. Do not treat the word \"generate\" by itself as a generate-only request.\n- Stop after generation and a successful build when the user explicitly says **\"generate only\"**, **\"only generate\"**, or otherwise explicitly asks to skip checks, tests, changelog, metadata, and version updates. Bind `only` to the generation action even when a target qualifier follows: **\"generate SDK only for Web PubSub\"** is a generate-only request scoped to Web PubSub. By contrast, **\"generate the SDK for only the Web PubSub service\"** scopes the complete workflow to one service. Once a request is classified as generate-only, do not prompt for a commit or run steps 8–11. If the user's intent is unclear, default to the complete workflow.\n- This skill generates an SDK **locally** from a local clone. Use it to generate an SDK **only when the user indicates local generation** — they say \"local\"/\"locally\", or are working from a local clone. If the user asks to \"generate SDK for **all languages**\", to generate **for a release plan / release ID** (even a single language), to generate **without a local clone**, or wants SDK **pull requests created** for them, do **not** generate locally — use the `azsdk-common-generate-sdk-pipeline` skill, which runs the SDK generation pipeline for each language and produces the SDK pull requests.\n- Never use `azure-sdk-mcp:azsdk_get_sdk_pull_request_link` or `azure-sdk-mcp:azsdk_get_pull_request` to _generate_ an SDK; those only retrieve links for SDKs that were already generated.\n- Requires the `azure-sdk-mcp` server for the MCP workflow; without MCP, use `npm exec --prefix eng/common/tsp-client -- tsp-client` CLI.\n- Verify the target language repo and the correct TypeSpec configuration file before generation.\n- After generation or customization, run the check and test steps before updating metadata or finalizing changes.\n\n## MCP Tools\n\n| Tool | Purpose |\n| ------------------------------------------------------ | ------------------------------------------------------ |\n| `azure-sdk-mcp:azsdk_verify_setup` | Verify environment |\n| `azure-sdk-mcp:azsdk_package_generate_code` | Generate SDK |\n| `azure-sdk-mcp:azsdk_package_build_code` | Build package |\n| `azure-sdk-mcp:azsdk_package_run_check` | Validate package |\n| `azure-sdk-mcp:azsdk_package_run_tests` | Run tests |\n| `azure-sdk-mcp:azsdk_customized_code_update` | Apply customizations (includes regeneration and build) |\n| `azure-sdk-mcp:azsdk_package_update_changelog_content` | Update changelog |\n| `azure-sdk-mcp:azsdk_package_update_metadata` | Update metadata including ci.yml |\n| `azure-sdk-mcp:azsdk_package_update_version` | Update version |\n\nPrerequisites: azure-sdk-mcp server must be running. Without MCP, use `npx tsp-client` CLI.\n\n## Steps\n\n1. **Select language** — Confirm target language: .NET, Java, JavaScript, Python, Go, or Rust.\n2. **Verify repo** — Ensure the user has a local clone of the correct [SDK repo](references/sdk-repos.md). If not cloned, instruct user to clone it.\n3. **Identify config file** — Determine the path to the TypeSpec configuration file. See [config file details](references/detailed-workflow.md).\n - From `azure-rest-api-specs` repo: use path to `tspconfig.yaml`.\n - From an SDK language repo: use path to `tsp-location.yaml`.\n4. **Verify setup** — Run `azure-sdk-mcp:azsdk_verify_setup` to confirm environment.\n5. **Generate** — Run `azure-sdk-mcp:azsdk_package_generate_code` with the config file path.\n6. **Build** — Run `azure-sdk-mcp:azsdk_package_build_code`. For .NET, use the `additionalArguments: \"/p:RunApiCompat=false\"` to skip API compatibility checks if user requests to skip API compatibility check.\n7. **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](references/customization-workflow.md). _(If the user requested \"generate only\", stop here — skip steps 8–11.)_\n8. **Commit checkpoint** — Prompt the user to commit generated changes before proceeding. See [commit checkpoint details](references/detailed-workflow.md).\n9. **Validate** — Run `azure-sdk-mcp:azsdk_package_run_check` and `azure-sdk-mcp:azsdk_package_run_tests`.\n10. **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.)_\n11. **Final commit** — Prompt the user to commit final changes (changelog, metadata, version). See [commit checkpoint details](references/detailed-workflow.md).\n\n[SDK repos](references/sdk-repos.md) | [Customization workflow](references/customization-workflow.md) | [Detailed workflow](references/detailed-workflow.md)\n\n## Guardrails\n\n- **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.\n- 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.\n- Only the customization tool understands the correct layering of TypeSpec decorators vs code patches and ensures regenerated code stays consistent.\n\n## Examples\n\n- \"Generate the SDK locally for my TypeSpec service\"\n- \"Build and test the Python SDK package\"\n- \"Run CI checks for my SDK package\"\n- \"Fix the SDK build errors on this PR\"\n- \"Rename FooClient to BarClient for .NET\"\n- \"Hide the internal polling operation from the Python SDK\"\n- \"Fix .NET analyzer errors AZC0030 and AZC0012\"\n- \"The build is failing because a customization references a renamed property\"\n- \"Create a subclient architecture for the Python SDK\"\n- \"Apply TypeSpec customizations to fix compilation errors\"\n- \"Update the changelog for this SDK package\"\n- \"Update the package version\"\n- \"Update the package metadata and ci.yml\"\n\n## Troubleshooting\n\n- For \"generate SDK for all languages\", pipeline-based generation, or when no local SDK clone exists, call `azure-sdk-mcp:azsdk_run_generate_sdk` instead of the local generate flow, and never substitute `azure-sdk-mcp:azsdk_get_sdk_pull_request_link` / `azure-sdk-mcp:azsdk_get_pull_request` for generation.\n- Run `azure-sdk-mcp:azsdk_verify_setup` to confirm MCP and tools.\n- If build fails with type conflicts, breaking changes, analyzer errors, or customization drift, use `azure-sdk-mcp:azsdk_customized_code_update` to apply customizations.\n- The customization tool uses a two-phase approach: TypeSpec decorators first (Phase A), then code repairs if needed (Phase B).\n- 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.\n- Without MCP, use `npx tsp-client` CLI.\n",".github/skills/azsdk-common-sdk-breaking-change/SKILL.md":"---\nname: azsdk-common-sdk-breaking-change\nlicense: MIT\nmetadata:\n version: \"1.0.0\"\n distribution: shared\ndescription: 'Detect and mitigate SDK Breaking changes for an SDK package which is generated from TypeSpec. WHEN: \"Detect SDK breaking changes for a service\", \"Detect SDK breaking changes for an SDK package\", \"Detect and mitigate SDK breaking changes for a service\", \"Detect and mitigate SDK breaking changes for an SDK package\". INVOKES: skill: azsdk-common-generate-sdk-locally; MCP tools: azure-sdk-mcp:azsdk_customized_code_update, azure-sdk-mcp:azsdk_package_detect_breaking_change.'\ncompatibility: \"azure-sdk-mcp server, local azure-sdk-for-{language} clone, language build tools\"\n---\n\n# SDK Breaking Change Detection and Mitigation\n\n## MCP Tools\n\n| Tool | Purpose |\n| ---------------------------------------------------- | --------------------------- |\n| `azure-sdk-mcp:azsdk_customized_code_update` | Apply customizations |\n| `azure-sdk-mcp:azsdk_package_detect_breaking_change` | Detect SDK breaking changes |\n\nPrerequisites: azure-sdk-mcp server must be running.\n\n## Steps\n\n1. **Select language** — First extract one or more target languages from the user's prompt. If the prompt specifies any target languages, use them without asking the user to confirm. If it does not specify a target language, prompt the user to choose one or more from this list, presented in exactly this order: Go, Java, JavaScript, Python, .NET.\n\n- For each selected language in step 1, execute steps 2 through 6 **one language at a time** — fully complete all steps for one language before starting the next. Process multiple selected languages in the same order they appear in the list above.\n\n2. Follow `azsdk-common-generate-sdk-locally` skill to generate SDK only. For .NET, require the preparatory build to disable API compatibility checks using additionalArguments: \"/p:RunApiCompat=false\". This is a requirement of this workflow: compatibility findings must reach the detection and user-selection steps rather than be automatically repaired during generation.\n3. **Detect SDK breaking Changes** - Run `azure-sdk-mcp:azsdk_package_detect_breaking_change`\n4. **Display detected breaking changes** — If step 3 fails, display the `ResponseError` message and stop processing the current language. If step 3 detects breaking changes, display a `## Detected Breaking Changes` title followed by a Markdown table. Include exactly one breaking change per row with these columns: `Breaking Change`, `Category`, and `Resolution`. Preserve the category and resolution returned by the detection tool; do not replace them with a summary. If no breaking changes are detected, report that result and stop processing the current language.\n5. **Prompt the user to choose breaking changes to mitigate** — If the user requested detection only, stop processing the current language after displaying the results. Otherwise, present the list from step 3 as a multiple-choice selection.\n6. **Mitigate selected SDK breaking changes** — If the user selects no changes in step 5, stop processing the current language. Otherwise, run `azure-sdk-mcp:azsdk_customized_code_update` for the selected changes with these parameters:\n\n- packagePath: The SDK package path\n- customizationRequest: resolve the 'breakingChanges' chosen in step 5\n- tspProjectPath: the typespec project path\n- editScope: Set this based on the repository where the skill is running. When running in the target SDK language repository, use `'CustomCode'`. When running in `azure-rest-api-specs`, use `'All'` if the target SDK language repository is also available as a local clone; otherwise, use `'SpecInputs'`.\n\nAfter step 6, begin the next iteration. If the customization modified TypeSpec, first repeat step 2 to regenerate the SDK; otherwise, resume at step 3. Then repeat steps 3 through 6. Run at most three detection-and-mitigation iterations per language, stopping earlier if no breaking changes remain or the user declines further mitigation. After the third mitigation, run step 3 once more to identify and report any remaining breaking changes, then stop without offering a fourth mitigation.\n\n## Examples\n\n- \"Detect and mitigate SDK breaking changes for the service\"\n- \"Detect SDK breaking changes for the service\"\n- \"Detect SDK breaking changes for Go SDK package\"\n- \"Detect and mitigate SDK breaking changes for Go SDK package\"\n\n## Troubleshooting\n\n- Requires the `azure-sdk-mcp` server. If it is unavailable, direct the user to the [quick-start guide](https://github.com/Azure/azure-sdk-tools/blob/main/tools/azsdk-cli/Azure.Sdk.Tools.Cli/README.md#quick-start) to configure it before continuing.\n- Requires a local clone of the target SDK repository. If unavailable, prompt the user to clone it before continuing.\n",".github/skills/code-review/SKILL.md":"---\nname: code-review\ndescription: \"Review pull requests and code changes in the Azure SDK for Python repository. USE FOR: GitHub Copilot code review; CCR; review pull request; review PR; review diff; find bugs or regressions introduced by a PR; cross-package SDK review. Finds high-confidence correctness, security, API compatibility, dependency, documentation, and test issues. DO NOT USE FOR: implementing fixes; running tests; fixing CI; releases; APIView feedback.\"\n---\n\n# Azure SDK for Python Code Review\n\nUse this skill for GitHub Copilot code review (CCR) and other broad pull request reviews. If the task already assigns a narrower specialist role, that scope remains authoritative; use this skill's evidence and quality gates without expanding the specialist review.\n\n## Review Process\n\n1. Read the pull request description and identify the intended behavior.\n2. Categorize the changed files and apply only the relevant guidance below.\n3. Review correctness and behavioral regressions first, then apply the relevant SDK-specific checks.\n4. Trace changes through callers, exports, tests, API reports, documentation, and package metadata when those relationships affect correctness.\n5. Inspect enough unchanged context to verify existing guards, invariants, and behavior before reporting a finding.\n\nFor changes outside `sdk/`, review correctness, security, and test coverage\nwithout imposing SDK-specific conventions.\n\n## Load Guidance Progressively\n\n| Changed surface or risk | Guidance |\n| --- | --- |\n| SDK source or public API | `.github/instructions/reviewer/sdk-source.instructions.md` and the [Azure SDK Python Design Guidelines](https://azure.github.io/azure-sdk/python_design.html) |\n| Tests or coverage implications | `.github/instructions/reviewer/testing.instructions.md` |\n| README, CHANGELOG, docstrings, or samples | `.github/instructions/reviewer/documentation.instructions.md` |\n| Packaging or dependencies | `.github/instructions/reviewer/dependencies.instructions.md` |\n| `sdk/*/azure-mgmt-*/` | `.github/instructions/reviewer/management.instructions.md` |\n\nManagement-specific review scope and rules take precedence over generic SDK\nguidance: skip `generated_samples/` and `generated_tests/`, and review only\n`_client.py` under `azure/mgmt/**/`. Read metadata and documentation needed to\ncheck the management rules. Do not apply the JavaScript repo's TypeScript,\npnpm, or API-report conventions to Python packages.\n\nGenerated output is usually not the fix location: identify the actionable\nTypeSpec, customization, or generator cause when evidence supports it. Do not\nspeculate about the upstream fix or mistake a preview-only API change for a\nbreaking change in a released stable API.\n\n## Findings\n\n- Report actionable, high-confidence issues with changed file/line, the\n observed behavior, the scenario in which it fails, and a concrete remedy.\n- Prioritize correctness, compatibility, and security over stylistic\n preferences. Do not claim a tool or test failure without running it.\n- Do not duplicate the same root cause across multiple files. If evidence is\n incomplete, state what could not be verified instead of guessing.\n- If there are no findings, say so briefly; do not pad the review with passing\n checks or generic suggestions.\n",".github/skills/create-api-review/SKILL.md":"---\nname: create-api-review\nlicense: MIT\nmetadata:\n version: \"1.0.0\"\n distribution: shared\ndescription: 'Create an API review PR for an Azure SDK package using API Review Hub. **UTILITY SKILL**. USE FOR: \"create API review\", \"open API review\", \"compare package versions\", \"APIView PR\". DO NOT USE FOR: fixing APIView comments, SDK code generation, pipeline debugging. INVOKES: azure-sdk-mcp:azsdk_apireviewhub_request_review_pr.'\ncompatibility: \"azure-sdk-mcp server v0.6.32 or later\"\n---\n\n# Create API Review\n\nThis skill creates an API review pull request through API Review Hub for a package API surface comparison.\n\n## Triggers\n\nUSE FOR: create API review, open API review, compare package versions, APIView PR\nWHEN: \"create API review\", \"open API review\", \"compare package versions\", \"APIView PR\"\nDO NOT USE FOR: fixing APIView comments, SDK code generation, pipeline debugging\n\n## Rules\n\n- Requires `azure-sdk-mcp` version `0.6.32` or later.\n- Use `azure-sdk-mcp:azsdk_apireviewhub_request_review_pr` to create the review PR.\n- CLI equivalent is `azsdk api-review create`.\n- Language is fixed to `python` for this repository.\n- Required user inputs: `packageName`, `targetBranch`.\n- `baseTag` defines the baseline version. Use package tag format: `_`.\n- If `baseTag` is omitted, ask the user to choose one of:\n - Use the latest GA (non-beta) release tag for `packageName`.\n - Provide a specific tag or version to use as baseline.\n- Direct MCP calls require `targetRepo: azure-sdk-for-python`; `targetOwner` defaults to `Azure` unless explicitly provided (for example, a fork), so pass both explicitly when overriding defaults.\n- The CLI may supply repository defaults, but the MCP method does not.\n- `targetOwner`, `targetRepo`, and `targetBranch` define where the review PR branch is created.\n- Wait behavior mapping: `--no-wait` corresponds to `waitForCompletion: false`.\n- Poll behavior mapping: `--poll-interval-seconds` corresponds to `pollIntervalSeconds` (default `30`).\n- Optionally provide a ready-to-run `azsdk api-review create` command for the user with resolved values.\n\n## MCP Tools\n\n| Tool | Purpose |\n| ----------------------------------------------------- | ------------------------------- |\n| `azure-sdk-mcp:azsdk_apireviewhub_request_review_pr` | Create API review PR request |\n| `azure-sdk-mcp:azsdk_upgrade` | Check/upgrade MCP server version |\n\n## Steps\n\n1. **Collect Inputs** - Get required `packageName` and `targetBranch`. Optionally collect `baseTag`.\n2. **Prompt For Baseline** - If `baseTag` is not provided, ask the user to choose latest GA (non-beta) or provide a specific tag/version.\n3. **Resolve Baseline** - If the user chooses latest GA, resolve and use the latest GA (non-beta) release tag for `packageName`. If the user provides a tag/version, use that value.\n4. **Validate MCP Version** - Ensure `azure-sdk-mcp` is `0.6.32+`.\n5. **Set Wait Mode** - Default to wait for completion. Use `waitForCompletion: false` only when user asks for no-wait behavior.\n6. **Set Poll Interval** - If waiting for completion, use `pollIntervalSeconds` (default `30`, override only if requested).\n7. **Request Review PR** - Run `azure-sdk-mcp:azsdk_apireviewhub_request_review_pr` with `language: python`, `targetRepo: azure-sdk-for-python`, and `targetOwner` (default `Azure` unless explicitly provided), plus collected inputs.\n8. **Return Result** - Provide review PR URL and operation status.\n9. **Optional CLI Output** - If useful or requested, provide the equivalent `azsdk api-review create` command with all resolved arguments.\n\n## CLI Command Template\n\n```powershell\nazsdk api-review create `\n --language python `\n --package-name `\n --base-tag `\n --target-branch `\n --target-owner `\n --target-repo \n```\n\nOptional flags:\n\n- `--no-wait`\n- `--poll-interval-seconds 30`\n- `--output plain|json`\n\n## Example\n\nFor `azure-storage-blob` comparing `1.0.0` to the latest on main:\n\n- `packageName`: `azure-storage-blob`\n- `baseTag`: `azure-storage-blob_1.0.0`\n- `targetOwner`: `Azure`\n- `targetRepo`: `azure-sdk-for-python`\n- `targetBranch`: `main`\n\n## Troubleshooting\n\n- If tool is missing or unsupported, run `azure-sdk-mcp:azsdk_upgrade` with `checkOnly: true` to verify current version.\n- If `baseTag` is invalid, confirm the exact release tag name in the repository.\n- If `baseTag` is omitted, confirm the user's baseline choice before requesting the review PR.\n- If the generated review does not reflect expected changes, confirm `targetBranch` contains the intended newer API surface.\n",".github/skills/create-package-skill/SKILL.md":"---\nname: create-package-skill\ndescription: '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.'\n---\n\n# Create Package Skill Wizard\n\n> **Minimal beats comprehensive. Human-written beats auto-generated. Scaffold and iterate.**\n\n> Skills encode tribal knowledge — the \"I wish someone had told me\" stuff that's hard to learn from just reading code. Focus on what's non-obvious and package-specific.\n\n## Interaction Protocols\n\n**CONFIRM Protocol** (asset-producing steps — creating files):\n1. PRESENT the proposed assets and explain why.\n2. ASK exactly one question: \"Create now (recommended), edit first, or skip?\"\n3. ACT immediately. Create → write files this turn. Edit → refine, re-ask. Skip → move on.\n\n**DECIDE Protocol** (informational/correction steps — no files created):\n1. PRESENT the information or findings.\n2. ASK one specific question appropriate to the decision.\n3. PROCEED based on the answer.\n\nOne question at a time. Respect \"skip\" — never re-ask or defer.\n\n## Wizard Flow\n\nRun each phase in order. **Progressive loading:** Read only the current phase file.\n\n| Phase | Description | Instructions |\n|---|---|---|\n| **Phase 0** | 🧭 Scan Package — detect architecture, customizations, key files | [phases/00-scan-package.md](phases/00-scan-package.md) |\n| **Phase 1** | 📝 Scaffold SKILL.md — generate skill with step-by-step post-regen workflow (Option A) or reference-manual structure (Option B) | [phases/01-scaffold-skill.md](phases/01-scaffold-skill.md) |\n| **Phase 2** | 📚 Generate References — create customizations.md (required) and optionally architecture.md | [phases/02-generate-references.md](phases/02-generate-references.md) |\n| **Phase 3** | Validate -- run vally lint | [phases/03-validate.md](phases/03-validate.md) |\n| **Phase 4** | 📋 Finalize — confirm discoverable location, summarize | [phases/04-finalize.md](phases/04-finalize.md) |\n\n## Guardrails\n\n**Content:**\n- Every line must be non-obvious and package-specific. No generic Python/SDK boilerplate.\n- SKILL.md should be under 500 tokens (soft limit). Move details to references/.\n- References under 1000 tokens each. Split if larger.\n- Never duplicate repository-wide guidance from `AGENTS.md` or shared skills.\n\n**Relationship to existing SDK tools:**\n- Package skills **complement** the Azure SDK MCP tools (`azsdk_package_generate_code`, `azsdk_package_build_code`, `azsdk_customized_code_update`, etc.) — they do NOT replace them.\n- MCP tools handle deterministic operations (generate, build, test). Package skills provide the reasoning context an agent needs to use those tools correctly for a specific package, plus the package-specific verification commands the tools do not know about.\n- Reference the existing tools for the overall workflow (e.g., \"Run `tsp-client update` or `azsdk_package_generate_code`\"), but DO include the copy-pasteable verification commands an agent needs: import smoke tests (`python -c \"from ... import ...\"`), `ApiVersion` reconciliation (`grep`, `python -c \"import json; ...\"`), diff commands (`git diff --name-only | grep ...`), and the package validation invocation (`azsdk_package_run_check with checkType=\"All\"`).\n- Never paraphrase an MCP tool's entire contract. Do include the one-line invocations the agent will run.\n\n**Structure:**\n- Skill directory: `sdk///.github/skills//`\n- Directory name MUST match `name` field in frontmatter (vally lint enforces this).\n- `name` is the distribution package name, e.g. `azure-search-documents`, `azure-ai-projects`, `azure-mgmt-appconfiguration`.\n- Use semicolons to separate trigger phrases in description (YAML-safe).\n\n**Security:**\n- Never embed secrets or credentials in skill content.\n- Never instruct agents to bypass CI, pylint, mypy, pyright, or other gating tools.\n- Never instruct agents to edit files inside `_generated/` (or any file with the `\"Code generated by Microsoft (R) Python Code Generator\"` header) — always route through `_patch.py` or sibling hand-written modules.\n\n## Key Principles (from eval data)\n\nOur eval showed that skill **structure** matters more than **volume**:\n\n| Pattern | Impact |\n|---|---|\n| Numbered step-by-step post-regen workflow (Option A) | Agent executes verification top-to-bottom without inventing steps |\n| Copy-pasteable verification commands (import smoke tests, `ApiVersion` reconciliation, git diff of generated operations/models) | Agent actually runs the checks instead of guessing whether customizations still work |\n| \"Expose new generated methods through `_patch.py`\" step (mixin inheritance / override / polymorphic / create-or-update / list / `__all__` re-export) | Agent wires new generated operations into the public surface instead of leaving them unreachable |\n| \"Check `_patch.py` FIRST\" directives | Changes agent default from \"fix the error location\" to \"check the customization layer\" |\n| Per-file `Depends On` / `Defines` / `After Regeneration, Verify` inventory in `customizations.md` | Agent can pinpoint exactly which generated symbol a breakage maps to |\n| Generated-file detection guidance (directory OR header comment) | Agent correctly identifies auto-generated files under both `_generated/` and inline layouts |\n| Async parity checklist | Agent remembers to mirror sync changes into `aio/` |\n| CHANGELOG / README update step | Prevents \"silent\" releases that ship new operations without docs |\n\n## References (load on demand)\n\n- [references/skill-template.md](references/skill-template.md) -- SKILL.md template with required sections\n- [references/validation-tools.md](references/validation-tools.md) -- vally lint, CI workflow setup\n",".github/skills/azsdk-common-sdk-release/SKILL.md":"---\nname: azsdk-common-sdk-release\nlicense: MIT\nmetadata:\n version: \"1.0.0\"\n distribution: shared\ndescription: 'Check release readiness and trigger the release pipeline for Azure SDK packages. **UTILITY SKILL**. USE FOR: \"release SDK\", \"trigger release\", \"check release readiness\", \"release pipeline\", \"publish package\", \"ship SDK\". DO NOT USE FOR: SDK development, code generation, pipeline debugging, release plan creation. INVOKES: azure-sdk-mcp:azsdk_release_sdk.'\ncompatibility: \"azure-sdk-mcp server, SDK package merged on release branch. Supports .NET, Java, JavaScript, Python, Go\"\n---\n\n# SDK Release\n\nThis skill checks release readiness and triggers the Azure SDK release pipeline for packages that are already prepared, guiding the user through prerequisite validation, readiness review, and the final pipeline launch with required approval steps.\n\n## Triggers\n\nUSE FOR: release SDK, trigger release, check release readiness, release pipeline, publish package, ship SDK\nWHEN: \"release SDK\", \"trigger release\", \"check release readiness\", \"release pipeline\", \"publish package\", \"ship SDK\"\nDO NOT USE FOR: SDK development, code generation, pipeline debugging, release plan creation\n\n## Rules\n\n- Requires the `azure-sdk-mcp` server; there is no CLI fallback for the release workflow.\n- Collect `packageName` and `language`, then run the readiness check before attempting to trigger release.\n- If release is triggered, show the pipeline link and remind the user that the release stage still requires approval.\n\n## MCP Tools\n\n| Tool | Purpose |\n| --------------------------------- | ----------------------------------------------------------- |\n| `azure-sdk-mcp:azsdk_release_sdk` | Check release readiness and/or trigger the release pipeline |\n\n## Steps\n\n1. **Collect Info** — Get `packageName` and `language` from the user. Optionally get `branch` (defaults to main).\n2. **Determine Intent** — If the user explicitly asks to \"check readiness\" or \"check if ready\", run `azure-sdk-mcp:azsdk_release_sdk` with `checkReady: true`. Otherwise, proceed to trigger the release directly.\n3. **Trigger Release** — Run `azure-sdk-mcp:azsdk_release_sdk` with `checkReady: false` (the default). Show pipeline link and inform user they must approve the release stage.\n4. **Review Results** — If the release fails due to readiness issues, display failing checks and guide user to resolve.\n\n## Examples\n\n- \"Check if azure-storage-blob is ready for release\"\n- \"Trigger release for @azure/core-rest-pipeline on JavaScript\"\n\n## Troubleshooting\n\n- If readiness check fails, review each failing prerequisite individually before re-triggering.\n- Requires `azure-sdk-mcp` server. No CLI fallback — prompt user to configure MCP if unavailable.\n",".github/skills/find-package-skill/SKILL.md":"---\nname: find-package-skill\ndescription: '**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\".'\n---\n\n# Find Package Skill\n\nSome SDK packages in this monorepo have **package-specific skills** — tribal\nknowledge (architecture, data flows, type mappings, pitfalls) that prevents\ncommon mistakes. Before modifying any SDK package, check whether a skill exists\nfor it using the steps below.\n\n## How to Discover Package Skills\n\n1. **Determine the package directory.** If you already know the file path you're\n modifying, extract the package directory from it (e.g., a file at\n `sdk/search/azure-search-documents/azure/search/documents/_search_client.py`\n belongs to the package at `sdk/search/azure-search-documents/`). If you only\n have a package name, search for a matching directory under `sdk/` (package\n directories are named after the distribution package name, e.g.,\n `azure-search-documents` → `sdk/search/azure-search-documents/`).\n\n2. **Check for a `.github/skills/` directory** inside the package directory. For\n example, check whether `sdk/search/azure-search-documents/.github/skills/` exists.\n\n3. **If it exists**, read every `SKILL.md` found under that directory. If a\n `references/` subdirectory exists next to a `SKILL.md`, read all files in it\n too for additional context.\n\n4. **If no `.github/skills/` directory exists** for the package, no\n package-specific skill has been created yet — proceed normally.",".github/skills/fix-black/SKILL.md":"# fix-black\n\nPath: `.github/skills/fix-black/SKILL.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/.github/skills/fix-black/SKILL.md)",".github/skills/fix-mypy/SKILL.md":"# fix-mypy\n\nPath: `.github/skills/fix-mypy/SKILL.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/.github/skills/fix-mypy/SKILL.md)",".github/skills/fix-pylint/SKILL.md":"# fix-pylint\n\nPath: `.github/skills/fix-pylint/SKILL.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/.github/skills/fix-pylint/SKILL.md)",".github/skills/fix-sphinx/SKILL.md":"# fix-sphinx\n\nPath: `.github/skills/fix-sphinx/SKILL.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/.github/skills/fix-sphinx/SKILL.md)",".github/skills/generate-api-markdown/SKILL.md":"# generate-api-markdown\n\nPath: `.github/skills/generate-api-markdown/SKILL.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/.github/skills/generate-api-markdown/SKILL.md)",".github/skills/sdk-health/SKILL.md":"# sdk-health\n\nPath: `.github/skills/sdk-health/SKILL.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/.github/skills/sdk-health/SKILL.md)",".github/skills/create-package-skill/phases/01-scaffold-skill.md":"# Phases Skill\n\nPath: `.github/skills/create-package-skill/phases/01-scaffold-skill.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/.github/skills/create-package-skill/phases/01-scaffold-skill.md)",".github/skills/eng/next-version-update/SKILL.md":"# next-version-update\n\nPath: `.github/skills/eng/next-version-update/SKILL.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/.github/skills/eng/next-version-update/SKILL.md)",".github/skills/ml/do-code-review/SKILL.md":"# do-code-review\n\nPath: `.github/skills/ml/do-code-review/SKILL.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/.github/skills/ml/do-code-review/SKILL.md)",".github/skills/ml/fix-mypy/SKILL.md":"# fix-mypy\n\nPath: `.github/skills/ml/fix-mypy/SKILL.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/.github/skills/ml/fix-mypy/SKILL.md)",".github/skills/ml/fix-pylint/SKILL.md":"# fix-pylint\n\nPath: `.github/skills/ml/fix-pylint/SKILL.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/.github/skills/ml/fix-pylint/SKILL.md)","sdk/ai/azure-ai-projects/.github/skills/azure-ai-projects-author-samples/SKILL.md":"# azure-ai-projects-author-samples\n\nPath: `sdk/ai/azure-ai-projects/.github/skills/azure-ai-projects-author-samples/SKILL.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/sdk/ai/azure-ai-projects/.github/skills/azure-ai-projects-author-samples/SKILL.md)","sdk/ai/azure-ai-projects/.github/skills/azure-ai-projects-author-tests/SKILL.md":"# azure-ai-projects-author-tests\n\nPath: `sdk/ai/azure-ai-projects/.github/skills/azure-ai-projects-author-tests/SKILL.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/sdk/ai/azure-ai-projects/.github/skills/azure-ai-projects-author-tests/SKILL.md)","sdk/ai/azure-ai-projects/.github/skills/azure-ai-projects-emit-from-typespec/SKILL.md":"# azure-ai-projects-emit-from-typespec\n\nPath: `sdk/ai/azure-ai-projects/.github/skills/azure-ai-projects-emit-from-typespec/SKILL.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/sdk/ai/azure-ai-projects/.github/skills/azure-ai-projects-emit-from-typespec/SKILL.md)","sdk/ai/azure-ai-projects/.github/skills/azure-ai-projects-model-reference-graph/SKILL.md":"# azure-ai-projects-model-reference-graph\n\nPath: `sdk/ai/azure-ai-projects/.github/skills/azure-ai-projects-model-reference-graph/SKILL.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/sdk/ai/azure-ai-projects/.github/skills/azure-ai-projects-model-reference-graph/SKILL.md)","sdk/ai/azure-ai-projects/.github/skills/azure-ai-projects-run-issue-regeneration/SKILL.md":"# azure-ai-projects-run-issue-regeneration\n\nPath: `sdk/ai/azure-ai-projects/.github/skills/azure-ai-projects-run-issue-regeneration/SKILL.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/sdk/ai/azure-ai-projects/.github/skills/azure-ai-projects-run-issue-regeneration/SKILL.md)","sdk/ai/azure-ai-projects/.github/skills/azure-ai-projects-update-changelog/SKILL.md":"# azure-ai-projects-update-changelog\n\nPath: `sdk/ai/azure-ai-projects/.github/skills/azure-ai-projects-update-changelog/SKILL.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/sdk/ai/azure-ai-projects/.github/skills/azure-ai-projects-update-changelog/SKILL.md)","sdk/contentunderstanding/azure-ai-contentunderstanding/.github/skills/cu-sdk-author-analyzer-classify-route/SKILL.md":"# cu-sdk-author-analyzer-classify-route\n\nPath: `sdk/contentunderstanding/azure-ai-contentunderstanding/.github/skills/cu-sdk-author-analyzer-classify-route/SKILL.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/sdk/contentunderstanding/azure-ai-contentunderstanding/.github/skills/cu-sdk-author-analyzer-classify-route/SKILL.md)","sdk/contentunderstanding/azure-ai-contentunderstanding/.github/skills/cu-sdk-author-analyzer/SKILL.md":"# cu-sdk-author-analyzer\n\nPath: `sdk/contentunderstanding/azure-ai-contentunderstanding/.github/skills/cu-sdk-author-analyzer/SKILL.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/sdk/contentunderstanding/azure-ai-contentunderstanding/.github/skills/cu-sdk-author-analyzer/SKILL.md)","sdk/contentunderstanding/azure-ai-contentunderstanding/.github/skills/cu-sdk-common-knowledge/SKILL.md":"# cu-sdk-common-knowledge\n\nPath: `sdk/contentunderstanding/azure-ai-contentunderstanding/.github/skills/cu-sdk-common-knowledge/SKILL.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/sdk/contentunderstanding/azure-ai-contentunderstanding/.github/skills/cu-sdk-common-knowledge/SKILL.md)","sdk/contentunderstanding/azure-ai-contentunderstanding/.github/skills/cu-sdk-sample-run/SKILL.md":"# cu-sdk-sample-run\n\nPath: `sdk/contentunderstanding/azure-ai-contentunderstanding/.github/skills/cu-sdk-sample-run/SKILL.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/sdk/contentunderstanding/azure-ai-contentunderstanding/.github/skills/cu-sdk-sample-run/SKILL.md)","sdk/contentunderstanding/azure-ai-contentunderstanding/.github/skills/cu-sdk-setup/SKILL.md":"# cu-sdk-setup\n\nPath: `sdk/contentunderstanding/azure-ai-contentunderstanding/.github/skills/cu-sdk-setup/SKILL.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/sdk/contentunderstanding/azure-ai-contentunderstanding/.github/skills/cu-sdk-setup/SKILL.md)","sdk/ai/azure-ai-projects/samples/skills/assets/canvas-design/SKILL.md":"# canvas-design\n\nPath: `sdk/ai/azure-ai-projects/samples/skills/assets/canvas-design/SKILL.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/sdk/ai/azure-ai-projects/samples/skills/assets/canvas-design/SKILL.md)","sdk/ai/azure-ai-projects/samples/skills/assets/team-status-update/SKILL.md":"# team-status-update\n\nPath: `sdk/ai/azure-ai-projects/samples/skills/assets/team-status-update/SKILL.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/sdk/ai/azure-ai-projects/samples/skills/assets/team-status-update/SKILL.md)","AGENTS.md":"# AI Agent Protocol & Instructions\n\nPath: `AGENTS.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/AGENTS.md)",".github/copilot-instructions.md":"# GitHub Copilot Instructions\n\nPath: `.github/copilot-instructions.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/.github/copilot-instructions.md)",".vscode/mcp.json":"# Model Context Protocol (MCP) Configuration\n\nPath: `.vscode/mcp.json`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/.vscode/mcp.json)",".github/agents/agentic-workflows.md":"# Subagent: agentic-workflows\n\nPath: `.github/agents/agentic-workflows.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/.github/agents/agentic-workflows.md)","scripts/old_packages/README.md":"# old_packages Documentation\n\nPath: `scripts/old_packages/README.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/scripts/old_packages/README.md)","eng/tools/azure-sdk-tools/README.md":"# azure-sdk-tools Documentation\n\nPath: `eng/tools/azure-sdk-tools/README.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/eng/tools/azure-sdk-tools/README.md)","eng/tools/azure-sdk-tools/changelog_generics.md":"# Azure-sdk-tools Skill\n\nPath: `eng/tools/azure-sdk-tools/changelog_generics.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/eng/tools/azure-sdk-tools/changelog_generics.md)","sdk/kubernetesconfiguration/azure-mgmt-kubernetesconfiguration-extensions/README.md":"# azure-mgmt-kubernetesconfiguration-extensions Documentation\n\nPath: `sdk/kubernetesconfiguration/azure-mgmt-kubernetesconfiguration-extensions/README.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/sdk/kubernetesconfiguration/azure-mgmt-kubernetesconfiguration-extensions/README.md)",".github/skills/azsdk-common-apiview-feedback-resolution/evals/eval.yaml":"# Evals Skill\n\nPath: `.github/skills/azsdk-common-apiview-feedback-resolution/evals/eval.yaml`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/.github/skills/azsdk-common-apiview-feedback-resolution/evals/eval.yaml)",".github/skills/azsdk-common-apiview-feedback-resolution/evals/trigger.eval.yaml":"# Evals Skill\n\nPath: `.github/skills/azsdk-common-apiview-feedback-resolution/evals/trigger.eval.yaml`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/.github/skills/azsdk-common-apiview-feedback-resolution/evals/trigger.eval.yaml)",".github/skills/azsdk-common-apiview-feedback-resolution/fixtures/apiview-comment.json":"# Fixtures Skill\n\nPath: `.github/skills/azsdk-common-apiview-feedback-resolution/fixtures/apiview-comment.json`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/.github/skills/azsdk-common-apiview-feedback-resolution/fixtures/apiview-comment.json)",".github/skills/azsdk-common-apiview-feedback-resolution/references/feedback-resolution-steps.md":"# References Skill\n\nPath: `.github/skills/azsdk-common-apiview-feedback-resolution/references/feedback-resolution-steps.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/.github/skills/azsdk-common-apiview-feedback-resolution/references/feedback-resolution-steps.md)",".github/skills/azsdk-common-generate-sdk-locally/evals/eval.yaml":"# Evals Skill\n\nPath: `.github/skills/azsdk-common-generate-sdk-locally/evals/eval.yaml`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/.github/skills/azsdk-common-generate-sdk-locally/evals/eval.yaml)",".github/skills/azsdk-common-generate-sdk-locally/evals/trigger.eval.yaml":"# Evals Skill\n\nPath: `.github/skills/azsdk-common-generate-sdk-locally/evals/trigger.eval.yaml`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/.github/skills/azsdk-common-generate-sdk-locally/evals/trigger.eval.yaml)",".github/skills/azsdk-common-generate-sdk-locally/fixtures/tspconfig.yaml":"# Fixtures Skill\n\nPath: `.github/skills/azsdk-common-generate-sdk-locally/fixtures/tspconfig.yaml`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/.github/skills/azsdk-common-generate-sdk-locally/fixtures/tspconfig.yaml)",".github/skills/azsdk-common-generate-sdk-locally/references/customization-workflow.md":"# References Skill\n\nPath: `.github/skills/azsdk-common-generate-sdk-locally/references/customization-workflow.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/.github/skills/azsdk-common-generate-sdk-locally/references/customization-workflow.md)",".github/skills/azsdk-common-generate-sdk-locally/references/detailed-workflow.md":"# References Skill\n\nPath: `.github/skills/azsdk-common-generate-sdk-locally/references/detailed-workflow.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/.github/skills/azsdk-common-generate-sdk-locally/references/detailed-workflow.md)",".github/skills/azsdk-common-generate-sdk-locally/references/sdk-repos.md":"# References Skill\n\nPath: `.github/skills/azsdk-common-generate-sdk-locally/references/sdk-repos.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/.github/skills/azsdk-common-generate-sdk-locally/references/sdk-repos.md)",".github/skills/azsdk-common-pipeline-analysis/evals/trigger.eval.yaml":"# Evals Skill\n\nPath: `.github/skills/azsdk-common-pipeline-analysis/evals/trigger.eval.yaml`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/.github/skills/azsdk-common-pipeline-analysis/evals/trigger.eval.yaml)",".github/skills/azsdk-common-pipeline-analysis/references/failure-patterns.md":"# References Skill\n\nPath: `.github/skills/azsdk-common-pipeline-analysis/references/failure-patterns.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/.github/skills/azsdk-common-pipeline-analysis/references/failure-patterns.md)",".github/skills/azsdk-common-pipeline-analysis/references/output-format.md":"# References Skill\n\nPath: `.github/skills/azsdk-common-pipeline-analysis/references/output-format.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/.github/skills/azsdk-common-pipeline-analysis/references/output-format.md)",".github/skills/azsdk-common-pipeline-fixer/evals/trigger.eval.yaml":"# Evals Skill\n\nPath: `.github/skills/azsdk-common-pipeline-fixer/evals/trigger.eval.yaml`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/.github/skills/azsdk-common-pipeline-fixer/evals/trigger.eval.yaml)",".github/skills/azsdk-common-prepare-release-plan/evals/eval.yaml":"# Evals Skill\n\nPath: `.github/skills/azsdk-common-prepare-release-plan/evals/eval.yaml`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/.github/skills/azsdk-common-prepare-release-plan/evals/eval.yaml)",".github/skills/azsdk-common-prepare-release-plan/evals/schedule-risk.eval.yaml":"# Evals Skill\n\nPath: `.github/skills/azsdk-common-prepare-release-plan/evals/schedule-risk.eval.yaml`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/.github/skills/azsdk-common-prepare-release-plan/evals/schedule-risk.eval.yaml)",".github/skills/azsdk-common-prepare-release-plan/evals/trigger.eval.yaml":"# Evals Skill\n\nPath: `.github/skills/azsdk-common-prepare-release-plan/evals/trigger.eval.yaml`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/.github/skills/azsdk-common-prepare-release-plan/evals/trigger.eval.yaml)",".github/skills/azsdk-common-prepare-release-plan/fixtures/tspconfig.yaml":"# Fixtures Skill\n\nPath: `.github/skills/azsdk-common-prepare-release-plan/fixtures/tspconfig.yaml`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/.github/skills/azsdk-common-prepare-release-plan/fixtures/tspconfig.yaml)",".github/skills/azsdk-common-prepare-release-plan/references/release-plan-details.md":"# References Skill\n\nPath: `.github/skills/azsdk-common-prepare-release-plan/references/release-plan-details.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/.github/skills/azsdk-common-prepare-release-plan/references/release-plan-details.md)",".github/skills/azsdk-common-sdk-breaking-change/evals/eval.yaml":"# Evals Skill\n\nPath: `.github/skills/azsdk-common-sdk-breaking-change/evals/eval.yaml`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/.github/skills/azsdk-common-sdk-breaking-change/evals/eval.yaml)",".github/skills/azsdk-common-sdk-breaking-change/evals/trigger.eval.yaml":"# Evals Skill\n\nPath: `.github/skills/azsdk-common-sdk-breaking-change/evals/trigger.eval.yaml`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/.github/skills/azsdk-common-sdk-breaking-change/evals/trigger.eval.yaml)",".github/skills/azsdk-common-sdk-release/evals/eval.yaml":"# Evals Skill\n\nPath: `.github/skills/azsdk-common-sdk-release/evals/eval.yaml`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/.github/skills/azsdk-common-sdk-release/evals/eval.yaml)",".github/skills/azsdk-common-sdk-release/evals/trigger.eval.yaml":"# Evals Skill\n\nPath: `.github/skills/azsdk-common-sdk-release/evals/trigger.eval.yaml`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/.github/skills/azsdk-common-sdk-release/evals/trigger.eval.yaml)",".github/skills/code-review/evals/trigger.eval.yaml":"# Evals Skill\n\nPath: `.github/skills/code-review/evals/trigger.eval.yaml`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/.github/skills/code-review/evals/trigger.eval.yaml)",".github/skills/create-package-skill/phases/00-scan-package.md":"# Phases Skill\n\nPath: `.github/skills/create-package-skill/phases/00-scan-package.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/.github/skills/create-package-skill/phases/00-scan-package.md)",".github/skills/create-package-skill/phases/02-generate-references.md":"# Phases Skill\n\nPath: `.github/skills/create-package-skill/phases/02-generate-references.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/.github/skills/create-package-skill/phases/02-generate-references.md)",".github/skills/create-package-skill/phases/03-validate.md":"# Phases Skill\n\nPath: `.github/skills/create-package-skill/phases/03-validate.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/.github/skills/create-package-skill/phases/03-validate.md)",".github/skills/create-package-skill/phases/04-finalize.md":"# Phases Skill\n\nPath: `.github/skills/create-package-skill/phases/04-finalize.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/.github/skills/create-package-skill/phases/04-finalize.md)",".github/skills/create-package-skill/references/skill-template.md":"# References Skill\n\nPath: `.github/skills/create-package-skill/references/skill-template.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/.github/skills/create-package-skill/references/skill-template.md)",".github/skills/create-package-skill/references/validation-tools.md":"# References Skill\n\nPath: `.github/skills/create-package-skill/references/validation-tools.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/.github/skills/create-package-skill/references/validation-tools.md)",".github/skills/sdk-health/evals/trigger.eval.yaml":"# Evals Skill\n\nPath: `.github/skills/sdk-health/evals/trigger.eval.yaml`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/.github/skills/sdk-health/evals/trigger.eval.yaml)","eng/tools/azure-sdk-tools/devtools_testutils/README.md":"# devtools_testutils Documentation\n\nPath: `eng/tools/azure-sdk-tools/devtools_testutils/README.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/eng/tools/azure-sdk-tools/devtools_testutils/README.md)","eng/tools/azure-sdk-tools/tests/data/azure-mgmt-containerservice-41.4.0b1-CHANGELOG.md":"# Data Skill\n\nPath: `eng/tools/azure-sdk-tools/tests/data/azure-mgmt-containerservice-41.4.0b1-CHANGELOG.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/eng/tools/azure-sdk-tools/tests/data/azure-mgmt-containerservice-41.4.0b1-CHANGELOG.md)","eng/tools/azure-sdk-tools/tests/data/azure-mgmt-containerservice-41.4.0b1-CHANGELOG.trimmed.md":"# Data Skill\n\nPath: `eng/tools/azure-sdk-tools/tests/data/azure-mgmt-containerservice-41.4.0b1-CHANGELOG.trimmed.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/eng/tools/azure-sdk-tools/tests/data/azure-mgmt-containerservice-41.4.0b1-CHANGELOG.trimmed.md)","eng/tools/azure-sdk-tools/tests/data/azure-mgmt-cosmosdb-10.0.0b6-CHANGELOG.md":"# Data Skill\n\nPath: `eng/tools/azure-sdk-tools/tests/data/azure-mgmt-cosmosdb-10.0.0b6-CHANGELOG.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/eng/tools/azure-sdk-tools/tests/data/azure-mgmt-cosmosdb-10.0.0b6-CHANGELOG.md)","eng/tools/azure-sdk-tools/tests/data/azure-mgmt-cosmosdb-10.0.0b6-CHANGELOG.trimmed.md":"# Data Skill\n\nPath: `eng/tools/azure-sdk-tools/tests/data/azure-mgmt-cosmosdb-10.0.0b6-CHANGELOG.trimmed.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/eng/tools/azure-sdk-tools/tests/data/azure-mgmt-cosmosdb-10.0.0b6-CHANGELOG.trimmed.md)","eng/tools/azure-sdk-tools/tests/data/azure-mgmt-datafactory-10.0.0b1-CHANGELOG.md":"# Data Skill\n\nPath: `eng/tools/azure-sdk-tools/tests/data/azure-mgmt-datafactory-10.0.0b1-CHANGELOG.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/eng/tools/azure-sdk-tools/tests/data/azure-mgmt-datafactory-10.0.0b1-CHANGELOG.md)","eng/tools/azure-sdk-tools/tests/data/azure-mgmt-datafactory-10.0.0b1-CHANGELOG.trimmed.md":"# Data Skill\n\nPath: `eng/tools/azure-sdk-tools/tests/data/azure-mgmt-datafactory-10.0.0b1-CHANGELOG.trimmed.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/eng/tools/azure-sdk-tools/tests/data/azure-mgmt-datafactory-10.0.0b1-CHANGELOG.trimmed.md)","eng/tools/azure-sdk-tools/tests/data/azure-mgmt-network-31.0.0-CHANGELOG.md":"# Data Skill\n\nPath: `eng/tools/azure-sdk-tools/tests/data/azure-mgmt-network-31.0.0-CHANGELOG.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/eng/tools/azure-sdk-tools/tests/data/azure-mgmt-network-31.0.0-CHANGELOG.md)","eng/tools/azure-sdk-tools/tests/data/azure-mgmt-network-31.0.0-CHANGELOG.trimmed.md":"# Data Skill\n\nPath: `eng/tools/azure-sdk-tools/tests/data/azure-mgmt-network-31.0.0-CHANGELOG.trimmed.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/eng/tools/azure-sdk-tools/tests/data/azure-mgmt-network-31.0.0-CHANGELOG.trimmed.md)","eng/tools/azure-sdk-tools/tests/data/azure-mgmt-sql-4.0.0-CHANGELOG.md":"# Data Skill\n\nPath: `eng/tools/azure-sdk-tools/tests/data/azure-mgmt-sql-4.0.0-CHANGELOG.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/eng/tools/azure-sdk-tools/tests/data/azure-mgmt-sql-4.0.0-CHANGELOG.md)","eng/tools/azure-sdk-tools/tests/data/azure-mgmt-sql-4.0.0-CHANGELOG.trimmed.md":"# Data Skill\n\nPath: `eng/tools/azure-sdk-tools/tests/data/azure-mgmt-sql-4.0.0-CHANGELOG.trimmed.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/eng/tools/azure-sdk-tools/tests/data/azure-mgmt-sql-4.0.0-CHANGELOG.trimmed.md)","eng/tools/azure-sdk-tools/tests/integration/README.md":"# integration Documentation\n\nPath: `eng/tools/azure-sdk-tools/tests/integration/README.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/eng/tools/azure-sdk-tools/tests/integration/README.md)","sdk/ai/azure-ai-projects/.github/skills/README.md":"# Skills Skill\n\nPath: `sdk/ai/azure-ai-projects/.github/skills/README.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/sdk/ai/azure-ai-projects/.github/skills/README.md)","eng/tools/azure-sdk-tools/devtools_testutils/perfstress_tests/system_perfstress/README.md":"# system_perfstress Documentation\n\nPath: `eng/tools/azure-sdk-tools/devtools_testutils/perfstress_tests/system_perfstress/README.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/eng/tools/azure-sdk-tools/devtools_testutils/perfstress_tests/system_perfstress/README.md)","eng/tools/azure-sdk-tools/packaging_tools/templates/packaging_files/CHANGELOG.md":"# Packaging_files Skill\n\nPath: `eng/tools/azure-sdk-tools/packaging_tools/templates/packaging_files/CHANGELOG.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/eng/tools/azure-sdk-tools/packaging_tools/templates/packaging_files/CHANGELOG.md)","eng/tools/azure-sdk-tools/packaging_tools/templates/packaging_files/README.md":"# packaging_files Documentation\n\nPath: `eng/tools/azure-sdk-tools/packaging_tools/templates/packaging_files/README.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/eng/tools/azure-sdk-tools/packaging_tools/templates/packaging_files/README.md)","sdk/ai/azure-ai-projects/samples/agents/assets/product_info.md":"# Subagent: product_info\n\nPath: `sdk/ai/azure-ai-projects/samples/agents/assets/product_info.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/sdk/ai/azure-ai-projects/samples/agents/assets/product_info.md)","sdk/ai/azure-ai-projects/samples/agents/assets/tripadvisor_openapi.json":"# Assets Skill\n\nPath: `sdk/ai/azure-ai-projects/samples/agents/assets/tripadvisor_openapi.json`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/sdk/ai/azure-ai-projects/samples/agents/assets/tripadvisor_openapi.json)","sdk/ai/azure-ai-projects/samples/agents/assets/weather_openapi.json":"# Assets Skill\n\nPath: `sdk/ai/azure-ai-projects/samples/agents/assets/weather_openapi.json`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/sdk/ai/azure-ai-projects/samples/agents/assets/weather_openapi.json)","sdk/contentunderstanding/azure-ai-contentunderstanding/.github/skills/_shared/README.md":"# _shared Skill\n\nPath: `sdk/contentunderstanding/azure-ai-contentunderstanding/.github/skills/_shared/README.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/sdk/contentunderstanding/azure-ai-contentunderstanding/.github/skills/_shared/README.md)","eng/tools/azure-sdk-tools/tests/integration/scenarios/dev_requirement_samples/README.md":"# dev_requirement_samples Documentation\n\nPath: `eng/tools/azure-sdk-tools/tests/integration/scenarios/dev_requirement_samples/README.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/eng/tools/azure-sdk-tools/tests/integration/scenarios/dev_requirement_samples/README.md)","eng/tools/azure-sdk-tools/tests/integration/scenarios/optional_environment_two_options/README.md":"# optional_environment_two_options Documentation\n\nPath: `eng/tools/azure-sdk-tools/tests/integration/scenarios/optional_environment_two_options/README.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/eng/tools/azure-sdk-tools/tests/integration/scenarios/optional_environment_two_options/README.md)","eng/tools/azure-sdk-tools/tests/integration/scenarios/optional_environment_zero_options/README.md":"# optional_environment_zero_options Documentation\n\nPath: `eng/tools/azure-sdk-tools/tests/integration/scenarios/optional_environment_zero_options/README.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/eng/tools/azure-sdk-tools/tests/integration/scenarios/optional_environment_zero_options/README.md)","eng/tools/azure-sdk-tools/tests/integration/scenarios/pyproject_beta_invalid_metadata/README.md":"# pyproject_beta_invalid_metadata Documentation\n\nPath: `eng/tools/azure-sdk-tools/tests/integration/scenarios/pyproject_beta_invalid_metadata/README.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/eng/tools/azure-sdk-tools/tests/integration/scenarios/pyproject_beta_invalid_metadata/README.md)","eng/tools/azure-sdk-tools/tests/integration/scenarios/pyproject_beta_metadata/README.md":"# pyproject_beta_metadata Documentation\n\nPath: `eng/tools/azure-sdk-tools/tests/integration/scenarios/pyproject_beta_metadata/README.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/eng/tools/azure-sdk-tools/tests/integration/scenarios/pyproject_beta_metadata/README.md)","eng/tools/azure-sdk-tools/tests/integration/scenarios/pyproject_build_config/README.md":"# pyproject_build_config Documentation\n\nPath: `eng/tools/azure-sdk-tools/tests/integration/scenarios/pyproject_build_config/README.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/eng/tools/azure-sdk-tools/tests/integration/scenarios/pyproject_build_config/README.md)","eng/tools/azure-sdk-tools/tests/integration/scenarios/pyproject_invalid_metadata/README.md":"# pyproject_invalid_metadata Documentation\n\nPath: `eng/tools/azure-sdk-tools/tests/integration/scenarios/pyproject_invalid_metadata/README.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/eng/tools/azure-sdk-tools/tests/integration/scenarios/pyproject_invalid_metadata/README.md)","eng/tools/azure-sdk-tools/tests/integration/scenarios/pyproject_metadata/README.md":"# pyproject_metadata Documentation\n\nPath: `eng/tools/azure-sdk-tools/tests/integration/scenarios/pyproject_metadata/README.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/eng/tools/azure-sdk-tools/tests/integration/scenarios/pyproject_metadata/README.md)","eng/tools/azure-sdk-tools/tests/integration/scenarios/pyproject_project_def/README.md":"# pyproject_project_def Documentation\n\nPath: `eng/tools/azure-sdk-tools/tests/integration/scenarios/pyproject_project_def/README.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/eng/tools/azure-sdk-tools/tests/integration/scenarios/pyproject_project_def/README.md)","eng/tools/azure-sdk-tools/tests/integration/scenarios/pyproject_project_def_beta/README.md":"# pyproject_project_def_beta Documentation\n\nPath: `eng/tools/azure-sdk-tools/tests/integration/scenarios/pyproject_project_def_beta/README.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/eng/tools/azure-sdk-tools/tests/integration/scenarios/pyproject_project_def_beta/README.md)","eng/tools/azure-sdk-tools/tests/integration/scenarios/pyproject_project_def_with_extension/README.md":"# pyproject_project_def_with_extension Documentation\n\nPath: `eng/tools/azure-sdk-tools/tests/integration/scenarios/pyproject_project_def_with_extension/README.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/eng/tools/azure-sdk-tools/tests/integration/scenarios/pyproject_project_def_with_extension/README.md)","eng/tools/azure-sdk-tools/tests/integration/scenarios/setup_py_metapackage/README.md":"# setup_py_metapackage Documentation\n\nPath: `eng/tools/azure-sdk-tools/tests/integration/scenarios/setup_py_metapackage/README.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/eng/tools/azure-sdk-tools/tests/integration/scenarios/setup_py_metapackage/README.md)","eng/tools/azure-sdk-tools/tests/integration/scenarios/setup_py_project_def/README.md":"# setup_py_project_def Documentation\n\nPath: `eng/tools/azure-sdk-tools/tests/integration/scenarios/setup_py_project_def/README.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/eng/tools/azure-sdk-tools/tests/integration/scenarios/setup_py_project_def/README.md)","eng/tools/azure-sdk-tools/tests/integration/scenarios/snippet-updater/README.md":"# snippet-updater Documentation\n\nPath: `eng/tools/azure-sdk-tools/tests/integration/scenarios/snippet-updater/README.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/eng/tools/azure-sdk-tools/tests/integration/scenarios/snippet-updater/README.md)","eng/tools/azure-sdk-tools/tests/integration/scenarios/snippet-updater/README_missing_snippet.md":"# Snippet-updater Skill\n\nPath: `eng/tools/azure-sdk-tools/tests/integration/scenarios/snippet-updater/README_missing_snippet.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/eng/tools/azure-sdk-tools/tests/integration/scenarios/snippet-updater/README_missing_snippet.md)","eng/tools/azure-sdk-tools/tests/integration/scenarios/snippet-updater/README_out_of_sync.md":"# Snippet-updater Skill\n\nPath: `eng/tools/azure-sdk-tools/tests/integration/scenarios/snippet-updater/README_out_of_sync.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/eng/tools/azure-sdk-tools/tests/integration/scenarios/snippet-updater/README_out_of_sync.md)","sdk/ai/azure-ai-projects/.github/skills/azure-ai-projects-author-samples/prompts/diff-api-surface.prompt.md":"# Prompts Skill\n\nPath: `sdk/ai/azure-ai-projects/.github/skills/azure-ai-projects-author-samples/prompts/diff-api-surface.prompt.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/sdk/ai/azure-ai-projects/.github/skills/azure-ai-projects-author-samples/prompts/diff-api-surface.prompt.md)","sdk/ai/azure-ai-projects/.github/skills/azure-ai-projects-author-samples/references/sample-conventions.md":"# References Skill\n\nPath: `sdk/ai/azure-ai-projects/.github/skills/azure-ai-projects-author-samples/references/sample-conventions.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/sdk/ai/azure-ai-projects/.github/skills/azure-ai-projects-author-samples/references/sample-conventions.md)","sdk/ai/azure-ai-projects/.github/skills/azure-ai-projects-author-tests/references/test-conventions.md":"# References Skill\n\nPath: `sdk/ai/azure-ai-projects/.github/skills/azure-ai-projects-author-tests/references/test-conventions.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/sdk/ai/azure-ai-projects/.github/skills/azure-ai-projects-author-tests/references/test-conventions.md)","sdk/ai/azure-ai-projects/samples/skills/assets/team-status-update/status-update-template.md":"# Team-status-update Skill\n\nPath: `sdk/ai/azure-ai-projects/samples/skills/assets/team-status-update/status-update-template.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/sdk/ai/azure-ai-projects/samples/skills/assets/team-status-update/status-update-template.md)","sdk/contentunderstanding/azure-ai-contentunderstanding/.github/skills/cu-sdk-author-analyzer-classify-route/templates/classifier_template.json":"# Templates Skill\n\nPath: `sdk/contentunderstanding/azure-ai-contentunderstanding/.github/skills/cu-sdk-author-analyzer-classify-route/templates/classifier_template.json`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/sdk/contentunderstanding/azure-ai-contentunderstanding/.github/skills/cu-sdk-author-analyzer-classify-route/templates/classifier_template.json)","sdk/contentunderstanding/azure-ai-contentunderstanding/.github/skills/cu-sdk-author-analyzer/scripts/README.md":"# Scripts Skill\n\nPath: `sdk/contentunderstanding/azure-ai-contentunderstanding/.github/skills/cu-sdk-author-analyzer/scripts/README.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/sdk/contentunderstanding/azure-ai-contentunderstanding/.github/skills/cu-sdk-author-analyzer/scripts/README.md)","sdk/contentunderstanding/azure-ai-contentunderstanding/.github/skills/cu-sdk-author-analyzer/templates/schema_template.json":"# Templates Skill\n\nPath: `sdk/contentunderstanding/azure-ai-contentunderstanding/.github/skills/cu-sdk-author-analyzer/templates/schema_template.json`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/sdk/contentunderstanding/azure-ai-contentunderstanding/.github/skills/cu-sdk-author-analyzer/templates/schema_template.json)"},"items":[{"name":"AGENTS.md","path":"AGENTS.md","rawUrl":"https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/AGENTS.md","title":"AI Agent Protocol & Instructions","category":"root-instruction","format":"markdown","content":"# AI Agent Protocol & Instructions\n\nPath: `AGENTS.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/AGENTS.md)","tokens":300,"sizeBytes":160},{"name":"SKILL.md","path":".github/skills/agentic-workflows/SKILL.md","rawUrl":"https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/.github/skills/agentic-workflows/SKILL.md","title":"agentic-workflows","category":"anthropic-skill","format":"markdown","content":"---\nname: agentic-workflows\ndescription: Route gh-aw workflow design/create/debug/upgrade requests to the right prompts.\n---\n\n# Agentic Workflows Router\n\nUse this skill when a user asks to design, create, update, debug, or upgrade GitHub Agentic Workflows in this repository.\n\nThis skill is a dispatcher: identify the task type, load the matching workflow prompt/skill file, and follow it directly. Keep responses concise and ask a clarifying question if the correct prompt is unclear.\n\nRepository overlay (optional):\n- If `.github/aw/instructions.md` exists, load it with `@.github/aw/instructions.md` after loading the matched prompt/skill.\n- Precedence: repository overlay instructions override upstream defaults when they conflict.\n\nRead only the files you need:\nLoad these files from `github/gh-aw` (they are not available locally).\n- `.github/aw/action-container-substitutions.md`\n- `.github/aw/agent-runtime-instructions.md`\n- `.github/aw/agentic-chat.md`\n- `.github/aw/agentic-workflows-mcp.md`\n- `.github/aw/asciicharts.md`\n- `.github/aw/campaign.md`\n- `.github/aw/charts-trending.md`\n- `.github/aw/charts.md`\n- `.github/aw/cli-commands.md`\n- `.github/aw/compat.md`\n- `.github/aw/configure-agentic-engine.md`\n- `.github/aw/context.md`\n- `.github/aw/create-agentic-workflow-trigger-details.md`\n- `.github/aw/create-agentic-workflow.md`\n- `.github/aw/create-shared-agentic-workflow.md`\n- `.github/aw/debug-agentic-workflow.md`\n- `.github/aw/dependabot.md`\n- `.github/aw/deployment-status.md`\n- `.github/aw/designer-mappings.md`\n- `.github/aw/designer.md`\n- `.github/aw/drive-memory.md`\n- `.github/aw/enclaves.md`\n- `.github/aw/evals.md`\n- `.github/aw/experiments.md`\n- `.github/aw/github-agentic-workflows.md`\n- `.github/aw/github-mcp-server-pagination.md`\n- `.github/aw/github-mcp-server-tools.md`\n- `.github/aw/github-mcp-server.md`\n- `.github/aw/instructions.md`\n- `.github/aw/intent.md`\n- `.github/aw/jobs.md`\n- `.github/aw/linter-workflows.md`\n- `.github/aw/llms.md`\n- `.github/aw/loop.md`\n- `.github/aw/lsp.md`\n- `.github/aw/maintainer.md`\n- `.github/aw/mcp-clis.md`\n- `.github/aw/memory-stateful-patterns.md`\n- `.github/aw/memory.md`\n- `.github/aw/messages.md`\n- `.github/aw/multi-agent-research.md`\n- `.github/aw/network.md`\n- `.github/aw/optimize-agentic-workflow.md`\n- `.github/aw/patterns.md`\n- `.github/aw/playwright.md`\n- `.github/aw/pr-reviewer.md`\n- `.github/aw/release-workflow.md`\n- `.github/aw/report.md`\n- `.github/aw/reuse.md`\n- `.github/aw/safe-outputs-automation.md`\n- `.github/aw/safe-outputs-content.md`\n- `.github/aw/safe-outputs-management.md`\n- `.github/aw/safe-outputs-runtime.md`\n- `.github/aw/safe-outputs.md`\n- `.github/aw/serena-tool.md`\n- `.github/aw/shared-safe-jobs.md`\n- `.github/aw/skills.md`\n- `.github/aw/subagents.md`\n- `.github/aw/syntax-agentic.md`\n- `.github/aw/syntax-core.md`\n- `.github/aw/syntax-engine.md`\n- `.github/aw/syntax-tools-imports.md`\n- `.github/aw/syntax.md`\n- `.github/aw/test-coverage.md`\n- `.github/aw/test-expression.md`\n- `.github/aw/token-optimization-caching-budgets.md`\n- `.github/aw/token-optimization-observability.md`\n- `.github/aw/token-optimization.md`\n- `.github/aw/triggers.md`\n- `.github/aw/update-agentic-workflow.md`\n- `.github/aw/upgrade-agentic-workflows.md`\n- `.github/aw/visual-regression.md`\n- `.github/aw/workflow-constraints.md`\n- `.github/aw/workflow-editing.md`\n- `.github/aw/workflow-patterns.md`\n\nAfter loading the matching workflow prompt or skill, follow it directly:\n- Design workflows from scratch via interview: `.github/aw/designer.md`\n- Create new workflows: `.github/aw/create-agentic-workflow.md`\n- Configure or add declarative engines: `.github/aw/configure-agentic-engine.md`\n- Update existing workflows: `.github/aw/update-agentic-workflow.md`\n- Debug, audit, or investigate workflows: `.github/aw/debug-agentic-workflow.md`\n- Upgrade workflows and fix deprecations: `.github/aw/upgrade-agentic-workflows.md`\n- Create shared components or MCP wrappers: `.github/aw/create-shared-agentic-workflow.md`\n- Create report-generating workflows: `.github/aw/report.md`\n- Fix Dependabot manifest PRs: `.github/aw/dependabot.md`\n- Analyze coverage workflows: `.github/aw/test-coverage.md`\n- Render compact markdown charts: `.github/aw/asciicharts.md`\n- Map CLI commands to MCP usage: `.github/aw/cli-commands.md`\n- Choose workflow architecture and patterns: `.github/aw/patterns.md`\n- Optimize token usage and cost: `.github/aw/token-optimization.md`\n- Design long-running multi-agent research workflows: `.github/aw/multi-agent-research.md`\n- Add skills or agent plugins requested by the user (`skills:` / `plugins:` frontmatter, never on-the-fly installs): `.github/aw/skills.md`\n\nWhen the task involves OTEL, OTLP, traces, observability backends, or telemetry-driven analysis, also read and follow `skills/otel-queries/SKILL.md` after loading the matching workflow prompt or skill.\n","frontmatter":{"name":"agentic-workflows","description":"Route gh-aw workflow design/create/debug/upgrade requests to the right prompts."},"isInternal":false,"tokens":1334,"sizeBytes":4881},{"name":"eval.yaml","path":".github/skills/azsdk-common-apiview-feedback-resolution/evals/eval.yaml","rawUrl":"https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/.github/skills/azsdk-common-apiview-feedback-resolution/evals/eval.yaml","title":"Evals Skill","category":"anthropic-skill","format":"yaml","content":"# Evals Skill\n\nPath: `.github/skills/azsdk-common-apiview-feedback-resolution/evals/eval.yaml`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/.github/skills/azsdk-common-apiview-feedback-resolution/evals/eval.yaml)","tokens":300,"sizeBytes":263},{"name":"trigger.eval.yaml","path":".github/skills/azsdk-common-apiview-feedback-resolution/evals/trigger.eval.yaml","rawUrl":"https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/.github/skills/azsdk-common-apiview-feedback-resolution/evals/trigger.eval.yaml","title":"Evals Skill","category":"anthropic-skill","format":"yaml","content":"# Evals Skill\n\nPath: `.github/skills/azsdk-common-apiview-feedback-resolution/evals/trigger.eval.yaml`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/.github/skills/azsdk-common-apiview-feedback-resolution/evals/trigger.eval.yaml)","tokens":300,"sizeBytes":279},{"name":"apiview-comment.json","path":".github/skills/azsdk-common-apiview-feedback-resolution/fixtures/apiview-comment.json","rawUrl":"https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/.github/skills/azsdk-common-apiview-feedback-resolution/fixtures/apiview-comment.json","title":"Fixtures Skill","category":"anthropic-skill","format":"json","content":"# Fixtures Skill\n\nPath: `.github/skills/azsdk-common-apiview-feedback-resolution/fixtures/apiview-comment.json`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/.github/skills/azsdk-common-apiview-feedback-resolution/fixtures/apiview-comment.json)","tokens":300,"sizeBytes":294},{"name":"feedback-resolution-steps.md","path":".github/skills/azsdk-common-apiview-feedback-resolution/references/feedback-resolution-steps.md","rawUrl":"https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/.github/skills/azsdk-common-apiview-feedback-resolution/references/feedback-resolution-steps.md","title":"References Skill","category":"anthropic-skill","format":"markdown","content":"# References Skill\n\nPath: `.github/skills/azsdk-common-apiview-feedback-resolution/references/feedback-resolution-steps.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/.github/skills/azsdk-common-apiview-feedback-resolution/references/feedback-resolution-steps.md)","tokens":300,"sizeBytes":316},{"name":"SKILL.md","path":".github/skills/azsdk-common-apiview-feedback-resolution/SKILL.md","rawUrl":"https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/.github/skills/azsdk-common-apiview-feedback-resolution/SKILL.md","title":"azsdk-common-apiview-feedback-resolution","category":"anthropic-skill","format":"markdown","content":"---\nname: azsdk-common-apiview-feedback-resolution\nlicense: MIT\nmetadata:\n version: \"1.0.0\"\n distribution: shared\ndescription: \"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.\"\ncompatibility: \"azure-sdk-mcp server, SDK pull request with APIView review link\"\n---\n\n# APIView Feedback Resolution\n\nThis skill analyzes and resolves APIView review feedback on Azure SDK pull requests by retrieving reviewer comments, categorizing them, and applying TypeSpec or customization updates that bring the SDK API surface into compliance before re-review.\n\n## Triggers\n\nUSE FOR: APIView comments, API review feedback, SDK API surface changes\nWHEN: \"resolve APIView comments\", \"address API review feedback\", \"update SDK API surface after APIView\"\nDO NOT USE FOR: general code review, non-APIView feedback\n\n## Rules\n\n- Requires the `azure-sdk-mcp` server; there is no CLI fallback for retrieving APIView comments or applying TypeSpec changes.\n- Retrieve and categorize APIView comments before making changes so fixes map to reviewer intent.\n- Validate, regenerate, build, and test after applying fixes before requesting re-review.\n\n## MCP Tools\n\n| Tool | Purpose |\n| -------------------------------------------------------- | --------------------------------------------------- |\n| `azure-sdk-mcp:azsdk_apiview_get_comments` | Get APIView comments |\n| `azure-sdk-mcp:azsdk_customized_code_update` | Apply TypeSpec & code customization changes locally |\n| `azure-sdk-mcp:azsdk_typespec_delegate_apiview_feedback` | Delegate to CCA pipeline |\n| `azure-sdk-mcp:azsdk_run_typespec_validation` | Validate TypeSpec |\n| `azure-sdk-mcp:azsdk_package_generate_code` | Regenerate SDK |\n\n## Steps\n\n1. **Retrieve** — Get APIView URL from SDK PR, run `azsdk_apiview_get_comments`.\n2. **Categorize** — Group as Critical/Suggestions/Informational per [feedback steps](references/feedback-resolution-steps.md).\n3. **Resolve** — Use `azsdk_customized_code_update` for TypeSpec changes; delegate via `azsdk_typespec_delegate_apiview_feedback` for complex cases.\n4. **Validate** — Run validation, regenerate SDK, build and test.\n5. **Confirm** — Verify all items addressed. If delegated, follow [post-delegation follow-up](references/feedback-resolution-steps.md#post-delegation-follow-up). Request re-review.\n\n## Examples\n\n- \"Resolve the APIView comments on my SDK pull request\"\n- \"What feedback did the API reviewer leave?\"\n\n## Troubleshooting\n\n- **No comments**: Verify PR has APIView link and MCP server is connected.\n- **Validation fails**: Re-run after fixing TypeSpec errors.\n- **MCP unavailable**: Requires `azure-sdk-mcp` server; no CLI fallback. Connect the server and retry.\n","frontmatter":{"name":"azsdk-common-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_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.","compatibility":"azure-sdk-mcp server, SDK pull request with APIView review link"},"isInternal":false,"tokens":711,"sizeBytes":3342},{"name":"eval.yaml","path":".github/skills/azsdk-common-generate-sdk-locally/evals/eval.yaml","rawUrl":"https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/.github/skills/azsdk-common-generate-sdk-locally/evals/eval.yaml","title":"Evals Skill","category":"anthropic-skill","format":"yaml","content":"# Evals Skill\n\nPath: `.github/skills/azsdk-common-generate-sdk-locally/evals/eval.yaml`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/.github/skills/azsdk-common-generate-sdk-locally/evals/eval.yaml)","tokens":300,"sizeBytes":249},{"name":"trigger.eval.yaml","path":".github/skills/azsdk-common-generate-sdk-locally/evals/trigger.eval.yaml","rawUrl":"https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/.github/skills/azsdk-common-generate-sdk-locally/evals/trigger.eval.yaml","title":"Evals Skill","category":"anthropic-skill","format":"yaml","content":"# Evals Skill\n\nPath: `.github/skills/azsdk-common-generate-sdk-locally/evals/trigger.eval.yaml`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/.github/skills/azsdk-common-generate-sdk-locally/evals/trigger.eval.yaml)","tokens":300,"sizeBytes":265},{"name":"tspconfig.yaml","path":".github/skills/azsdk-common-generate-sdk-locally/fixtures/tspconfig.yaml","rawUrl":"https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/.github/skills/azsdk-common-generate-sdk-locally/fixtures/tspconfig.yaml","title":"Fixtures Skill","category":"anthropic-skill","format":"yaml","content":"# Fixtures Skill\n\nPath: `.github/skills/azsdk-common-generate-sdk-locally/fixtures/tspconfig.yaml`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/.github/skills/azsdk-common-generate-sdk-locally/fixtures/tspconfig.yaml)","tokens":300,"sizeBytes":268},{"name":"customization-workflow.md","path":".github/skills/azsdk-common-generate-sdk-locally/references/customization-workflow.md","rawUrl":"https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/.github/skills/azsdk-common-generate-sdk-locally/references/customization-workflow.md","title":"References Skill","category":"anthropic-skill","format":"markdown","content":"# References Skill\n\nPath: `.github/skills/azsdk-common-generate-sdk-locally/references/customization-workflow.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/.github/skills/azsdk-common-generate-sdk-locally/references/customization-workflow.md)","tokens":300,"sizeBytes":296},{"name":"detailed-workflow.md","path":".github/skills/azsdk-common-generate-sdk-locally/references/detailed-workflow.md","rawUrl":"https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/.github/skills/azsdk-common-generate-sdk-locally/references/detailed-workflow.md","title":"References Skill","category":"anthropic-skill","format":"markdown","content":"# References Skill\n\nPath: `.github/skills/azsdk-common-generate-sdk-locally/references/detailed-workflow.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/.github/skills/azsdk-common-generate-sdk-locally/references/detailed-workflow.md)","tokens":300,"sizeBytes":286},{"name":"sdk-repos.md","path":".github/skills/azsdk-common-generate-sdk-locally/references/sdk-repos.md","rawUrl":"https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/.github/skills/azsdk-common-generate-sdk-locally/references/sdk-repos.md","title":"References Skill","category":"anthropic-skill","format":"markdown","content":"# References Skill\n\nPath: `.github/skills/azsdk-common-generate-sdk-locally/references/sdk-repos.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/.github/skills/azsdk-common-generate-sdk-locally/references/sdk-repos.md)","tokens":300,"sizeBytes":270},{"name":"SKILL.md","path":".github/skills/azsdk-common-generate-sdk-locally/SKILL.md","rawUrl":"https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/.github/skills/azsdk-common-generate-sdk-locally/SKILL.md","title":"azsdk-common-generate-sdk-locally","category":"anthropic-skill","format":"markdown","content":"---\nname: azsdk-common-generate-sdk-locally\nlicense: MIT\nmetadata:\n version: \"1.1.1\"\n distribution: shared\ndescription: 'Generate and finalize Azure SDKs locally from TypeSpec, including build, checks, tests, changelog, metadata, and version updates by default. WHEN: \"generate SDK locally\", \"build SDK\", \"run SDK tests\", \"run CI checks\", \"validate package\", \"run checks\", \"update changelog\", \"fix SDK build errors\", \"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\". 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.'\ncompatibility: \"azure-sdk-mcp server, local azure-sdk-for-{language} clone, language build tools\"\n---\n\n# Generate SDK Locally\n\nThis 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.\n\n## Triggers\n\nUSE FOR: generate, build, and test Azure SDKs locally from TypeSpec with automatic customization; update changelog; fix SDK build errors; 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\nWHEN: \"generate SDK locally\", \"build SDK\", \"run SDK tests\", \"update changelog\", \"fix SDK build errors\", \"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\"\n\n## Boundaries\n\nDo not use this skill for:\n\n- Publishing SDK packages to package registries\n- CI pipeline configuration\n- API design review\n\n## Rules\n\n- Interpret **\"generate SDK\"** and **\"generate SDK locally\"** as requests for the complete workflow: generate, build, validate, test, update changelog, update metadata, and update version. Do not treat the word \"generate\" by itself as a generate-only request.\n- Stop after generation and a successful build when the user explicitly says **\"generate only\"**, **\"only generate\"**, or otherwise explicitly asks to skip checks, tests, changelog, metadata, and version updates. Bind `only` to the generation action even when a target qualifier follows: **\"generate SDK only for Web PubSub\"** is a generate-only request scoped to Web PubSub. By contrast, **\"generate the SDK for only the Web PubSub service\"** scopes the complete workflow to one service. Once a request is classified as generate-only, do not prompt for a commit or run steps 8–11. If the user's intent is unclear, default to the complete workflow.\n- This skill generates an SDK **locally** from a local clone. Use it to generate an SDK **only when the user indicates local generation** — they say \"local\"/\"locally\", or are working from a local clone. If the user asks to \"generate SDK for **all languages**\", to generate **for a release plan / release ID** (even a single language), to generate **without a local clone**, or wants SDK **pull requests created** for them, do **not** generate locally — use the `azsdk-common-generate-sdk-pipeline` skill, which runs the SDK generation pipeline for each language and produces the SDK pull requests.\n- Never use `azure-sdk-mcp:azsdk_get_sdk_pull_request_link` or `azure-sdk-mcp:azsdk_get_pull_request` to _generate_ an SDK; those only retrieve links for SDKs that were already generated.\n- Requires the `azure-sdk-mcp` server for the MCP workflow; without MCP, use `npm exec --prefix eng/common/tsp-client -- tsp-client` CLI.\n- Verify the target language repo and the correct TypeSpec configuration file before generation.\n- After generation or customization, run the check and test steps before updating metadata or finalizing changes.\n\n## MCP Tools\n\n| Tool | Purpose |\n| ------------------------------------------------------ | ------------------------------------------------------ |\n| `azure-sdk-mcp:azsdk_verify_setup` | Verify environment |\n| `azure-sdk-mcp:azsdk_package_generate_code` | Generate SDK |\n| `azure-sdk-mcp:azsdk_package_build_code` | Build package |\n| `azure-sdk-mcp:azsdk_package_run_check` | Validate package |\n| `azure-sdk-mcp:azsdk_package_run_tests` | Run tests |\n| `azure-sdk-mcp:azsdk_customized_code_update` | Apply customizations (includes regeneration and build) |\n| `azure-sdk-mcp:azsdk_package_update_changelog_content` | Update changelog |\n| `azure-sdk-mcp:azsdk_package_update_metadata` | Update metadata including ci.yml |\n| `azure-sdk-mcp:azsdk_package_update_version` | Update version |\n\nPrerequisites: azure-sdk-mcp server must be running. Without MCP, use `npx tsp-client` CLI.\n\n## Steps\n\n1. **Select language** — Confirm target language: .NET, Java, JavaScript, Python, Go, or Rust.\n2. **Verify repo** — Ensure the user has a local clone of the correct [SDK repo](references/sdk-repos.md). If not cloned, instruct user to clone it.\n3. **Identify config file** — Determine the path to the TypeSpec configuration file. See [config file details](references/detailed-workflow.md).\n - From `azure-rest-api-specs` repo: use path to `tspconfig.yaml`.\n - From an SDK language repo: use path to `tsp-location.yaml`.\n4. **Verify setup** — Run `azure-sdk-mcp:azsdk_verify_setup` to confirm environment.\n5. **Generate** — Run `azure-sdk-mcp:azsdk_package_generate_code` with the config file path.\n6. **Build** — Run `azure-sdk-mcp:azsdk_package_build_code`. For .NET, use the `additionalArguments: \"/p:RunApiCompat=false\"` to skip API compatibility checks if user requests to skip API compatibility check.\n7. **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](references/customization-workflow.md). _(If the user requested \"generate only\", stop here — skip steps 8–11.)_\n8. **Commit checkpoint** — Prompt the user to commit generated changes before proceeding. See [commit checkpoint details](references/detailed-workflow.md).\n9. **Validate** — Run `azure-sdk-mcp:azsdk_package_run_check` and `azure-sdk-mcp:azsdk_package_run_tests`.\n10. **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.)_\n11. **Final commit** — Prompt the user to commit final changes (changelog, metadata, version). See [commit checkpoint details](references/detailed-workflow.md).\n\n[SDK repos](references/sdk-repos.md) | [Customization workflow](references/customization-workflow.md) | [Detailed workflow](references/detailed-workflow.md)\n\n## Guardrails\n\n- **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.\n- 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.\n- Only the customization tool understands the correct layering of TypeSpec decorators vs code patches and ensures regenerated code stays consistent.\n\n## Examples\n\n- \"Generate the SDK locally for my TypeSpec service\"\n- \"Build and test the Python SDK package\"\n- \"Run CI checks for my SDK package\"\n- \"Fix the SDK build errors on this PR\"\n- \"Rename FooClient to BarClient for .NET\"\n- \"Hide the internal polling operation from the Python SDK\"\n- \"Fix .NET analyzer errors AZC0030 and AZC0012\"\n- \"The build is failing because a customization references a renamed property\"\n- \"Create a subclient architecture for the Python SDK\"\n- \"Apply TypeSpec customizations to fix compilation errors\"\n- \"Update the changelog for this SDK package\"\n- \"Update the package version\"\n- \"Update the package metadata and ci.yml\"\n\n## Troubleshooting\n\n- For \"generate SDK for all languages\", pipeline-based generation, or when no local SDK clone exists, call `azure-sdk-mcp:azsdk_run_generate_sdk` instead of the local generate flow, and never substitute `azure-sdk-mcp:azsdk_get_sdk_pull_request_link` / `azure-sdk-mcp:azsdk_get_pull_request` for generation.\n- Run `azure-sdk-mcp:azsdk_verify_setup` to confirm MCP and tools.\n- If build fails with type conflicts, breaking changes, analyzer errors, or customization drift, use `azure-sdk-mcp:azsdk_customized_code_update` to apply customizations.\n- The customization tool uses a two-phase approach: TypeSpec decorators first (Phase A), then code repairs if needed (Phase B).\n- 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.\n- Without MCP, use `npx tsp-client` CLI.\n","frontmatter":{"name":"azsdk-common-generate-sdk-locally","license":"MIT","metadata":{"version":"1.1.1","distribution":"shared"},"description":"Generate and finalize Azure SDKs locally from TypeSpec, including build, checks, tests, changelog, metadata, and version updates by default. WHEN: \"generate SDK locally\", \"build SDK\", \"run SDK tests\", \"run CI checks\", \"validate package\", \"run checks\", \"update changelog\", \"fix SDK build errors\", \"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\". 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"},"isInternal":false,"tokens":2205,"sizeBytes":10106},{"name":"trigger.eval.yaml","path":".github/skills/azsdk-common-pipeline-analysis/evals/trigger.eval.yaml","rawUrl":"https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/.github/skills/azsdk-common-pipeline-analysis/evals/trigger.eval.yaml","title":"Evals Skill","category":"anthropic-skill","format":"yaml","content":"# Evals Skill\n\nPath: `.github/skills/azsdk-common-pipeline-analysis/evals/trigger.eval.yaml`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/.github/skills/azsdk-common-pipeline-analysis/evals/trigger.eval.yaml)","tokens":300,"sizeBytes":259},{"name":"failure-patterns.md","path":".github/skills/azsdk-common-pipeline-analysis/references/failure-patterns.md","rawUrl":"https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/.github/skills/azsdk-common-pipeline-analysis/references/failure-patterns.md","title":"References Skill","category":"anthropic-skill","format":"markdown","content":"# References Skill\n\nPath: `.github/skills/azsdk-common-pipeline-analysis/references/failure-patterns.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/.github/skills/azsdk-common-pipeline-analysis/references/failure-patterns.md)","tokens":300,"sizeBytes":278},{"name":"output-format.md","path":".github/skills/azsdk-common-pipeline-analysis/references/output-format.md","rawUrl":"https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/.github/skills/azsdk-common-pipeline-analysis/references/output-format.md","title":"References Skill","category":"anthropic-skill","format":"markdown","content":"# References Skill\n\nPath: `.github/skills/azsdk-common-pipeline-analysis/references/output-format.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/.github/skills/azsdk-common-pipeline-analysis/references/output-format.md)","tokens":300,"sizeBytes":272},{"name":"SKILL.md","path":".github/skills/azsdk-common-pipeline-analysis/SKILL.md","rawUrl":"https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/.github/skills/azsdk-common-pipeline-analysis/SKILL.md","title":"azsdk-common-pipeline-analysis","category":"anthropic-skill","format":"markdown","content":"---\nname: azsdk-common-pipeline-analysis\nlicense: MIT\nmetadata:\n version: \"1.0.0\"\n distribution: shared\ndescription: 'Analyze Azure SDK CI/CD pipeline failures into a structured diagnosis, and define the required output format. Load this skill before calling azsdk_analyze_pipeline, which returns raw failure data that this skill interprets and formats. USE FOR: \"pipeline failed\", \"build failure\", \"CI check failing\", \"tests failing in CI\", \"analyze pipeline\", \"debug SDK pipeline\". DO NOT USE FOR: local build issues without pipeline context, API design review, SDK publishing, applying code fixes (instead use azsdk-common-pipeline-fixer). INVOKES: azure-sdk-mcp:azsdk_analyze_pipeline, azure-sdk-mcp:azsdk_get_pipeline_llm_artifacts, azure-sdk-mcp:azsdk_get_failed_test_run_data, azure-sdk-mcp:azsdk_get_failed_test_case_data, azure-sdk-mcp:azsdk_get_pr_checks, azure-sdk-mcp:azsdk_get_pipeline_status.'\ncompatibility: \"azure-sdk-mcp server, Azure DevOps pipeline build ID or GitHub PR link\"\n---\n\n# Pipeline Analysis\n\nThis skill analyzes Azure SDK CI/CD pipeline failures and provides a structured diagnosis including root cause, affected files, and concrete instructions for how to fix each issue. It does NOT apply fixes - it tells you exactly what's wrong and how to resolve it.\n\n## Rules\n\n- Load this skill **before** running `azsdk_analyze_pipeline` — the tool returns raw failure data that this skill interprets and formats per [output format](references/output-format.md).\n- Requires the `azure-sdk-mcp` server; without it, inspect logs in the Azure DevOps UI.\n- Analysis-only: never edit files or apply fixes — use `azsdk-common-pipeline-fixer` for changes.\n- Run `azsdk_analyze_pipeline` first, then categorize each failure and cite specific files/lines.\n- For infrastructure failures (network timeouts, agent crashes, throttling), recommend retry, not code changes.\n\n## MCP Tools\n\n| Tool | Purpose |\n| ------------------------------------------------ | --------------------------------------------------- |\n| `azure-sdk-mcp:azsdk_analyze_pipeline` | Analyze pipeline failure (logs + test results) |\n| `azure-sdk-mcp:azsdk_get_pipeline_llm_artifacts` | Download test result artifacts from pipeline |\n| `azure-sdk-mcp:azsdk_get_failed_test_run_data` | Full details for every failure in one artifact file |\n| `azure-sdk-mcp:azsdk_get_failed_test_case_data` | Full details for a single failing test in a file |\n| `azure-sdk-mcp:azsdk_get_pr_checks` | Get pipeline/check results linked to a PR |\n| `azure-sdk-mcp:azsdk_get_pipeline_status` | Get pipeline run status |\n\n## Steps\n\n1. **Identify** - Get the build ID, pipeline URL, or PR link (use the PR link when triggered from a PR comment).\n2. **Analyze** - Run `azsdk_analyze_pipeline`. It returns `failed_pipeline_tasks` (log errors from failed steps) and `failed_pipeline_tests`, a lightweight index of failed tests grouped by artifact file. Each entry has `artifact_file_path`, `platform`, and `failed_test_titles` — titles only, no error text, to keep the response small.\n3. **Fetch failure details** - Fetch failure details lazily so you don't overload context: call `azsdk_get_failed_test_run_data` with the parameter `failedTestRunsPath` set to `artifact_file_path` once per file to get every failure in it. Or call `azsdk_get_failed_test_case_data` with\n `failedTestRunsPath` set to `artifact_file_path` and `testCaseTitle` set to one exact title from `failed_test_titles`. Prefer the per-file call when triaging a whole file's failures.\n4. **Categorize** each failure: test, build/compilation, validation/lint, or infrastructure.\n5. **Diagnose** - Give each failure's root cause and affected file(s)/line(s), and note if several share one root cause. See [failure patterns](references/failure-patterns.md).\n6. **Report** - Use the [output format](references/output-format.md): root cause, affected files, per-failure fix + verify command, and fixable vs infrastructure. Recommend `azsdk-common-pipeline-fixer` to apply fixes.\n\n## Examples\n\n- \"My pipeline build 6447834 failed, what went wrong?\"\n- PR comment: `@copilot Analyze the failed pipeline on this PR`\n- \"Why is my CI red? Build ID is 6455939\"\n\n## Troubleshooting\n\n- If `azsdk_analyze_pipeline` returns no data, verify the build ID is correct and the run has completed.\n- If `failed_pipeline_tests` is empty, rely on `failed_pipeline_tasks` log analysis (test-artifact upload may not be configured).\n- For a private/internal pipeline, the user may need to `az login`. See [failure patterns](references/failure-patterns.md).\n","frontmatter":{"name":"azsdk-common-pipeline-analysis","license":"MIT","metadata":{"version":"1.0.0","distribution":"shared"},"description":"Analyze Azure SDK CI/CD pipeline failures into a structured diagnosis, and define the required output format. Load this skill before calling azsdk_analyze_pipeline, which returns raw failure data that this skill interprets and formats. USE FOR: \"pipeline failed\", \"build failure\", \"CI check failing\", \"tests failing in CI\", \"analyze pipeline\", \"debug SDK pipeline\". DO NOT USE FOR: local build issues without pipeline context, API design review, SDK publishing, applying code fixes (instead use azsdk-common-pipeline-fixer). INVOKES: azure-sdk-mcp:azsdk_analyze_pipeline, azure-sdk-mcp:azsdk_get_pipeline_llm_artifacts, azure-sdk-mcp:azsdk_get_failed_test_run_data, azure-sdk-mcp:azsdk_get_failed_test_case_data, azure-sdk-mcp:azsdk_get_pr_checks, azure-sdk-mcp:azsdk_get_pipeline_status.","compatibility":"azure-sdk-mcp server, Azure DevOps pipeline build ID or GitHub PR link"},"isInternal":false,"tokens":1080,"sizeBytes":4735},{"name":"trigger.eval.yaml","path":".github/skills/azsdk-common-pipeline-fixer/evals/trigger.eval.yaml","rawUrl":"https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/.github/skills/azsdk-common-pipeline-fixer/evals/trigger.eval.yaml","title":"Evals Skill","category":"anthropic-skill","format":"yaml","content":"# Evals Skill\n\nPath: `.github/skills/azsdk-common-pipeline-fixer/evals/trigger.eval.yaml`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/.github/skills/azsdk-common-pipeline-fixer/evals/trigger.eval.yaml)","tokens":300,"sizeBytes":253},{"name":"SKILL.md","path":".github/skills/azsdk-common-pipeline-fixer/SKILL.md","rawUrl":"https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/.github/skills/azsdk-common-pipeline-fixer/SKILL.md","title":"azsdk-common-pipeline-fixer","category":"anthropic-skill","format":"markdown","content":"---\nname: azsdk-common-pipeline-fixer\nlicense: MIT\nmetadata:\n version: \"1.0.0\"\n distribution: shared\ndescription: 'Automatically fix Azure SDK CI/CD pipeline failures by applying code changes and verifying locally. USE FOR: \"fix pipeline failure\", \"fix CI\", \"fix failing tests\", \"auto-fix and commit the fix\", \"fix build error\", \"fix mypy/pylint/type-check/lint errors\", \"auto-fix pipeline\", \"resolve pipeline failure\". DO NOT USE FOR: pipeline analysis (instead use azsdk-common-pipeline-analysis), API design review, SDK publishing. INVOKES: azure-sdk-mcp:azsdk_package_build_code, azure-sdk-mcp:azsdk_package_run_check, azure-sdk-mcp:azsdk_package_run_tests, azure-sdk-mcp:azsdk_verify_setup.'\ncompatibility: \"azure-sdk-mcp server, local azure-sdk-for-{language} clone, language build tools\"\n---\n\n# Pipeline Fixer\n\nThis skill automatically fixes Azure SDK CI/CD pipeline failures. It analyzes the failure, identifies the root cause, applies code changes, and verifies the fix locally using build, check, and test tools before committing.\n\n## Rules\n\n- Requires the `azure-sdk-mcp` server and a local clone of the SDK language repo.\n- Work on the PR branch — the failing code is there, not main.\n- Analyze first, then apply the minimal code change for the root cause.\n- Verify ONLY via the azsdk MCP package tools (build → check → tests); never raw shell build/test commands.\n- Never fix infrastructure failures (timeouts, crashes, throttling) — recommend retry. Iterate up to 3 times, then report.\n\n## MCP Tools\n\n| Tool | Purpose |\n| ---------------------------------------- | ------------------------------------- |\n| `azure-sdk-mcp:azsdk_verify_setup` | Verify local environment is ready |\n| `azure-sdk-mcp:azsdk_package_build_code` | Build the package locally |\n| `azure-sdk-mcp:azsdk_package_run_check` | Run validation/lint/typecheck locally |\n| `azure-sdk-mcp:azsdk_package_run_tests` | Run tests locally |\n\n**Prerequisites:** azure-sdk-mcp server required. Local clone of the affected SDK language repo. Language build tools installed.\n\n## Steps\n\n1. **Find analysis** - Reuse an existing analysis from the PR comments; if none, view the `azsdk-common-pipeline-analysis` skill.\n2. **Classify** - Fixable (test, type, lint, import, assertion errors) vs retry (infrastructure) vs escalate (breaking API, credentials).\n3. **Locate** - Identify the affected package, its path, and the files/lines to change.\n4. **Fix** - Read the failing code at the cited lines and apply the minimal fix.\n5. **Verify** - Run `azsdk_package_build_code` → `azsdk_package_run_check` → `azsdk_package_run_tests` on the package; all must pass. If the environment isn't ready, run `azsdk_verify_setup`. Never substitute raw shell build/test commands.\n6. **Iterate & commit** - On failure, revise and re-verify (max 3 attempts). Once all pass, commit with a descriptive message.\n\n## Examples\n\n- \"Fix the pipeline failure for build 6447834\"\n- \"My Python SDK CI is failing with a type error, fix it\"\n- \"Auto-fix the failing tests in my PR\"\n\n## Troubleshooting\n\n- If the verify tools fail because the environment isn't ready, run `azsdk_verify_setup`, report its error, and stop — don't fall back to raw shell build/test commands.\n","frontmatter":{"name":"azsdk-common-pipeline-fixer","license":"MIT","metadata":{"version":"1.0.0","distribution":"shared"},"description":"Automatically fix Azure SDK CI/CD pipeline failures by applying code changes and verifying locally. USE FOR: \"fix pipeline failure\", \"fix CI\", \"fix failing tests\", \"auto-fix and commit the fix\", \"fix build error\", \"fix mypy/pylint/type-check/lint errors\", \"auto-fix pipeline\", \"resolve pipeline failure\". DO NOT USE FOR: pipeline analysis (instead use azsdk-common-pipeline-analysis), API design review, SDK publishing. INVOKES: azure-sdk-mcp:azsdk_package_build_code, azure-sdk-mcp:azsdk_package_run_check, azure-sdk-mcp:azsdk_package_run_tests, azure-sdk-mcp:azsdk_verify_setup.","compatibility":"azure-sdk-mcp server, local azure-sdk-for-{language} clone, language build tools"},"isInternal":false,"tokens":773,"sizeBytes":3335},{"name":"eval.yaml","path":".github/skills/azsdk-common-prepare-release-plan/evals/eval.yaml","rawUrl":"https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/.github/skills/azsdk-common-prepare-release-plan/evals/eval.yaml","title":"Evals Skill","category":"anthropic-skill","format":"yaml","content":"# Evals Skill\n\nPath: `.github/skills/azsdk-common-prepare-release-plan/evals/eval.yaml`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/.github/skills/azsdk-common-prepare-release-plan/evals/eval.yaml)","tokens":300,"sizeBytes":249},{"name":"schedule-risk.eval.yaml","path":".github/skills/azsdk-common-prepare-release-plan/evals/schedule-risk.eval.yaml","rawUrl":"https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/.github/skills/azsdk-common-prepare-release-plan/evals/schedule-risk.eval.yaml","title":"Evals Skill","category":"anthropic-skill","format":"yaml","content":"# Evals Skill\n\nPath: `.github/skills/azsdk-common-prepare-release-plan/evals/schedule-risk.eval.yaml`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/.github/skills/azsdk-common-prepare-release-plan/evals/schedule-risk.eval.yaml)","tokens":300,"sizeBytes":277},{"name":"trigger.eval.yaml","path":".github/skills/azsdk-common-prepare-release-plan/evals/trigger.eval.yaml","rawUrl":"https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/.github/skills/azsdk-common-prepare-release-plan/evals/trigger.eval.yaml","title":"Evals Skill","category":"anthropic-skill","format":"yaml","content":"# Evals Skill\n\nPath: `.github/skills/azsdk-common-prepare-release-plan/evals/trigger.eval.yaml`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/.github/skills/azsdk-common-prepare-release-plan/evals/trigger.eval.yaml)","tokens":300,"sizeBytes":265},{"name":"tspconfig.yaml","path":".github/skills/azsdk-common-prepare-release-plan/fixtures/tspconfig.yaml","rawUrl":"https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/.github/skills/azsdk-common-prepare-release-plan/fixtures/tspconfig.yaml","title":"Fixtures Skill","category":"anthropic-skill","format":"yaml","content":"# Fixtures Skill\n\nPath: `.github/skills/azsdk-common-prepare-release-plan/fixtures/tspconfig.yaml`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/.github/skills/azsdk-common-prepare-release-plan/fixtures/tspconfig.yaml)","tokens":300,"sizeBytes":268},{"name":"release-plan-details.md","path":".github/skills/azsdk-common-prepare-release-plan/references/release-plan-details.md","rawUrl":"https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/.github/skills/azsdk-common-prepare-release-plan/references/release-plan-details.md","title":"References Skill","category":"anthropic-skill","format":"markdown","content":"# References Skill\n\nPath: `.github/skills/azsdk-common-prepare-release-plan/references/release-plan-details.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/.github/skills/azsdk-common-prepare-release-plan/references/release-plan-details.md)","tokens":300,"sizeBytes":292},{"name":"SKILL.md","path":".github/skills/azsdk-common-prepare-release-plan/SKILL.md","rawUrl":"https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/.github/skills/azsdk-common-prepare-release-plan/SKILL.md","title":"azsdk-common-prepare-release-plan","category":"anthropic-skill","format":"markdown","content":"---\nname: azsdk-common-prepare-release-plan\nlicense: MIT\nmetadata:\n version: \"1.0.0\"\n distribution: shared\ndescription: '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_update_release_plan, azure-sdk-mcp:azsdk_update_release_plan_target, 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.'\ncompatibility: \"azure-sdk-mcp server, API spec PR in Azure/azure-rest-api-specs\"\n---\n\n# Prepare Release Plan\n\nThis skill creates, gets, updates, abandons, and links SDK PRs to release plan work items for Azure SDK releases, helping gather required release data, validate spec inputs, and link related approvals or SDK pull requests without exposing internal work item URLs.\n\n## Triggers\n\nUSE 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\nWHEN: \"create release plan\", \"get release plan\", \"update release plan\", \"abandon release plan\", \"link SDK PR to plan\", \"namespace approval\", \"check release plan status\"\nDO NOT USE FOR: SDK code generation, pipeline troubleshooting, API review feedback\n\n## Rules\n\n- Do not display Azure DevOps work item URLs; only provide the Release Plan Link and ID.\n- Require an API spec PR link or a TypeSpec project path before creating or updating a plan.\n- Validate that the spec PR repository matches the requested API release type before creation.\n- Release plan tools accept **either** a Release Plan ID or an Azure DevOps work item ID — pass whichever the user provides. Each tool resolves the value automatically (trying it as a Release Plan ID first, then as a work item ID), so you do not need to call `azure-sdk-mcp:azsdk_get_release_plan` first just to translate one ID into the other.\n- Always relay schedule-risk `warnings` and `next_steps` returned by release plan tools. For each past-due plan, show its Release Plan ID and dashboard link, then present both choices: update its target release month or abandon it and record the reason in the dashboard.\n\n## MCP Tools\n\n| Tool | Purpose |\n| ------------------------------------------------------------------ | ---------------------------------- |\n| `azure-sdk-mcp:azsdk_create_release_plan` | Create a new release plan |\n| `azure-sdk-mcp:azsdk_get_release_plan` | Get plan by ID, path, or spec PR |\n| `azure-sdk-mcp:azsdk_update_release_plan` | Update release plan metadata |\n| `azure-sdk-mcp:azsdk_update_release_plan_target` | Update the target release month |\n| `azure-sdk-mcp:azsdk_update_api_spec_pull_request_in_release_plan` | Update API spec PR URL in plan |\n| `azure-sdk-mcp:azsdk_update_sdk_details_in_release_plan` | Update SDK/package details in plan |\n| `azure-sdk-mcp:azsdk_abandon_release_plan` | Abandon a release plan |\n| `azure-sdk-mcp:azsdk_link_sdk_pull_request_to_release_plan` | Link SDK PR to release plan |\n| `azure-sdk-mcp:azsdk_link_namespace_approval_issue` | Link namespace approval issue |\n\n---\n\n## Use Cases\n\n### 1. Create Release Plan\n\n**When**: User wants to create a release plan for a TypeSpec project.\n\n**Steps**:\n\n1. **Get TypeSpec Project Path** — Ask the user for the relative TypeSpec project path (directory containing `tspconfig.yaml`, e.g. `specification/contosowidgetmanager/Contoso.WidgetManager`). Always use the relative path from the repo root, not an absolute path.\n2. **Check Existing** — Run `azure-sdk-mcp:azsdk_get_release_plan` with the relative `typeSpecProjectPath` to check if a release plan already exists.\n - If a release plan exists with the **same API release type** the user requested: inform the user that a release plan already exists, show the Release Plan ID, status, and API release type. Suggest the user use the existing release plan. Do NOT create a new one.\n - If a release plan exists but for a **different API release type**: inform the user about the existing plan and its API release type, then proceed to create a new release plan using `forceCreateReleasePlan: true` for the user's requested API release type. Do NOT attempt to update the existing release plan's API release type.\n - If no release plan exists, proceed to step 3.\n3. **Gather Info** — Collect required details from the user. See [details](references/release-plan-details.md):\n - Target release month/year (format: \"Month YYYY\", e.g. \"June 2026\"). Do NOT use formats like \"2026-06\" or \"06/2026\" — these are invalid.\n - API release type: Value must be one of the following: \"Private Preview\", \"Public Preview\", or \"GA\"\n - SDK release type: Value must be \"beta\" or \"stable\" — always ask the user explicitly\n - Spec PR URL (optional)\n - Service Tree ID (GUID) — optional if previously created\n - Product Tree ID (GUID) — optional if previously created\n4. **Create** — Run `azure-sdk-mcp:azsdk_create_release_plan` with the collected parameters including `sdkReleaseType`. Use `forceCreateReleasePlan: true` only if an existing release plan was found for a different API release type.\n5. **Namespace** — For first management plane releases, link namespace approval issue using `azure-sdk-mcp:azsdk_link_namespace_approval_issue`.\n\n> **IMPORTANT**: Do NOT default the API release type value as the SDK release type. These are separate fields — always ask the user explicitly for the SDK release type.\n>\n> **IMPORTANT**: Do NOT update an existing release plan to change its API release type. If a release plan exists for a different API release type, force-create a new one instead.\n\n**Tool**: `azure-sdk-mcp:azsdk_create_release_plan`\n\n---\n\n### 2. Get Release Plan\n\n**When**: User wants to check the status or details of an existing release plan.\n\n**Steps**:\n\n1. **Identify Plan** — Ask user for one of:\n - Release plan ID or work item ID\n - Relative TypeSpec project path (e.g. `specification/contosowidgetmanager/Contoso.WidgetManager`)\n - Spec PR URL\n2. **Query** — Run `azure-sdk-mcp:azsdk_get_release_plan` with the provided identifier. Always use a relative path for `typeSpecProjectPath`; use `specPullRequestUrl` when the user provides only a spec PR URL.\n3. **Display** — Show the release plan ID, status, linked PRs, and SDK details. Always relay schedule-risk warnings and recommended actions from the response.\n\n**Tool**: `azure-sdk-mcp:azsdk_get_release_plan`\n\n---\n\n### 3. Update Release Plan / Update API Spec in Release Plan\n\n**When**: User needs to update release plan metadata (spec PR URL, TypeSpec project path, SDK release type, service/product IDs) or update the API spec PR link.\n\n**Steps**:\n\n1. **Identify Plan** — Get the work item ID or TypeSpec project path from the user.\n2. **Update Metadata** — Run `azure-sdk-mcp:azsdk_update_release_plan` with:\n - `typeSpecProjectPath` (required)\n - `workItemId` (optional — resolved from TypeSpec path or spec PR if not provided)\n - `specPullRequestUrl` (optional)\n - `sdkReleaseType` (required — do NOT default this from API release type; always ask user explicitly)\n - `serviceTreeId` (optional)\n - `productTreeId` (optional)\n3. **Update API Spec PR** — If only the spec PR URL needs updating, run `azure-sdk-mcp:azsdk_update_api_spec_pull_request_in_release_plan` with:\n - `specPullRequestUrl` (required)\n - `workItemId` or `releasePlanId`\n\n**Tools**: `azure-sdk-mcp:azsdk_update_release_plan`, `azure-sdk-mcp:azsdk_update_api_spec_pull_request_in_release_plan`\n\n---\n\n### 4. Update SDK/Package Details in Release Plan\n\n**When**: User needs to update SDK language and package name details in the release plan after code generation or configuration changes.\n\n**Steps**:\n\n1. **Identify Plan** — Get the Release Plan ID or work item ID from the user (either is accepted).\n2. **Identify TypeSpec Project** — Get or confirm the TypeSpec project path.\n3. **Update** — Run `azure-sdk-mcp:azsdk_update_sdk_details_in_release_plan` with:\n - `workItemId` (required — accepts either the Release Plan ID or the work item ID)\n - `typeSpecProjectPath` (required)\n\n**Tool**: `azure-sdk-mcp:azsdk_update_sdk_details_in_release_plan`\n\n---\n\n### 5. Abandon a Release Plan\n\n**When**: User decides to cancel or discard a release plan that is no longer needed.\n\n**Steps**:\n\n1. **Identify Plan** — Get the work item ID or release plan ID from the user.\n2. **Confirm** — Ask user to confirm abandonment: \"Are you sure you want to abandon this release plan? This action updates the status to Abandoned.\"\n3. **Abandon** — Run `azure-sdk-mcp:azsdk_abandon_release_plan` with:\n - `workItemId` or `releasePlanId`\n\n**Tool**: `azure-sdk-mcp:azsdk_abandon_release_plan`\n\n---\n\n### 6. Link SDK Pull Request to Release Plan\n\n**When**: SDK pull requests have been created and need to be associated with the release plan.\n\n**Steps**:\n\n1. **Identify Plan** — Get the Release Plan ID or work item ID from the user (either is accepted).\n2. **Collect PR Info** — Get the SDK pull request URL and language from the user.\n3. **Link** — Run `azure-sdk-mcp:azsdk_link_sdk_pull_request_to_release_plan` with:\n - `pullRequestUrl` (required)\n - `language` (required — e.g., \".NET\", \"Java\", \"JavaScript\", \"Python\", \"Go\")\n - `workItemId` or `releasePlanId` (either accepts the Release Plan ID or the work item ID)\n4. **Repeat** — If multiple SDK PRs exist for different languages, repeat for each.\n\n**Tool**: `azure-sdk-mcp:azsdk_link_sdk_pull_request_to_release_plan`\n\n---\n\n## Examples\n\n- \"Create a release plan for my spec PR\"\n- \"Get the release plan for work item 12345\"\n- \"What is the status of my release plan?\"\n- \"Update the API spec PR in my release plan\"\n- \"Update SDK details in release plan 67890\"\n- \"Abandon release plan 11111\"\n- \"Link my SDK PR to release plan\"\n- \"Link Python SDK PR #100 to release plan 67890\"\n\n## Troubleshooting\n\n- Requires `azure-sdk-mcp` server; no CLI fallback — prompt user to configure MCP if unavailable.\n- If creation fails, verify spec PR URL and Service Tree IDs.\n- If update fails, ensure the Release Plan ID or work item ID is correct and the plan is not already abandoned.\n- If linking fails, verify the SDK PR URL is valid and the language matches a supported value.\n","frontmatter":{"name":"azsdk-common-prepare-release-plan","license":"MIT","metadata":{"version":"1.0.0","distribution":"shared"},"description":"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_update_release_plan, azure-sdk-mcp:azsdk_update_release_plan_target, 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.","compatibility":"azure-sdk-mcp server, API spec PR in Azure/azure-rest-api-specs"},"isInternal":false,"tokens":2628,"sizeBytes":11159},{"name":"eval.yaml","path":".github/skills/azsdk-common-sdk-breaking-change/evals/eval.yaml","rawUrl":"https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/.github/skills/azsdk-common-sdk-breaking-change/evals/eval.yaml","title":"Evals Skill","category":"anthropic-skill","format":"yaml","content":"# Evals Skill\n\nPath: `.github/skills/azsdk-common-sdk-breaking-change/evals/eval.yaml`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/.github/skills/azsdk-common-sdk-breaking-change/evals/eval.yaml)","tokens":300,"sizeBytes":247},{"name":"trigger.eval.yaml","path":".github/skills/azsdk-common-sdk-breaking-change/evals/trigger.eval.yaml","rawUrl":"https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/.github/skills/azsdk-common-sdk-breaking-change/evals/trigger.eval.yaml","title":"Evals Skill","category":"anthropic-skill","format":"yaml","content":"# Evals Skill\n\nPath: `.github/skills/azsdk-common-sdk-breaking-change/evals/trigger.eval.yaml`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/.github/skills/azsdk-common-sdk-breaking-change/evals/trigger.eval.yaml)","tokens":300,"sizeBytes":263},{"name":"SKILL.md","path":".github/skills/azsdk-common-sdk-breaking-change/SKILL.md","rawUrl":"https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/.github/skills/azsdk-common-sdk-breaking-change/SKILL.md","title":"azsdk-common-sdk-breaking-change","category":"anthropic-skill","format":"markdown","content":"---\nname: azsdk-common-sdk-breaking-change\nlicense: MIT\nmetadata:\n version: \"1.0.0\"\n distribution: shared\ndescription: 'Detect and mitigate SDK Breaking changes for an SDK package which is generated from TypeSpec. WHEN: \"Detect SDK breaking changes for a service\", \"Detect SDK breaking changes for an SDK package\", \"Detect and mitigate SDK breaking changes for a service\", \"Detect and mitigate SDK breaking changes for an SDK package\". INVOKES: skill: azsdk-common-generate-sdk-locally; MCP tools: azure-sdk-mcp:azsdk_customized_code_update, azure-sdk-mcp:azsdk_package_detect_breaking_change.'\ncompatibility: \"azure-sdk-mcp server, local azure-sdk-for-{language} clone, language build tools\"\n---\n\n# SDK Breaking Change Detection and Mitigation\n\n## MCP Tools\n\n| Tool | Purpose |\n| ---------------------------------------------------- | --------------------------- |\n| `azure-sdk-mcp:azsdk_customized_code_update` | Apply customizations |\n| `azure-sdk-mcp:azsdk_package_detect_breaking_change` | Detect SDK breaking changes |\n\nPrerequisites: azure-sdk-mcp server must be running.\n\n## Steps\n\n1. **Select language** — First extract one or more target languages from the user's prompt. If the prompt specifies any target languages, use them without asking the user to confirm. If it does not specify a target language, prompt the user to choose one or more from this list, presented in exactly this order: Go, Java, JavaScript, Python, .NET.\n\n- For each selected language in step 1, execute steps 2 through 6 **one language at a time** — fully complete all steps for one language before starting the next. Process multiple selected languages in the same order they appear in the list above.\n\n2. Follow `azsdk-common-generate-sdk-locally` skill to generate SDK only. For .NET, require the preparatory build to disable API compatibility checks using additionalArguments: \"/p:RunApiCompat=false\". This is a requirement of this workflow: compatibility findings must reach the detection and user-selection steps rather than be automatically repaired during generation.\n3. **Detect SDK breaking Changes** - Run `azure-sdk-mcp:azsdk_package_detect_breaking_change`\n4. **Display detected breaking changes** — If step 3 fails, display the `ResponseError` message and stop processing the current language. If step 3 detects breaking changes, display a `## Detected Breaking Changes` title followed by a Markdown table. Include exactly one breaking change per row with these columns: `Breaking Change`, `Category`, and `Resolution`. Preserve the category and resolution returned by the detection tool; do not replace them with a summary. If no breaking changes are detected, report that result and stop processing the current language.\n5. **Prompt the user to choose breaking changes to mitigate** — If the user requested detection only, stop processing the current language after displaying the results. Otherwise, present the list from step 3 as a multiple-choice selection.\n6. **Mitigate selected SDK breaking changes** — If the user selects no changes in step 5, stop processing the current language. Otherwise, run `azure-sdk-mcp:azsdk_customized_code_update` for the selected changes with these parameters:\n\n- packagePath: The SDK package path\n- customizationRequest: resolve the 'breakingChanges' chosen in step 5\n- tspProjectPath: the typespec project path\n- editScope: Set this based on the repository where the skill is running. When running in the target SDK language repository, use `'CustomCode'`. When running in `azure-rest-api-specs`, use `'All'` if the target SDK language repository is also available as a local clone; otherwise, use `'SpecInputs'`.\n\nAfter step 6, begin the next iteration. If the customization modified TypeSpec, first repeat step 2 to regenerate the SDK; otherwise, resume at step 3. Then repeat steps 3 through 6. Run at most three detection-and-mitigation iterations per language, stopping earlier if no breaking changes remain or the user declines further mitigation. After the third mitigation, run step 3 once more to identify and report any remaining breaking changes, then stop without offering a fourth mitigation.\n\n## Examples\n\n- \"Detect and mitigate SDK breaking changes for the service\"\n- \"Detect SDK breaking changes for the service\"\n- \"Detect SDK breaking changes for Go SDK package\"\n- \"Detect and mitigate SDK breaking changes for Go SDK package\"\n\n## Troubleshooting\n\n- Requires the `azure-sdk-mcp` server. If it is unavailable, direct the user to the [quick-start guide](https://github.com/Azure/azure-sdk-tools/blob/main/tools/azsdk-cli/Azure.Sdk.Tools.Cli/README.md#quick-start) to configure it before continuing.\n- Requires a local clone of the target SDK repository. If unavailable, prompt the user to clone it before continuing.\n","frontmatter":{"name":"azsdk-common-sdk-breaking-change","license":"MIT","metadata":{"version":"1.0.0","distribution":"shared"},"description":"Detect and mitigate SDK Breaking changes for an SDK package which is generated from TypeSpec. WHEN: \"Detect SDK breaking changes for a service\", \"Detect SDK breaking changes for an SDK package\", \"Detect and mitigate SDK breaking changes for a service\", \"Detect and mitigate SDK breaking changes for an SDK package\". INVOKES: skill: azsdk-common-generate-sdk-locally; MCP tools: azure-sdk-mcp:azsdk_customized_code_update, azure-sdk-mcp:azsdk_package_detect_breaking_change.","compatibility":"azure-sdk-mcp server, local azure-sdk-for-{language} clone, language build tools"},"isInternal":false,"tokens":1020,"sizeBytes":4866},{"name":"eval.yaml","path":".github/skills/azsdk-common-sdk-release/evals/eval.yaml","rawUrl":"https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/.github/skills/azsdk-common-sdk-release/evals/eval.yaml","title":"Evals Skill","category":"anthropic-skill","format":"yaml","content":"# Evals Skill\n\nPath: `.github/skills/azsdk-common-sdk-release/evals/eval.yaml`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/.github/skills/azsdk-common-sdk-release/evals/eval.yaml)","tokens":300,"sizeBytes":231},{"name":"trigger.eval.yaml","path":".github/skills/azsdk-common-sdk-release/evals/trigger.eval.yaml","rawUrl":"https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/.github/skills/azsdk-common-sdk-release/evals/trigger.eval.yaml","title":"Evals Skill","category":"anthropic-skill","format":"yaml","content":"# Evals Skill\n\nPath: `.github/skills/azsdk-common-sdk-release/evals/trigger.eval.yaml`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/.github/skills/azsdk-common-sdk-release/evals/trigger.eval.yaml)","tokens":300,"sizeBytes":247},{"name":"SKILL.md","path":".github/skills/azsdk-common-sdk-release/SKILL.md","rawUrl":"https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/.github/skills/azsdk-common-sdk-release/SKILL.md","title":"azsdk-common-sdk-release","category":"anthropic-skill","format":"markdown","content":"---\nname: azsdk-common-sdk-release\nlicense: MIT\nmetadata:\n version: \"1.0.0\"\n distribution: shared\ndescription: 'Check release readiness and trigger the release pipeline for Azure SDK packages. **UTILITY SKILL**. USE FOR: \"release SDK\", \"trigger release\", \"check release readiness\", \"release pipeline\", \"publish package\", \"ship SDK\". DO NOT USE FOR: SDK development, code generation, pipeline debugging, release plan creation. INVOKES: azure-sdk-mcp:azsdk_release_sdk.'\ncompatibility: \"azure-sdk-mcp server, SDK package merged on release branch. Supports .NET, Java, JavaScript, Python, Go\"\n---\n\n# SDK Release\n\nThis skill checks release readiness and triggers the Azure SDK release pipeline for packages that are already prepared, guiding the user through prerequisite validation, readiness review, and the final pipeline launch with required approval steps.\n\n## Triggers\n\nUSE FOR: release SDK, trigger release, check release readiness, release pipeline, publish package, ship SDK\nWHEN: \"release SDK\", \"trigger release\", \"check release readiness\", \"release pipeline\", \"publish package\", \"ship SDK\"\nDO NOT USE FOR: SDK development, code generation, pipeline debugging, release plan creation\n\n## Rules\n\n- Requires the `azure-sdk-mcp` server; there is no CLI fallback for the release workflow.\n- Collect `packageName` and `language`, then run the readiness check before attempting to trigger release.\n- If release is triggered, show the pipeline link and remind the user that the release stage still requires approval.\n\n## MCP Tools\n\n| Tool | Purpose |\n| --------------------------------- | ----------------------------------------------------------- |\n| `azure-sdk-mcp:azsdk_release_sdk` | Check release readiness and/or trigger the release pipeline |\n\n## Steps\n\n1. **Collect Info** — Get `packageName` and `language` from the user. Optionally get `branch` (defaults to main).\n2. **Determine Intent** — If the user explicitly asks to \"check readiness\" or \"check if ready\", run `azure-sdk-mcp:azsdk_release_sdk` with `checkReady: true`. Otherwise, proceed to trigger the release directly.\n3. **Trigger Release** — Run `azure-sdk-mcp:azsdk_release_sdk` with `checkReady: false` (the default). Show pipeline link and inform user they must approve the release stage.\n4. **Review Results** — If the release fails due to readiness issues, display failing checks and guide user to resolve.\n\n## Examples\n\n- \"Check if azure-storage-blob is ready for release\"\n- \"Trigger release for @azure/core-rest-pipeline on JavaScript\"\n\n## Troubleshooting\n\n- If readiness check fails, review each failing prerequisite individually before re-triggering.\n- Requires `azure-sdk-mcp` server. No CLI fallback — prompt user to configure MCP if unavailable.\n","frontmatter":{"name":"azsdk-common-sdk-release","license":"MIT","metadata":{"version":"1.0.0","distribution":"shared"},"description":"Check release readiness and trigger the release pipeline for Azure SDK packages. **UTILITY SKILL**. USE FOR: \"release SDK\", \"trigger release\", \"check release readiness\", \"release pipeline\", \"publish package\", \"ship SDK\". DO NOT USE FOR: SDK development, code generation, pipeline debugging, release plan creation. INVOKES: azure-sdk-mcp:azsdk_release_sdk.","compatibility":"azure-sdk-mcp server, SDK package merged on release branch. Supports .NET, Java, JavaScript, Python, Go"},"isInternal":false,"tokens":589,"sizeBytes":2819},{"name":"trigger.eval.yaml","path":".github/skills/code-review/evals/trigger.eval.yaml","rawUrl":"https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/.github/skills/code-review/evals/trigger.eval.yaml","title":"Evals Skill","category":"anthropic-skill","format":"yaml","content":"# Evals Skill\n\nPath: `.github/skills/code-review/evals/trigger.eval.yaml`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/.github/skills/code-review/evals/trigger.eval.yaml)","tokens":300,"sizeBytes":221},{"name":"SKILL.md","path":".github/skills/code-review/SKILL.md","rawUrl":"https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/.github/skills/code-review/SKILL.md","title":"code-review","category":"anthropic-skill","format":"markdown","content":"---\nname: code-review\ndescription: \"Review pull requests and code changes in the Azure SDK for Python repository. USE FOR: GitHub Copilot code review; CCR; review pull request; review PR; review diff; find bugs or regressions introduced by a PR; cross-package SDK review. Finds high-confidence correctness, security, API compatibility, dependency, documentation, and test issues. DO NOT USE FOR: implementing fixes; running tests; fixing CI; releases; APIView feedback.\"\n---\n\n# Azure SDK for Python Code Review\n\nUse this skill for GitHub Copilot code review (CCR) and other broad pull request reviews. If the task already assigns a narrower specialist role, that scope remains authoritative; use this skill's evidence and quality gates without expanding the specialist review.\n\n## Review Process\n\n1. Read the pull request description and identify the intended behavior.\n2. Categorize the changed files and apply only the relevant guidance below.\n3. Review correctness and behavioral regressions first, then apply the relevant SDK-specific checks.\n4. Trace changes through callers, exports, tests, API reports, documentation, and package metadata when those relationships affect correctness.\n5. Inspect enough unchanged context to verify existing guards, invariants, and behavior before reporting a finding.\n\nFor changes outside `sdk/`, review correctness, security, and test coverage\nwithout imposing SDK-specific conventions.\n\n## Load Guidance Progressively\n\n| Changed surface or risk | Guidance |\n| --- | --- |\n| SDK source or public API | `.github/instructions/reviewer/sdk-source.instructions.md` and the [Azure SDK Python Design Guidelines](https://azure.github.io/azure-sdk/python_design.html) |\n| Tests or coverage implications | `.github/instructions/reviewer/testing.instructions.md` |\n| README, CHANGELOG, docstrings, or samples | `.github/instructions/reviewer/documentation.instructions.md` |\n| Packaging or dependencies | `.github/instructions/reviewer/dependencies.instructions.md` |\n| `sdk/*/azure-mgmt-*/` | `.github/instructions/reviewer/management.instructions.md` |\n\nManagement-specific review scope and rules take precedence over generic SDK\nguidance: skip `generated_samples/` and `generated_tests/`, and review only\n`_client.py` under `azure/mgmt/**/`. Read metadata and documentation needed to\ncheck the management rules. Do not apply the JavaScript repo's TypeScript,\npnpm, or API-report conventions to Python packages.\n\nGenerated output is usually not the fix location: identify the actionable\nTypeSpec, customization, or generator cause when evidence supports it. Do not\nspeculate about the upstream fix or mistake a preview-only API change for a\nbreaking change in a released stable API.\n\n## Findings\n\n- Report actionable, high-confidence issues with changed file/line, the\n observed behavior, the scenario in which it fails, and a concrete remedy.\n- Prioritize correctness, compatibility, and security over stylistic\n preferences. Do not claim a tool or test failure without running it.\n- Do not duplicate the same root cause across multiple files. If evidence is\n incomplete, state what could not be verified instead of guessing.\n- If there are no findings, say so briefly; do not pad the review with passing\n checks or generic suggestions.\n","frontmatter":{"name":"code-review","description":"Review pull requests and code changes in the Azure SDK for Python repository. USE FOR: GitHub Copilot code review; CCR; review pull request; review PR; review diff; find bugs or regressions introduced by a PR; cross-package SDK review. Finds high-confidence correctness, security, API compatibility, dependency, documentation, and test issues. DO NOT USE FOR: implementing fixes; running tests; fixing CI; releases; APIView feedback."},"isInternal":false,"tokens":660,"sizeBytes":3274},{"name":"SKILL.md","path":".github/skills/create-api-review/SKILL.md","rawUrl":"https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/.github/skills/create-api-review/SKILL.md","title":"create-api-review","category":"anthropic-skill","format":"markdown","content":"---\nname: create-api-review\nlicense: MIT\nmetadata:\n version: \"1.0.0\"\n distribution: shared\ndescription: 'Create an API review PR for an Azure SDK package using API Review Hub. **UTILITY SKILL**. USE FOR: \"create API review\", \"open API review\", \"compare package versions\", \"APIView PR\". DO NOT USE FOR: fixing APIView comments, SDK code generation, pipeline debugging. INVOKES: azure-sdk-mcp:azsdk_apireviewhub_request_review_pr.'\ncompatibility: \"azure-sdk-mcp server v0.6.32 or later\"\n---\n\n# Create API Review\n\nThis skill creates an API review pull request through API Review Hub for a package API surface comparison.\n\n## Triggers\n\nUSE FOR: create API review, open API review, compare package versions, APIView PR\nWHEN: \"create API review\", \"open API review\", \"compare package versions\", \"APIView PR\"\nDO NOT USE FOR: fixing APIView comments, SDK code generation, pipeline debugging\n\n## Rules\n\n- Requires `azure-sdk-mcp` version `0.6.32` or later.\n- Use `azure-sdk-mcp:azsdk_apireviewhub_request_review_pr` to create the review PR.\n- CLI equivalent is `azsdk api-review create`.\n- Language is fixed to `python` for this repository.\n- Required user inputs: `packageName`, `targetBranch`.\n- `baseTag` defines the baseline version. Use package tag format: `_`.\n- If `baseTag` is omitted, ask the user to choose one of:\n - Use the latest GA (non-beta) release tag for `packageName`.\n - Provide a specific tag or version to use as baseline.\n- Direct MCP calls require `targetRepo: azure-sdk-for-python`; `targetOwner` defaults to `Azure` unless explicitly provided (for example, a fork), so pass both explicitly when overriding defaults.\n- The CLI may supply repository defaults, but the MCP method does not.\n- `targetOwner`, `targetRepo`, and `targetBranch` define where the review PR branch is created.\n- Wait behavior mapping: `--no-wait` corresponds to `waitForCompletion: false`.\n- Poll behavior mapping: `--poll-interval-seconds` corresponds to `pollIntervalSeconds` (default `30`).\n- Optionally provide a ready-to-run `azsdk api-review create` command for the user with resolved values.\n\n## MCP Tools\n\n| Tool | Purpose |\n| ----------------------------------------------------- | ------------------------------- |\n| `azure-sdk-mcp:azsdk_apireviewhub_request_review_pr` | Create API review PR request |\n| `azure-sdk-mcp:azsdk_upgrade` | Check/upgrade MCP server version |\n\n## Steps\n\n1. **Collect Inputs** - Get required `packageName` and `targetBranch`. Optionally collect `baseTag`.\n2. **Prompt For Baseline** - If `baseTag` is not provided, ask the user to choose latest GA (non-beta) or provide a specific tag/version.\n3. **Resolve Baseline** - If the user chooses latest GA, resolve and use the latest GA (non-beta) release tag for `packageName`. If the user provides a tag/version, use that value.\n4. **Validate MCP Version** - Ensure `azure-sdk-mcp` is `0.6.32+`.\n5. **Set Wait Mode** - Default to wait for completion. Use `waitForCompletion: false` only when user asks for no-wait behavior.\n6. **Set Poll Interval** - If waiting for completion, use `pollIntervalSeconds` (default `30`, override only if requested).\n7. **Request Review PR** - Run `azure-sdk-mcp:azsdk_apireviewhub_request_review_pr` with `language: python`, `targetRepo: azure-sdk-for-python`, and `targetOwner` (default `Azure` unless explicitly provided), plus collected inputs.\n8. **Return Result** - Provide review PR URL and operation status.\n9. **Optional CLI Output** - If useful or requested, provide the equivalent `azsdk api-review create` command with all resolved arguments.\n\n## CLI Command Template\n\n```powershell\nazsdk api-review create `\n --language python `\n --package-name `\n --base-tag `\n --target-branch `\n --target-owner `\n --target-repo \n```\n\nOptional flags:\n\n- `--no-wait`\n- `--poll-interval-seconds 30`\n- `--output plain|json`\n\n## Example\n\nFor `azure-storage-blob` comparing `1.0.0` to the latest on main:\n\n- `packageName`: `azure-storage-blob`\n- `baseTag`: `azure-storage-blob_1.0.0`\n- `targetOwner`: `Azure`\n- `targetRepo`: `azure-sdk-for-python`\n- `targetBranch`: `main`\n\n## Troubleshooting\n\n- If tool is missing or unsupported, run `azure-sdk-mcp:azsdk_upgrade` with `checkOnly: true` to verify current version.\n- If `baseTag` is invalid, confirm the exact release tag name in the repository.\n- If `baseTag` is omitted, confirm the user's baseline choice before requesting the review PR.\n- If the generated review does not reflect expected changes, confirm `targetBranch` contains the intended newer API surface.\n","frontmatter":{"name":"create-api-review","license":"MIT","metadata":{"version":"1.0.0","distribution":"shared"},"description":"Create an API review PR for an Azure SDK package using API Review Hub. **UTILITY SKILL**. USE FOR: \"create API review\", \"open API review\", \"compare package versions\", \"APIView PR\". DO NOT USE FOR: fixing APIView comments, SDK code generation, pipeline debugging. INVOKES: azure-sdk-mcp:azsdk_apireviewhub_request_review_pr.","compatibility":"azure-sdk-mcp server v0.6.32 or later"},"isInternal":false,"tokens":1137,"sizeBytes":4708},{"name":"00-scan-package.md","path":".github/skills/create-package-skill/phases/00-scan-package.md","rawUrl":"https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/.github/skills/create-package-skill/phases/00-scan-package.md","title":"Phases Skill","category":"anthropic-skill","format":"markdown","content":"# Phases Skill\n\nPath: `.github/skills/create-package-skill/phases/00-scan-package.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/.github/skills/create-package-skill/phases/00-scan-package.md)","tokens":300,"sizeBytes":244},{"name":"01-scaffold-skill.md","path":".github/skills/create-package-skill/phases/01-scaffold-skill.md","rawUrl":"https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/.github/skills/create-package-skill/phases/01-scaffold-skill.md","title":"Phases Skill","category":"anthropic-skill","format":"markdown","content":"# Phases Skill\n\nPath: `.github/skills/create-package-skill/phases/01-scaffold-skill.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/.github/skills/create-package-skill/phases/01-scaffold-skill.md)","tokens":300,"sizeBytes":248},{"name":"02-generate-references.md","path":".github/skills/create-package-skill/phases/02-generate-references.md","rawUrl":"https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/.github/skills/create-package-skill/phases/02-generate-references.md","title":"Phases Skill","category":"anthropic-skill","format":"markdown","content":"# Phases Skill\n\nPath: `.github/skills/create-package-skill/phases/02-generate-references.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/.github/skills/create-package-skill/phases/02-generate-references.md)","tokens":300,"sizeBytes":258},{"name":"03-validate.md","path":".github/skills/create-package-skill/phases/03-validate.md","rawUrl":"https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/.github/skills/create-package-skill/phases/03-validate.md","title":"Phases Skill","category":"anthropic-skill","format":"markdown","content":"# Phases Skill\n\nPath: `.github/skills/create-package-skill/phases/03-validate.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/.github/skills/create-package-skill/phases/03-validate.md)","tokens":300,"sizeBytes":236},{"name":"04-finalize.md","path":".github/skills/create-package-skill/phases/04-finalize.md","rawUrl":"https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/.github/skills/create-package-skill/phases/04-finalize.md","title":"Phases Skill","category":"anthropic-skill","format":"markdown","content":"# Phases Skill\n\nPath: `.github/skills/create-package-skill/phases/04-finalize.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/.github/skills/create-package-skill/phases/04-finalize.md)","tokens":300,"sizeBytes":236},{"name":"skill-template.md","path":".github/skills/create-package-skill/references/skill-template.md","rawUrl":"https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/.github/skills/create-package-skill/references/skill-template.md","title":"References Skill","category":"anthropic-skill","format":"markdown","content":"# References Skill\n\nPath: `.github/skills/create-package-skill/references/skill-template.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/.github/skills/create-package-skill/references/skill-template.md)","tokens":300,"sizeBytes":254},{"name":"validation-tools.md","path":".github/skills/create-package-skill/references/validation-tools.md","rawUrl":"https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/.github/skills/create-package-skill/references/validation-tools.md","title":"References Skill","category":"anthropic-skill","format":"markdown","content":"# References Skill\n\nPath: `.github/skills/create-package-skill/references/validation-tools.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/.github/skills/create-package-skill/references/validation-tools.md)","tokens":300,"sizeBytes":258},{"name":"SKILL.md","path":".github/skills/create-package-skill/SKILL.md","rawUrl":"https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/.github/skills/create-package-skill/SKILL.md","title":"create-package-skill","category":"anthropic-skill","format":"markdown","content":"---\nname: create-package-skill\ndescription: '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.'\n---\n\n# Create Package Skill Wizard\n\n> **Minimal beats comprehensive. Human-written beats auto-generated. Scaffold and iterate.**\n\n> Skills encode tribal knowledge — the \"I wish someone had told me\" stuff that's hard to learn from just reading code. Focus on what's non-obvious and package-specific.\n\n## Interaction Protocols\n\n**CONFIRM Protocol** (asset-producing steps — creating files):\n1. PRESENT the proposed assets and explain why.\n2. ASK exactly one question: \"Create now (recommended), edit first, or skip?\"\n3. ACT immediately. Create → write files this turn. Edit → refine, re-ask. Skip → move on.\n\n**DECIDE Protocol** (informational/correction steps — no files created):\n1. PRESENT the information or findings.\n2. ASK one specific question appropriate to the decision.\n3. PROCEED based on the answer.\n\nOne question at a time. Respect \"skip\" — never re-ask or defer.\n\n## Wizard Flow\n\nRun each phase in order. **Progressive loading:** Read only the current phase file.\n\n| Phase | Description | Instructions |\n|---|---|---|\n| **Phase 0** | 🧭 Scan Package — detect architecture, customizations, key files | [phases/00-scan-package.md](phases/00-scan-package.md) |\n| **Phase 1** | 📝 Scaffold SKILL.md — generate skill with step-by-step post-regen workflow (Option A) or reference-manual structure (Option B) | [phases/01-scaffold-skill.md](phases/01-scaffold-skill.md) |\n| **Phase 2** | 📚 Generate References — create customizations.md (required) and optionally architecture.md | [phases/02-generate-references.md](phases/02-generate-references.md) |\n| **Phase 3** | Validate -- run vally lint | [phases/03-validate.md](phases/03-validate.md) |\n| **Phase 4** | 📋 Finalize — confirm discoverable location, summarize | [phases/04-finalize.md](phases/04-finalize.md) |\n\n## Guardrails\n\n**Content:**\n- Every line must be non-obvious and package-specific. No generic Python/SDK boilerplate.\n- SKILL.md should be under 500 tokens (soft limit). Move details to references/.\n- References under 1000 tokens each. Split if larger.\n- Never duplicate repository-wide guidance from `AGENTS.md` or shared skills.\n\n**Relationship to existing SDK tools:**\n- Package skills **complement** the Azure SDK MCP tools (`azsdk_package_generate_code`, `azsdk_package_build_code`, `azsdk_customized_code_update`, etc.) — they do NOT replace them.\n- MCP tools handle deterministic operations (generate, build, test). Package skills provide the reasoning context an agent needs to use those tools correctly for a specific package, plus the package-specific verification commands the tools do not know about.\n- Reference the existing tools for the overall workflow (e.g., \"Run `tsp-client update` or `azsdk_package_generate_code`\"), but DO include the copy-pasteable verification commands an agent needs: import smoke tests (`python -c \"from ... import ...\"`), `ApiVersion` reconciliation (`grep`, `python -c \"import json; ...\"`), diff commands (`git diff --name-only | grep ...`), and the package validation invocation (`azsdk_package_run_check with checkType=\"All\"`).\n- Never paraphrase an MCP tool's entire contract. Do include the one-line invocations the agent will run.\n\n**Structure:**\n- Skill directory: `sdk///.github/skills//`\n- Directory name MUST match `name` field in frontmatter (vally lint enforces this).\n- `name` is the distribution package name, e.g. `azure-search-documents`, `azure-ai-projects`, `azure-mgmt-appconfiguration`.\n- Use semicolons to separate trigger phrases in description (YAML-safe).\n\n**Security:**\n- Never embed secrets or credentials in skill content.\n- Never instruct agents to bypass CI, pylint, mypy, pyright, or other gating tools.\n- Never instruct agents to edit files inside `_generated/` (or any file with the `\"Code generated by Microsoft (R) Python Code Generator\"` header) — always route through `_patch.py` or sibling hand-written modules.\n\n## Key Principles (from eval data)\n\nOur eval showed that skill **structure** matters more than **volume**:\n\n| Pattern | Impact |\n|---|---|\n| Numbered step-by-step post-regen workflow (Option A) | Agent executes verification top-to-bottom without inventing steps |\n| Copy-pasteable verification commands (import smoke tests, `ApiVersion` reconciliation, git diff of generated operations/models) | Agent actually runs the checks instead of guessing whether customizations still work |\n| \"Expose new generated methods through `_patch.py`\" step (mixin inheritance / override / polymorphic / create-or-update / list / `__all__` re-export) | Agent wires new generated operations into the public surface instead of leaving them unreachable |\n| \"Check `_patch.py` FIRST\" directives | Changes agent default from \"fix the error location\" to \"check the customization layer\" |\n| Per-file `Depends On` / `Defines` / `After Regeneration, Verify` inventory in `customizations.md` | Agent can pinpoint exactly which generated symbol a breakage maps to |\n| Generated-file detection guidance (directory OR header comment) | Agent correctly identifies auto-generated files under both `_generated/` and inline layouts |\n| Async parity checklist | Agent remembers to mirror sync changes into `aio/` |\n| CHANGELOG / README update step | Prevents \"silent\" releases that ship new operations without docs |\n\n## References (load on demand)\n\n- [references/skill-template.md](references/skill-template.md) -- SKILL.md template with required sections\n- [references/validation-tools.md](references/validation-tools.md) -- vally lint, CI workflow setup\n","frontmatter":{"name":"create-package-skill","description":"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."},"isInternal":false,"tokens":1385,"sizeBytes":6129},{"name":"SKILL.md","path":".github/skills/eng/next-version-update/SKILL.md","rawUrl":"https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/.github/skills/eng/next-version-update/SKILL.md","title":"next-version-update","category":"anthropic-skill","format":"markdown","content":"# next-version-update\n\nPath: `.github/skills/eng/next-version-update/SKILL.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/.github/skills/eng/next-version-update/SKILL.md)","tokens":300,"sizeBytes":223},{"name":"SKILL.md","path":".github/skills/find-package-skill/SKILL.md","rawUrl":"https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/.github/skills/find-package-skill/SKILL.md","title":"find-package-skill","category":"anthropic-skill","format":"markdown","content":"---\nname: find-package-skill\ndescription: '**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\".'\n---\n\n# Find Package Skill\n\nSome SDK packages in this monorepo have **package-specific skills** — tribal\nknowledge (architecture, data flows, type mappings, pitfalls) that prevents\ncommon mistakes. Before modifying any SDK package, check whether a skill exists\nfor it using the steps below.\n\n## How to Discover Package Skills\n\n1. **Determine the package directory.** If you already know the file path you're\n modifying, extract the package directory from it (e.g., a file at\n `sdk/search/azure-search-documents/azure/search/documents/_search_client.py`\n belongs to the package at `sdk/search/azure-search-documents/`). If you only\n have a package name, search for a matching directory under `sdk/` (package\n directories are named after the distribution package name, e.g.,\n `azure-search-documents` → `sdk/search/azure-search-documents/`).\n\n2. **Check for a `.github/skills/` directory** inside the package directory. For\n example, check whether `sdk/search/azure-search-documents/.github/skills/` exists.\n\n3. **If it exists**, read every `SKILL.md` found under that directory. If a\n `references/` subdirectory exists next to a `SKILL.md`, read all files in it\n too for additional context.\n\n4. **If no `.github/skills/` directory exists** for the package, no\n package-specific skill has been created yet — proceed normally.","frontmatter":{"name":"find-package-skill","description":"**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\"."},"isInternal":false,"tokens":390,"sizeBytes":1697},{"name":"SKILL.md","path":".github/skills/fix-black/SKILL.md","rawUrl":"https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/.github/skills/fix-black/SKILL.md","title":"fix-black","category":"anthropic-skill","format":"markdown","content":"# fix-black\n\nPath: `.github/skills/fix-black/SKILL.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/.github/skills/fix-black/SKILL.md)","tokens":300,"sizeBytes":185},{"name":"SKILL.md","path":".github/skills/fix-mypy/SKILL.md","rawUrl":"https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/.github/skills/fix-mypy/SKILL.md","title":"fix-mypy","category":"anthropic-skill","format":"markdown","content":"# fix-mypy\n\nPath: `.github/skills/fix-mypy/SKILL.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/.github/skills/fix-mypy/SKILL.md)","tokens":300,"sizeBytes":182},{"name":"SKILL.md","path":".github/skills/fix-pylint/SKILL.md","rawUrl":"https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/.github/skills/fix-pylint/SKILL.md","title":"fix-pylint","category":"anthropic-skill","format":"markdown","content":"# fix-pylint\n\nPath: `.github/skills/fix-pylint/SKILL.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/.github/skills/fix-pylint/SKILL.md)","tokens":300,"sizeBytes":188},{"name":"SKILL.md","path":".github/skills/fix-sphinx/SKILL.md","rawUrl":"https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/.github/skills/fix-sphinx/SKILL.md","title":"fix-sphinx","category":"anthropic-skill","format":"markdown","content":"# fix-sphinx\n\nPath: `.github/skills/fix-sphinx/SKILL.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/.github/skills/fix-sphinx/SKILL.md)","tokens":300,"sizeBytes":188},{"name":"SKILL.md","path":".github/skills/generate-api-markdown/SKILL.md","rawUrl":"https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/.github/skills/generate-api-markdown/SKILL.md","title":"generate-api-markdown","category":"anthropic-skill","format":"markdown","content":"# generate-api-markdown\n\nPath: `.github/skills/generate-api-markdown/SKILL.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/.github/skills/generate-api-markdown/SKILL.md)","tokens":300,"sizeBytes":221},{"name":"SKILL.md","path":".github/skills/ml/do-code-review/SKILL.md","rawUrl":"https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/.github/skills/ml/do-code-review/SKILL.md","title":"do-code-review","category":"anthropic-skill","format":"markdown","content":"# do-code-review\n\nPath: `.github/skills/ml/do-code-review/SKILL.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/.github/skills/ml/do-code-review/SKILL.md)","tokens":300,"sizeBytes":206},{"name":"SKILL.md","path":".github/skills/ml/fix-mypy/SKILL.md","rawUrl":"https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/.github/skills/ml/fix-mypy/SKILL.md","title":"fix-mypy","category":"anthropic-skill","format":"markdown","content":"# fix-mypy\n\nPath: `.github/skills/ml/fix-mypy/SKILL.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/.github/skills/ml/fix-mypy/SKILL.md)","tokens":300,"sizeBytes":188},{"name":"SKILL.md","path":".github/skills/ml/fix-pylint/SKILL.md","rawUrl":"https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/.github/skills/ml/fix-pylint/SKILL.md","title":"fix-pylint","category":"anthropic-skill","format":"markdown","content":"# fix-pylint\n\nPath: `.github/skills/ml/fix-pylint/SKILL.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/.github/skills/ml/fix-pylint/SKILL.md)","tokens":300,"sizeBytes":194},{"name":"trigger.eval.yaml","path":".github/skills/sdk-health/evals/trigger.eval.yaml","rawUrl":"https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/.github/skills/sdk-health/evals/trigger.eval.yaml","title":"Evals Skill","category":"anthropic-skill","format":"yaml","content":"# Evals Skill\n\nPath: `.github/skills/sdk-health/evals/trigger.eval.yaml`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/.github/skills/sdk-health/evals/trigger.eval.yaml)","tokens":300,"sizeBytes":219},{"name":"SKILL.md","path":".github/skills/sdk-health/SKILL.md","rawUrl":"https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/.github/skills/sdk-health/SKILL.md","title":"sdk-health","category":"anthropic-skill","format":"markdown","content":"# sdk-health\n\nPath: `.github/skills/sdk-health/SKILL.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/.github/skills/sdk-health/SKILL.md)","tokens":300,"sizeBytes":188},{"name":"changelog_generics.md","path":"eng/tools/azure-sdk-tools/changelog_generics.md","rawUrl":"https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/eng/tools/azure-sdk-tools/changelog_generics.md","title":"Azure-sdk-tools Skill","category":"anthropic-skill","format":"markdown","content":"# Azure-sdk-tools Skill\n\nPath: `eng/tools/azure-sdk-tools/changelog_generics.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/eng/tools/azure-sdk-tools/changelog_generics.md)","tokens":300,"sizeBytes":225},{"name":"CHANGELOG.md","path":"eng/tools/azure-sdk-tools/packaging_tools/templates/packaging_files/CHANGELOG.md","rawUrl":"https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/eng/tools/azure-sdk-tools/packaging_tools/templates/packaging_files/CHANGELOG.md","title":"Packaging_files Skill","category":"anthropic-skill","format":"markdown","content":"# Packaging_files Skill\n\nPath: `eng/tools/azure-sdk-tools/packaging_tools/templates/packaging_files/CHANGELOG.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/eng/tools/azure-sdk-tools/packaging_tools/templates/packaging_files/CHANGELOG.md)","tokens":300,"sizeBytes":291},{"name":"azure-mgmt-containerservice-41.4.0b1-CHANGELOG.md","path":"eng/tools/azure-sdk-tools/tests/data/azure-mgmt-containerservice-41.4.0b1-CHANGELOG.md","rawUrl":"https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/eng/tools/azure-sdk-tools/tests/data/azure-mgmt-containerservice-41.4.0b1-CHANGELOG.md","title":"Data Skill","category":"anthropic-skill","format":"markdown","content":"# Data Skill\n\nPath: `eng/tools/azure-sdk-tools/tests/data/azure-mgmt-containerservice-41.4.0b1-CHANGELOG.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/eng/tools/azure-sdk-tools/tests/data/azure-mgmt-containerservice-41.4.0b1-CHANGELOG.md)","tokens":300,"sizeBytes":292},{"name":"azure-mgmt-containerservice-41.4.0b1-CHANGELOG.trimmed.md","path":"eng/tools/azure-sdk-tools/tests/data/azure-mgmt-containerservice-41.4.0b1-CHANGELOG.trimmed.md","rawUrl":"https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/eng/tools/azure-sdk-tools/tests/data/azure-mgmt-containerservice-41.4.0b1-CHANGELOG.trimmed.md","title":"Data Skill","category":"anthropic-skill","format":"markdown","content":"# Data Skill\n\nPath: `eng/tools/azure-sdk-tools/tests/data/azure-mgmt-containerservice-41.4.0b1-CHANGELOG.trimmed.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/eng/tools/azure-sdk-tools/tests/data/azure-mgmt-containerservice-41.4.0b1-CHANGELOG.trimmed.md)","tokens":300,"sizeBytes":308},{"name":"azure-mgmt-cosmosdb-10.0.0b6-CHANGELOG.md","path":"eng/tools/azure-sdk-tools/tests/data/azure-mgmt-cosmosdb-10.0.0b6-CHANGELOG.md","rawUrl":"https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/eng/tools/azure-sdk-tools/tests/data/azure-mgmt-cosmosdb-10.0.0b6-CHANGELOG.md","title":"Data Skill","category":"anthropic-skill","format":"markdown","content":"# Data Skill\n\nPath: `eng/tools/azure-sdk-tools/tests/data/azure-mgmt-cosmosdb-10.0.0b6-CHANGELOG.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/eng/tools/azure-sdk-tools/tests/data/azure-mgmt-cosmosdb-10.0.0b6-CHANGELOG.md)","tokens":300,"sizeBytes":276},{"name":"azure-mgmt-cosmosdb-10.0.0b6-CHANGELOG.trimmed.md","path":"eng/tools/azure-sdk-tools/tests/data/azure-mgmt-cosmosdb-10.0.0b6-CHANGELOG.trimmed.md","rawUrl":"https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/eng/tools/azure-sdk-tools/tests/data/azure-mgmt-cosmosdb-10.0.0b6-CHANGELOG.trimmed.md","title":"Data Skill","category":"anthropic-skill","format":"markdown","content":"# Data Skill\n\nPath: `eng/tools/azure-sdk-tools/tests/data/azure-mgmt-cosmosdb-10.0.0b6-CHANGELOG.trimmed.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/eng/tools/azure-sdk-tools/tests/data/azure-mgmt-cosmosdb-10.0.0b6-CHANGELOG.trimmed.md)","tokens":300,"sizeBytes":292},{"name":"azure-mgmt-datafactory-10.0.0b1-CHANGELOG.md","path":"eng/tools/azure-sdk-tools/tests/data/azure-mgmt-datafactory-10.0.0b1-CHANGELOG.md","rawUrl":"https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/eng/tools/azure-sdk-tools/tests/data/azure-mgmt-datafactory-10.0.0b1-CHANGELOG.md","title":"Data Skill","category":"anthropic-skill","format":"markdown","content":"# Data Skill\n\nPath: `eng/tools/azure-sdk-tools/tests/data/azure-mgmt-datafactory-10.0.0b1-CHANGELOG.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/eng/tools/azure-sdk-tools/tests/data/azure-mgmt-datafactory-10.0.0b1-CHANGELOG.md)","tokens":300,"sizeBytes":282},{"name":"azure-mgmt-datafactory-10.0.0b1-CHANGELOG.trimmed.md","path":"eng/tools/azure-sdk-tools/tests/data/azure-mgmt-datafactory-10.0.0b1-CHANGELOG.trimmed.md","rawUrl":"https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/eng/tools/azure-sdk-tools/tests/data/azure-mgmt-datafactory-10.0.0b1-CHANGELOG.trimmed.md","title":"Data Skill","category":"anthropic-skill","format":"markdown","content":"# Data Skill\n\nPath: `eng/tools/azure-sdk-tools/tests/data/azure-mgmt-datafactory-10.0.0b1-CHANGELOG.trimmed.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/eng/tools/azure-sdk-tools/tests/data/azure-mgmt-datafactory-10.0.0b1-CHANGELOG.trimmed.md)","tokens":300,"sizeBytes":298},{"name":"azure-mgmt-network-31.0.0-CHANGELOG.md","path":"eng/tools/azure-sdk-tools/tests/data/azure-mgmt-network-31.0.0-CHANGELOG.md","rawUrl":"https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/eng/tools/azure-sdk-tools/tests/data/azure-mgmt-network-31.0.0-CHANGELOG.md","title":"Data Skill","category":"anthropic-skill","format":"markdown","content":"# Data Skill\n\nPath: `eng/tools/azure-sdk-tools/tests/data/azure-mgmt-network-31.0.0-CHANGELOG.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/eng/tools/azure-sdk-tools/tests/data/azure-mgmt-network-31.0.0-CHANGELOG.md)","tokens":300,"sizeBytes":270},{"name":"azure-mgmt-network-31.0.0-CHANGELOG.trimmed.md","path":"eng/tools/azure-sdk-tools/tests/data/azure-mgmt-network-31.0.0-CHANGELOG.trimmed.md","rawUrl":"https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/eng/tools/azure-sdk-tools/tests/data/azure-mgmt-network-31.0.0-CHANGELOG.trimmed.md","title":"Data Skill","category":"anthropic-skill","format":"markdown","content":"# Data Skill\n\nPath: `eng/tools/azure-sdk-tools/tests/data/azure-mgmt-network-31.0.0-CHANGELOG.trimmed.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/eng/tools/azure-sdk-tools/tests/data/azure-mgmt-network-31.0.0-CHANGELOG.trimmed.md)","tokens":300,"sizeBytes":286},{"name":"azure-mgmt-sql-4.0.0-CHANGELOG.md","path":"eng/tools/azure-sdk-tools/tests/data/azure-mgmt-sql-4.0.0-CHANGELOG.md","rawUrl":"https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/eng/tools/azure-sdk-tools/tests/data/azure-mgmt-sql-4.0.0-CHANGELOG.md","title":"Data Skill","category":"anthropic-skill","format":"markdown","content":"# Data Skill\n\nPath: `eng/tools/azure-sdk-tools/tests/data/azure-mgmt-sql-4.0.0-CHANGELOG.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/eng/tools/azure-sdk-tools/tests/data/azure-mgmt-sql-4.0.0-CHANGELOG.md)","tokens":300,"sizeBytes":260},{"name":"azure-mgmt-sql-4.0.0-CHANGELOG.trimmed.md","path":"eng/tools/azure-sdk-tools/tests/data/azure-mgmt-sql-4.0.0-CHANGELOG.trimmed.md","rawUrl":"https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/eng/tools/azure-sdk-tools/tests/data/azure-mgmt-sql-4.0.0-CHANGELOG.trimmed.md","title":"Data Skill","category":"anthropic-skill","format":"markdown","content":"# Data Skill\n\nPath: `eng/tools/azure-sdk-tools/tests/data/azure-mgmt-sql-4.0.0-CHANGELOG.trimmed.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/eng/tools/azure-sdk-tools/tests/data/azure-mgmt-sql-4.0.0-CHANGELOG.trimmed.md)","tokens":300,"sizeBytes":276},{"name":"README_missing_snippet.md","path":"eng/tools/azure-sdk-tools/tests/integration/scenarios/snippet-updater/README_missing_snippet.md","rawUrl":"https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/eng/tools/azure-sdk-tools/tests/integration/scenarios/snippet-updater/README_missing_snippet.md","title":"Snippet-updater Skill","category":"anthropic-skill","format":"markdown","content":"# Snippet-updater Skill\n\nPath: `eng/tools/azure-sdk-tools/tests/integration/scenarios/snippet-updater/README_missing_snippet.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/eng/tools/azure-sdk-tools/tests/integration/scenarios/snippet-updater/README_missing_snippet.md)","tokens":300,"sizeBytes":321},{"name":"README_out_of_sync.md","path":"eng/tools/azure-sdk-tools/tests/integration/scenarios/snippet-updater/README_out_of_sync.md","rawUrl":"https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/eng/tools/azure-sdk-tools/tests/integration/scenarios/snippet-updater/README_out_of_sync.md","title":"Snippet-updater Skill","category":"anthropic-skill","format":"markdown","content":"# Snippet-updater Skill\n\nPath: `eng/tools/azure-sdk-tools/tests/integration/scenarios/snippet-updater/README_out_of_sync.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/eng/tools/azure-sdk-tools/tests/integration/scenarios/snippet-updater/README_out_of_sync.md)","tokens":300,"sizeBytes":313},{"name":"diff-api-surface.prompt.md","path":"sdk/ai/azure-ai-projects/.github/skills/azure-ai-projects-author-samples/prompts/diff-api-surface.prompt.md","rawUrl":"https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/sdk/ai/azure-ai-projects/.github/skills/azure-ai-projects-author-samples/prompts/diff-api-surface.prompt.md","title":"Prompts Skill","category":"anthropic-skill","format":"markdown","content":"# Prompts Skill\n\nPath: `sdk/ai/azure-ai-projects/.github/skills/azure-ai-projects-author-samples/prompts/diff-api-surface.prompt.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/sdk/ai/azure-ai-projects/.github/skills/azure-ai-projects-author-samples/prompts/diff-api-surface.prompt.md)","tokens":300,"sizeBytes":337},{"name":"sample-conventions.md","path":"sdk/ai/azure-ai-projects/.github/skills/azure-ai-projects-author-samples/references/sample-conventions.md","rawUrl":"https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/sdk/ai/azure-ai-projects/.github/skills/azure-ai-projects-author-samples/references/sample-conventions.md","title":"References Skill","category":"anthropic-skill","format":"markdown","content":"# References Skill\n\nPath: `sdk/ai/azure-ai-projects/.github/skills/azure-ai-projects-author-samples/references/sample-conventions.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/sdk/ai/azure-ai-projects/.github/skills/azure-ai-projects-author-samples/references/sample-conventions.md)","tokens":300,"sizeBytes":336},{"name":"SKILL.md","path":"sdk/ai/azure-ai-projects/.github/skills/azure-ai-projects-author-samples/SKILL.md","rawUrl":"https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/sdk/ai/azure-ai-projects/.github/skills/azure-ai-projects-author-samples/SKILL.md","title":"azure-ai-projects-author-samples","category":"anthropic-skill","format":"markdown","content":"# azure-ai-projects-author-samples\n\nPath: `sdk/ai/azure-ai-projects/.github/skills/azure-ai-projects-author-samples/SKILL.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/sdk/ai/azure-ai-projects/.github/skills/azure-ai-projects-author-samples/SKILL.md)","tokens":300,"sizeBytes":304},{"name":"test-conventions.md","path":"sdk/ai/azure-ai-projects/.github/skills/azure-ai-projects-author-tests/references/test-conventions.md","rawUrl":"https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/sdk/ai/azure-ai-projects/.github/skills/azure-ai-projects-author-tests/references/test-conventions.md","title":"References Skill","category":"anthropic-skill","format":"markdown","content":"# References Skill\n\nPath: `sdk/ai/azure-ai-projects/.github/skills/azure-ai-projects-author-tests/references/test-conventions.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/sdk/ai/azure-ai-projects/.github/skills/azure-ai-projects-author-tests/references/test-conventions.md)","tokens":300,"sizeBytes":328},{"name":"SKILL.md","path":"sdk/ai/azure-ai-projects/.github/skills/azure-ai-projects-author-tests/SKILL.md","rawUrl":"https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/sdk/ai/azure-ai-projects/.github/skills/azure-ai-projects-author-tests/SKILL.md","title":"azure-ai-projects-author-tests","category":"anthropic-skill","format":"markdown","content":"# azure-ai-projects-author-tests\n\nPath: `sdk/ai/azure-ai-projects/.github/skills/azure-ai-projects-author-tests/SKILL.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/sdk/ai/azure-ai-projects/.github/skills/azure-ai-projects-author-tests/SKILL.md)","tokens":300,"sizeBytes":298},{"name":"SKILL.md","path":"sdk/ai/azure-ai-projects/.github/skills/azure-ai-projects-emit-from-typespec/SKILL.md","rawUrl":"https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/sdk/ai/azure-ai-projects/.github/skills/azure-ai-projects-emit-from-typespec/SKILL.md","title":"azure-ai-projects-emit-from-typespec","category":"anthropic-skill","format":"markdown","content":"# azure-ai-projects-emit-from-typespec\n\nPath: `sdk/ai/azure-ai-projects/.github/skills/azure-ai-projects-emit-from-typespec/SKILL.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/sdk/ai/azure-ai-projects/.github/skills/azure-ai-projects-emit-from-typespec/SKILL.md)","tokens":300,"sizeBytes":316},{"name":"SKILL.md","path":"sdk/ai/azure-ai-projects/.github/skills/azure-ai-projects-model-reference-graph/SKILL.md","rawUrl":"https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/sdk/ai/azure-ai-projects/.github/skills/azure-ai-projects-model-reference-graph/SKILL.md","title":"azure-ai-projects-model-reference-graph","category":"anthropic-skill","format":"markdown","content":"# azure-ai-projects-model-reference-graph\n\nPath: `sdk/ai/azure-ai-projects/.github/skills/azure-ai-projects-model-reference-graph/SKILL.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/sdk/ai/azure-ai-projects/.github/skills/azure-ai-projects-model-reference-graph/SKILL.md)","tokens":300,"sizeBytes":325},{"name":"SKILL.md","path":"sdk/ai/azure-ai-projects/.github/skills/azure-ai-projects-run-issue-regeneration/SKILL.md","rawUrl":"https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/sdk/ai/azure-ai-projects/.github/skills/azure-ai-projects-run-issue-regeneration/SKILL.md","title":"azure-ai-projects-run-issue-regeneration","category":"anthropic-skill","format":"markdown","content":"# azure-ai-projects-run-issue-regeneration\n\nPath: `sdk/ai/azure-ai-projects/.github/skills/azure-ai-projects-run-issue-regeneration/SKILL.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/sdk/ai/azure-ai-projects/.github/skills/azure-ai-projects-run-issue-regeneration/SKILL.md)","tokens":300,"sizeBytes":328},{"name":"SKILL.md","path":"sdk/ai/azure-ai-projects/.github/skills/azure-ai-projects-update-changelog/SKILL.md","rawUrl":"https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/sdk/ai/azure-ai-projects/.github/skills/azure-ai-projects-update-changelog/SKILL.md","title":"azure-ai-projects-update-changelog","category":"anthropic-skill","format":"markdown","content":"# azure-ai-projects-update-changelog\n\nPath: `sdk/ai/azure-ai-projects/.github/skills/azure-ai-projects-update-changelog/SKILL.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/sdk/ai/azure-ai-projects/.github/skills/azure-ai-projects-update-changelog/SKILL.md)","tokens":300,"sizeBytes":310},{"name":"README.md","path":"sdk/ai/azure-ai-projects/.github/skills/README.md","rawUrl":"https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/sdk/ai/azure-ai-projects/.github/skills/README.md","title":"Skills Skill","category":"anthropic-skill","format":"markdown","content":"# Skills Skill\n\nPath: `sdk/ai/azure-ai-projects/.github/skills/README.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/sdk/ai/azure-ai-projects/.github/skills/README.md)","tokens":300,"sizeBytes":220},{"name":"tripadvisor_openapi.json","path":"sdk/ai/azure-ai-projects/samples/agents/assets/tripadvisor_openapi.json","rawUrl":"https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/sdk/ai/azure-ai-projects/samples/agents/assets/tripadvisor_openapi.json","title":"Assets Skill","category":"anthropic-skill","format":"json","content":"# Assets Skill\n\nPath: `sdk/ai/azure-ai-projects/samples/agents/assets/tripadvisor_openapi.json`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/sdk/ai/azure-ai-projects/samples/agents/assets/tripadvisor_openapi.json)","tokens":300,"sizeBytes":264},{"name":"weather_openapi.json","path":"sdk/ai/azure-ai-projects/samples/agents/assets/weather_openapi.json","rawUrl":"https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/sdk/ai/azure-ai-projects/samples/agents/assets/weather_openapi.json","title":"Assets Skill","category":"anthropic-skill","format":"json","content":"# Assets Skill\n\nPath: `sdk/ai/azure-ai-projects/samples/agents/assets/weather_openapi.json`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/sdk/ai/azure-ai-projects/samples/agents/assets/weather_openapi.json)","tokens":300,"sizeBytes":256},{"name":"SKILL.md","path":"sdk/ai/azure-ai-projects/samples/skills/assets/canvas-design/SKILL.md","rawUrl":"https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/sdk/ai/azure-ai-projects/samples/skills/assets/canvas-design/SKILL.md","title":"canvas-design","category":"anthropic-skill","format":"markdown","content":"# canvas-design\n\nPath: `sdk/ai/azure-ai-projects/samples/skills/assets/canvas-design/SKILL.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/sdk/ai/azure-ai-projects/samples/skills/assets/canvas-design/SKILL.md)","tokens":300,"sizeBytes":261},{"name":"SKILL.md","path":"sdk/ai/azure-ai-projects/samples/skills/assets/team-status-update/SKILL.md","rawUrl":"https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/sdk/ai/azure-ai-projects/samples/skills/assets/team-status-update/SKILL.md","title":"team-status-update","category":"anthropic-skill","format":"markdown","content":"# team-status-update\n\nPath: `sdk/ai/azure-ai-projects/samples/skills/assets/team-status-update/SKILL.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/sdk/ai/azure-ai-projects/samples/skills/assets/team-status-update/SKILL.md)","tokens":300,"sizeBytes":276},{"name":"status-update-template.md","path":"sdk/ai/azure-ai-projects/samples/skills/assets/team-status-update/status-update-template.md","rawUrl":"https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/sdk/ai/azure-ai-projects/samples/skills/assets/team-status-update/status-update-template.md","title":"Team-status-update Skill","category":"anthropic-skill","format":"markdown","content":"# Team-status-update Skill\n\nPath: `sdk/ai/azure-ai-projects/samples/skills/assets/team-status-update/status-update-template.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/sdk/ai/azure-ai-projects/samples/skills/assets/team-status-update/status-update-template.md)","tokens":300,"sizeBytes":316},{"name":"README.md","path":"sdk/contentunderstanding/azure-ai-contentunderstanding/.github/skills/_shared/README.md","rawUrl":"https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/sdk/contentunderstanding/azure-ai-contentunderstanding/.github/skills/_shared/README.md","title":"_shared Skill","category":"anthropic-skill","format":"markdown","content":"# _shared Skill\n\nPath: `sdk/contentunderstanding/azure-ai-contentunderstanding/.github/skills/_shared/README.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/sdk/contentunderstanding/azure-ai-contentunderstanding/.github/skills/_shared/README.md)","tokens":300,"sizeBytes":297},{"name":"SKILL.md","path":"sdk/contentunderstanding/azure-ai-contentunderstanding/.github/skills/cu-sdk-author-analyzer-classify-route/SKILL.md","rawUrl":"https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/sdk/contentunderstanding/azure-ai-contentunderstanding/.github/skills/cu-sdk-author-analyzer-classify-route/SKILL.md","title":"cu-sdk-author-analyzer-classify-route","category":"anthropic-skill","format":"markdown","content":"# cu-sdk-author-analyzer-classify-route\n\nPath: `sdk/contentunderstanding/azure-ai-contentunderstanding/.github/skills/cu-sdk-author-analyzer-classify-route/SKILL.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/sdk/contentunderstanding/azure-ai-contentunderstanding/.github/skills/cu-sdk-author-analyzer-classify-route/SKILL.md)","tokens":300,"sizeBytes":379},{"name":"classifier_template.json","path":"sdk/contentunderstanding/azure-ai-contentunderstanding/.github/skills/cu-sdk-author-analyzer-classify-route/templates/classifier_template.json","rawUrl":"https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/sdk/contentunderstanding/azure-ai-contentunderstanding/.github/skills/cu-sdk-author-analyzer-classify-route/templates/classifier_template.json","title":"Templates Skill","category":"anthropic-skill","format":"json","content":"# Templates Skill\n\nPath: `sdk/contentunderstanding/azure-ai-contentunderstanding/.github/skills/cu-sdk-author-analyzer-classify-route/templates/classifier_template.json`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/sdk/contentunderstanding/azure-ai-contentunderstanding/.github/skills/cu-sdk-author-analyzer-classify-route/templates/classifier_template.json)","tokens":300,"sizeBytes":409},{"name":"README.md","path":"sdk/contentunderstanding/azure-ai-contentunderstanding/.github/skills/cu-sdk-author-analyzer/scripts/README.md","rawUrl":"https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/sdk/contentunderstanding/azure-ai-contentunderstanding/.github/skills/cu-sdk-author-analyzer/scripts/README.md","title":"Scripts Skill","category":"anthropic-skill","format":"markdown","content":"# Scripts Skill\n\nPath: `sdk/contentunderstanding/azure-ai-contentunderstanding/.github/skills/cu-sdk-author-analyzer/scripts/README.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/sdk/contentunderstanding/azure-ai-contentunderstanding/.github/skills/cu-sdk-author-analyzer/scripts/README.md)","tokens":300,"sizeBytes":343},{"name":"SKILL.md","path":"sdk/contentunderstanding/azure-ai-contentunderstanding/.github/skills/cu-sdk-author-analyzer/SKILL.md","rawUrl":"https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/sdk/contentunderstanding/azure-ai-contentunderstanding/.github/skills/cu-sdk-author-analyzer/SKILL.md","title":"cu-sdk-author-analyzer","category":"anthropic-skill","format":"markdown","content":"# cu-sdk-author-analyzer\n\nPath: `sdk/contentunderstanding/azure-ai-contentunderstanding/.github/skills/cu-sdk-author-analyzer/SKILL.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/sdk/contentunderstanding/azure-ai-contentunderstanding/.github/skills/cu-sdk-author-analyzer/SKILL.md)","tokens":300,"sizeBytes":334},{"name":"schema_template.json","path":"sdk/contentunderstanding/azure-ai-contentunderstanding/.github/skills/cu-sdk-author-analyzer/templates/schema_template.json","rawUrl":"https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/sdk/contentunderstanding/azure-ai-contentunderstanding/.github/skills/cu-sdk-author-analyzer/templates/schema_template.json","title":"Templates Skill","category":"anthropic-skill","format":"json","content":"# Templates Skill\n\nPath: `sdk/contentunderstanding/azure-ai-contentunderstanding/.github/skills/cu-sdk-author-analyzer/templates/schema_template.json`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/sdk/contentunderstanding/azure-ai-contentunderstanding/.github/skills/cu-sdk-author-analyzer/templates/schema_template.json)","tokens":300,"sizeBytes":371},{"name":"SKILL.md","path":"sdk/contentunderstanding/azure-ai-contentunderstanding/.github/skills/cu-sdk-common-knowledge/SKILL.md","rawUrl":"https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/sdk/contentunderstanding/azure-ai-contentunderstanding/.github/skills/cu-sdk-common-knowledge/SKILL.md","title":"cu-sdk-common-knowledge","category":"anthropic-skill","format":"markdown","content":"# cu-sdk-common-knowledge\n\nPath: `sdk/contentunderstanding/azure-ai-contentunderstanding/.github/skills/cu-sdk-common-knowledge/SKILL.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/sdk/contentunderstanding/azure-ai-contentunderstanding/.github/skills/cu-sdk-common-knowledge/SKILL.md)","tokens":300,"sizeBytes":337},{"name":"SKILL.md","path":"sdk/contentunderstanding/azure-ai-contentunderstanding/.github/skills/cu-sdk-sample-run/SKILL.md","rawUrl":"https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/sdk/contentunderstanding/azure-ai-contentunderstanding/.github/skills/cu-sdk-sample-run/SKILL.md","title":"cu-sdk-sample-run","category":"anthropic-skill","format":"markdown","content":"# cu-sdk-sample-run\n\nPath: `sdk/contentunderstanding/azure-ai-contentunderstanding/.github/skills/cu-sdk-sample-run/SKILL.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/sdk/contentunderstanding/azure-ai-contentunderstanding/.github/skills/cu-sdk-sample-run/SKILL.md)","tokens":300,"sizeBytes":319},{"name":"SKILL.md","path":"sdk/contentunderstanding/azure-ai-contentunderstanding/.github/skills/cu-sdk-setup/SKILL.md","rawUrl":"https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/sdk/contentunderstanding/azure-ai-contentunderstanding/.github/skills/cu-sdk-setup/SKILL.md","title":"cu-sdk-setup","category":"anthropic-skill","format":"markdown","content":"# cu-sdk-setup\n\nPath: `sdk/contentunderstanding/azure-ai-contentunderstanding/.github/skills/cu-sdk-setup/SKILL.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/sdk/contentunderstanding/azure-ai-contentunderstanding/.github/skills/cu-sdk-setup/SKILL.md)","tokens":300,"sizeBytes":304},{"name":"copilot-instructions.md","path":".github/copilot-instructions.md","rawUrl":"https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/.github/copilot-instructions.md","title":"GitHub Copilot Instructions","category":"copilot-instructions","format":"markdown","content":"# GitHub Copilot Instructions\n\nPath: `.github/copilot-instructions.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/.github/copilot-instructions.md)","tokens":300,"sizeBytes":199},{"name":"README.md","path":"eng/tools/azure-sdk-tools/devtools_testutils/perfstress_tests/system_perfstress/README.md","rawUrl":"https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/eng/tools/azure-sdk-tools/devtools_testutils/perfstress_tests/system_perfstress/README.md","title":"system_perfstress Documentation","category":"plugin-manifest","format":"markdown","content":"# system_perfstress Documentation\n\nPath: `eng/tools/azure-sdk-tools/devtools_testutils/perfstress_tests/system_perfstress/README.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/eng/tools/azure-sdk-tools/devtools_testutils/perfstress_tests/system_perfstress/README.md)","tokens":300,"sizeBytes":319},{"name":"README.md","path":"eng/tools/azure-sdk-tools/devtools_testutils/README.md","rawUrl":"https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/eng/tools/azure-sdk-tools/devtools_testutils/README.md","title":"devtools_testutils Documentation","category":"plugin-manifest","format":"markdown","content":"# devtools_testutils Documentation\n\nPath: `eng/tools/azure-sdk-tools/devtools_testutils/README.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/eng/tools/azure-sdk-tools/devtools_testutils/README.md)","tokens":300,"sizeBytes":250},{"name":"README.md","path":"eng/tools/azure-sdk-tools/packaging_tools/templates/packaging_files/README.md","rawUrl":"https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/eng/tools/azure-sdk-tools/packaging_tools/templates/packaging_files/README.md","title":"packaging_files Documentation","category":"plugin-manifest","format":"markdown","content":"# packaging_files Documentation\n\nPath: `eng/tools/azure-sdk-tools/packaging_tools/templates/packaging_files/README.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/eng/tools/azure-sdk-tools/packaging_tools/templates/packaging_files/README.md)","tokens":300,"sizeBytes":293},{"name":"README.md","path":"eng/tools/azure-sdk-tools/README.md","rawUrl":"https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/eng/tools/azure-sdk-tools/README.md","title":"azure-sdk-tools Documentation","category":"plugin-manifest","format":"markdown","content":"# azure-sdk-tools Documentation\n\nPath: `eng/tools/azure-sdk-tools/README.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/eng/tools/azure-sdk-tools/README.md)","tokens":300,"sizeBytes":209},{"name":"README.md","path":"eng/tools/azure-sdk-tools/tests/integration/README.md","rawUrl":"https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/eng/tools/azure-sdk-tools/tests/integration/README.md","title":"integration Documentation","category":"plugin-manifest","format":"markdown","content":"# integration Documentation\n\nPath: `eng/tools/azure-sdk-tools/tests/integration/README.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/eng/tools/azure-sdk-tools/tests/integration/README.md)","tokens":300,"sizeBytes":241},{"name":"README.md","path":"eng/tools/azure-sdk-tools/tests/integration/scenarios/dev_requirement_samples/README.md","rawUrl":"https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/eng/tools/azure-sdk-tools/tests/integration/scenarios/dev_requirement_samples/README.md","title":"dev_requirement_samples Documentation","category":"plugin-manifest","format":"markdown","content":"# dev_requirement_samples Documentation\n\nPath: `eng/tools/azure-sdk-tools/tests/integration/scenarios/dev_requirement_samples/README.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/eng/tools/azure-sdk-tools/tests/integration/scenarios/dev_requirement_samples/README.md)","tokens":300,"sizeBytes":321},{"name":"README.md","path":"eng/tools/azure-sdk-tools/tests/integration/scenarios/optional_environment_two_options/README.md","rawUrl":"https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/eng/tools/azure-sdk-tools/tests/integration/scenarios/optional_environment_two_options/README.md","title":"optional_environment_two_options Documentation","category":"plugin-manifest","format":"markdown","content":"# optional_environment_two_options Documentation\n\nPath: `eng/tools/azure-sdk-tools/tests/integration/scenarios/optional_environment_two_options/README.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/eng/tools/azure-sdk-tools/tests/integration/scenarios/optional_environment_two_options/README.md)","tokens":300,"sizeBytes":348},{"name":"README.md","path":"eng/tools/azure-sdk-tools/tests/integration/scenarios/optional_environment_zero_options/README.md","rawUrl":"https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/eng/tools/azure-sdk-tools/tests/integration/scenarios/optional_environment_zero_options/README.md","title":"optional_environment_zero_options Documentation","category":"plugin-manifest","format":"markdown","content":"# optional_environment_zero_options Documentation\n\nPath: `eng/tools/azure-sdk-tools/tests/integration/scenarios/optional_environment_zero_options/README.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/eng/tools/azure-sdk-tools/tests/integration/scenarios/optional_environment_zero_options/README.md)","tokens":300,"sizeBytes":351},{"name":"README.md","path":"eng/tools/azure-sdk-tools/tests/integration/scenarios/pyproject_beta_invalid_metadata/README.md","rawUrl":"https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/eng/tools/azure-sdk-tools/tests/integration/scenarios/pyproject_beta_invalid_metadata/README.md","title":"pyproject_beta_invalid_metadata Documentation","category":"plugin-manifest","format":"markdown","content":"# pyproject_beta_invalid_metadata Documentation\n\nPath: `eng/tools/azure-sdk-tools/tests/integration/scenarios/pyproject_beta_invalid_metadata/README.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/eng/tools/azure-sdk-tools/tests/integration/scenarios/pyproject_beta_invalid_metadata/README.md)","tokens":300,"sizeBytes":345},{"name":"README.md","path":"eng/tools/azure-sdk-tools/tests/integration/scenarios/pyproject_beta_metadata/README.md","rawUrl":"https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/eng/tools/azure-sdk-tools/tests/integration/scenarios/pyproject_beta_metadata/README.md","title":"pyproject_beta_metadata Documentation","category":"plugin-manifest","format":"markdown","content":"# pyproject_beta_metadata Documentation\n\nPath: `eng/tools/azure-sdk-tools/tests/integration/scenarios/pyproject_beta_metadata/README.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/eng/tools/azure-sdk-tools/tests/integration/scenarios/pyproject_beta_metadata/README.md)","tokens":300,"sizeBytes":321},{"name":"README.md","path":"eng/tools/azure-sdk-tools/tests/integration/scenarios/pyproject_build_config/README.md","rawUrl":"https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/eng/tools/azure-sdk-tools/tests/integration/scenarios/pyproject_build_config/README.md","title":"pyproject_build_config Documentation","category":"plugin-manifest","format":"markdown","content":"# pyproject_build_config Documentation\n\nPath: `eng/tools/azure-sdk-tools/tests/integration/scenarios/pyproject_build_config/README.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/eng/tools/azure-sdk-tools/tests/integration/scenarios/pyproject_build_config/README.md)","tokens":300,"sizeBytes":318},{"name":"README.md","path":"eng/tools/azure-sdk-tools/tests/integration/scenarios/pyproject_invalid_metadata/README.md","rawUrl":"https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/eng/tools/azure-sdk-tools/tests/integration/scenarios/pyproject_invalid_metadata/README.md","title":"pyproject_invalid_metadata Documentation","category":"plugin-manifest","format":"markdown","content":"# pyproject_invalid_metadata Documentation\n\nPath: `eng/tools/azure-sdk-tools/tests/integration/scenarios/pyproject_invalid_metadata/README.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/eng/tools/azure-sdk-tools/tests/integration/scenarios/pyproject_invalid_metadata/README.md)","tokens":300,"sizeBytes":330},{"name":"README.md","path":"eng/tools/azure-sdk-tools/tests/integration/scenarios/pyproject_metadata/README.md","rawUrl":"https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/eng/tools/azure-sdk-tools/tests/integration/scenarios/pyproject_metadata/README.md","title":"pyproject_metadata Documentation","category":"plugin-manifest","format":"markdown","content":"# pyproject_metadata Documentation\n\nPath: `eng/tools/azure-sdk-tools/tests/integration/scenarios/pyproject_metadata/README.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/eng/tools/azure-sdk-tools/tests/integration/scenarios/pyproject_metadata/README.md)","tokens":300,"sizeBytes":306},{"name":"README.md","path":"eng/tools/azure-sdk-tools/tests/integration/scenarios/pyproject_project_def_beta/README.md","rawUrl":"https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/eng/tools/azure-sdk-tools/tests/integration/scenarios/pyproject_project_def_beta/README.md","title":"pyproject_project_def_beta Documentation","category":"plugin-manifest","format":"markdown","content":"# pyproject_project_def_beta Documentation\n\nPath: `eng/tools/azure-sdk-tools/tests/integration/scenarios/pyproject_project_def_beta/README.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/eng/tools/azure-sdk-tools/tests/integration/scenarios/pyproject_project_def_beta/README.md)","tokens":300,"sizeBytes":330},{"name":"README.md","path":"eng/tools/azure-sdk-tools/tests/integration/scenarios/pyproject_project_def_with_extension/README.md","rawUrl":"https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/eng/tools/azure-sdk-tools/tests/integration/scenarios/pyproject_project_def_with_extension/README.md","title":"pyproject_project_def_with_extension Documentation","category":"plugin-manifest","format":"markdown","content":"# pyproject_project_def_with_extension Documentation\n\nPath: `eng/tools/azure-sdk-tools/tests/integration/scenarios/pyproject_project_def_with_extension/README.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/eng/tools/azure-sdk-tools/tests/integration/scenarios/pyproject_project_def_with_extension/README.md)","tokens":300,"sizeBytes":360},{"name":"README.md","path":"eng/tools/azure-sdk-tools/tests/integration/scenarios/pyproject_project_def/README.md","rawUrl":"https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/eng/tools/azure-sdk-tools/tests/integration/scenarios/pyproject_project_def/README.md","title":"pyproject_project_def Documentation","category":"plugin-manifest","format":"markdown","content":"# pyproject_project_def Documentation\n\nPath: `eng/tools/azure-sdk-tools/tests/integration/scenarios/pyproject_project_def/README.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/eng/tools/azure-sdk-tools/tests/integration/scenarios/pyproject_project_def/README.md)","tokens":300,"sizeBytes":315},{"name":"README.md","path":"eng/tools/azure-sdk-tools/tests/integration/scenarios/setup_py_metapackage/README.md","rawUrl":"https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/eng/tools/azure-sdk-tools/tests/integration/scenarios/setup_py_metapackage/README.md","title":"setup_py_metapackage Documentation","category":"plugin-manifest","format":"markdown","content":"# setup_py_metapackage Documentation\n\nPath: `eng/tools/azure-sdk-tools/tests/integration/scenarios/setup_py_metapackage/README.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/eng/tools/azure-sdk-tools/tests/integration/scenarios/setup_py_metapackage/README.md)","tokens":300,"sizeBytes":312},{"name":"README.md","path":"eng/tools/azure-sdk-tools/tests/integration/scenarios/setup_py_project_def/README.md","rawUrl":"https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/eng/tools/azure-sdk-tools/tests/integration/scenarios/setup_py_project_def/README.md","title":"setup_py_project_def Documentation","category":"plugin-manifest","format":"markdown","content":"# setup_py_project_def Documentation\n\nPath: `eng/tools/azure-sdk-tools/tests/integration/scenarios/setup_py_project_def/README.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/eng/tools/azure-sdk-tools/tests/integration/scenarios/setup_py_project_def/README.md)","tokens":300,"sizeBytes":312},{"name":"README.md","path":"eng/tools/azure-sdk-tools/tests/integration/scenarios/snippet-updater/README.md","rawUrl":"https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/eng/tools/azure-sdk-tools/tests/integration/scenarios/snippet-updater/README.md","title":"snippet-updater Documentation","category":"plugin-manifest","format":"markdown","content":"# snippet-updater Documentation\n\nPath: `eng/tools/azure-sdk-tools/tests/integration/scenarios/snippet-updater/README.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/eng/tools/azure-sdk-tools/tests/integration/scenarios/snippet-updater/README.md)","tokens":300,"sizeBytes":297},{"name":"README.md","path":"scripts/old_packages/README.md","rawUrl":"https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/scripts/old_packages/README.md","title":"old_packages Documentation","category":"plugin-manifest","format":"markdown","content":"# old_packages Documentation\n\nPath: `scripts/old_packages/README.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/scripts/old_packages/README.md)","tokens":300,"sizeBytes":196},{"name":"README.md","path":"sdk/kubernetesconfiguration/azure-mgmt-kubernetesconfiguration-extensions/README.md","rawUrl":"https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/sdk/kubernetesconfiguration/azure-mgmt-kubernetesconfiguration-extensions/README.md","title":"azure-mgmt-kubernetesconfiguration-extensions Documentation","category":"plugin-manifest","format":"markdown","content":"# azure-mgmt-kubernetesconfiguration-extensions Documentation\n\nPath: `sdk/kubernetesconfiguration/azure-mgmt-kubernetesconfiguration-extensions/README.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/sdk/kubernetesconfiguration/azure-mgmt-kubernetesconfiguration-extensions/README.md)","tokens":300,"sizeBytes":335},{"name":"mcp.json","path":".vscode/mcp.json","rawUrl":"https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/.vscode/mcp.json","title":"Model Context Protocol (MCP) Configuration","category":"mcp-config","format":"json","content":"# Model Context Protocol (MCP) Configuration\n\nPath: `.vscode/mcp.json`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/.vscode/mcp.json)","tokens":300,"sizeBytes":184},{"name":"agentic-workflows.md","path":".github/agents/agentic-workflows.md","rawUrl":"https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/.github/agents/agentic-workflows.md","title":"Subagent: agentic-workflows","category":"subagent-persona","format":"markdown","content":"# Subagent: agentic-workflows\n\nPath: `.github/agents/agentic-workflows.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/.github/agents/agentic-workflows.md)","tokens":300,"sizeBytes":207},{"name":"product_info.md","path":"sdk/ai/azure-ai-projects/samples/agents/assets/product_info.md","rawUrl":"https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/sdk/ai/azure-ai-projects/samples/agents/assets/product_info.md","title":"Subagent: product_info","category":"subagent-persona","format":"markdown","content":"# Subagent: product_info\n\nPath: `sdk/ai/azure-ai-projects/samples/agents/assets/product_info.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/sdk/ai/azure-ai-projects/samples/agents/assets/product_info.md)","tokens":300,"sizeBytes":256}],"systemPromptSnippet":"\n\n# AI Agent Protocol & Instructions\n\nPath: `AGENTS.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/AGENTS.md)\n\n\n---\nname: agentic-workflows\ndescription: Route gh-aw workflow design/create/debug/upgrade requests to the right prompts.\n---\n\n# Agentic Workflows Router\n\nUse this skill when a user asks to design, create, update, debug, or upgrade GitHub Agentic Workflows in this repository.\n\nThis skill is a dispatcher: identify the task type, load the matching workflow prompt/skill file, and follow it directly. Keep responses concise and ask a clarifying question if the correct prompt is unclear.\n\nRepository overlay (optional):\n- If `.github/aw/instructions.md` exists, load it with `@.github/aw/instructions.md` after loading the matched prompt/skill.\n- Precedence: repository overlay instructions override upstream defaults when they conflict.\n\nRead only the files you need:\nLoad these files from `github/gh-aw` (they are not available locally).\n- `.github/aw/action-container-substitutions.md`\n- `.github/aw/agent-runtime-instructions.md`\n- `.github/aw/agentic-chat.md`\n- `.github/aw/agentic-workflows-mcp.md`\n- `.github/aw/asciicharts.md`\n- `.github/aw/campaign.md`\n- `.github/aw/charts-trending.md`\n- `.github/aw/charts.md`\n- `.github/aw/cli-commands.md`\n- `.github/aw/compat.md`\n- `.github/aw/configure-agentic-engine.md`\n- `.github/aw/context.md`\n- `.github/aw/create-agentic-workflow-trigger-details.md`\n- `.github/aw/create-agentic-workflow.md`\n- `.github/aw/create-shared-agentic-workflow.md`\n- `.github/aw/debug-agentic-workflow.md`\n- `.github/aw/dependabot.md`\n- `.github/aw/deployment-status.md`\n- `.github/aw/designer-mappings.md`\n- `.github/aw/designer.md`\n- `.github/aw/drive-memory.md`\n- `.github/aw/enclaves.md`\n- `.github/aw/evals.md`\n- `.github/aw/experiments.md`\n- `.github/aw/github-agentic-workflows.md`\n- `.github/aw/github-mcp-server-pagination.md`\n- `.github/aw/github-mcp-server-tools.md`\n- `.github/aw/github-mcp-server.md`\n- `.github/aw/instructions.md`\n- `.github/aw/intent.md`\n- `.github/aw/jobs.md`\n- `.github/aw/linter-workflows.md`\n- `.github/aw/llms.md`\n- `.github/aw/loop.md`\n- `.github/aw/lsp.md`\n- `.github/aw/maintainer.md`\n- `.github/aw/mcp-clis.md`\n- `.github/aw/memory-stateful-patterns.md`\n- `.github/aw/memory.md`\n- `.github/aw/messages.md`\n- `.github/aw/multi-agent-research.md`\n- `.github/aw/network.md`\n- `.github/aw/optimize-agentic-workflow.md`\n- `.github/aw/patterns.md`\n- `.github/aw/playwright.md`\n- `.github/aw/pr-reviewer.md`\n- `.github/aw/release-workflow.md`\n- `.github/aw/report.md`\n- `.github/aw/reuse.md`\n- `.github/aw/safe-outputs-automation.md`\n- `.github/aw/safe-outputs-content.md`\n- `.github/aw/safe-outputs-management.md`\n- `.github/aw/safe-outputs-runtime.md`\n- `.github/aw/safe-outputs.md`\n- `.github/aw/serena-tool.md`\n- `.github/aw/shared-safe-jobs.md`\n- `.github/aw/skills.md`\n- `.github/aw/subagents.md`\n- `.github/aw/syntax-agentic.md`\n- `.github/aw/syntax-core.md`\n- `.github/aw/syntax-engine.md`\n- `.github/aw/syntax-tools-imports.md`\n- `.github/aw/syntax.md`\n- `.github/aw/test-coverage.md`\n- `.github/aw/test-expression.md`\n- `.github/aw/token-optimization-caching-budgets.md`\n- `.github/aw/token-optimization-observability.md`\n- `.github/aw/token-optimization.md`\n- `.github/aw/triggers.md`\n- `.github/aw/update-agentic-workflow.md`\n- `.github/aw/upgrade-agentic-workflows.md`\n- `.github/aw/visual-regression.md`\n- `.github/aw/workflow-constraints.md`\n- `.github/aw/workflow-editing.md`\n- `.github/aw/workflow-patterns.md`\n\nAfter loading the matching workflow prompt or skill, follow it directly:\n- Design workflows from scratch via interview: `.github/aw/designer.md`\n- Create new workflows: `.github/aw/create-agentic-workflow.md`\n- Configure or add declarative engines: `.github/aw/configure-agentic-engine.md`\n- Update existing workflows: `.github/aw/update-agentic-workflow.md`\n- Debug, audit, or investigate workflows: `.github/aw/debug-agentic-workflow.md`\n- Upgrade workflows and fix deprecations: `.github/aw/upgrade-agentic-workflows.md`\n- Create shared components or MCP wrappers: `.github/aw/create-shared-agentic-workflow.md`\n- Create report-generating workflows: `.github/aw/report.md`\n- Fix Dependabot manifest PRs: `.github/aw/dependabot.md`\n- Analyze coverage workflows: `.github/aw/test-coverage.md`\n- Render compact markdown charts: `.github/aw/asciicharts.md`\n- Map CLI commands to MCP usage: `.github/aw/cli-commands.md`\n- Choose workflow architecture and patterns: `.github/aw/patterns.md`\n- Optimize token usage and cost: `.github/aw/token-optimization.md`\n- Design long-running multi-agent research workflows: `.github/aw/multi-agent-research.md`\n- Add skills or agent plugins requested by the user (`skills:` / `plugins:` frontmatter, never on-the-fly installs): `.github/aw/skills.md`\n\nWhen the task involves OTEL, OTLP, traces, observability backends, or telemetry-driven analysis, also read and follow `skills/otel-queries/SKILL.md` after loading the matching workflow prompt or skill.\n\n\n# Evals Skill\n\nPath: `.github/skills/azsdk-common-apiview-feedback-resolution/evals/eval.yaml`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/.github/skills/azsdk-common-apiview-feedback-resolution/evals/eval.yaml)\n\n\n# Evals Skill\n\nPath: `.github/skills/azsdk-common-apiview-feedback-resolution/evals/trigger.eval.yaml`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/.github/skills/azsdk-common-apiview-feedback-resolution/evals/trigger.eval.yaml)\n\n\n# Fixtures Skill\n\nPath: `.github/skills/azsdk-common-apiview-feedback-resolution/fixtures/apiview-comment.json`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/.github/skills/azsdk-common-apiview-feedback-resolution/fixtures/apiview-comment.json)\n\n\n# References Skill\n\nPath: `.github/skills/azsdk-common-apiview-feedback-resolution/references/feedback-resolution-steps.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/.github/skills/azsdk-common-apiview-feedback-resolution/references/feedback-resolution-steps.md)\n\n\n---\nname: azsdk-common-apiview-feedback-resolution\nlicense: MIT\nmetadata:\n version: \"1.0.0\"\n distribution: shared\ndescription: \"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.\"\ncompatibility: \"azure-sdk-mcp server, SDK pull request with APIView review link\"\n---\n\n# APIView Feedback Resolution\n\nThis skill analyzes and resolves APIView review feedback on Azure SDK pull requests by retrieving reviewer comments, categorizing them, and applying TypeSpec or customization updates that bring the SDK API surface into compliance before re-review.\n\n## Triggers\n\nUSE FOR: APIView comments, API review feedback, SDK API surface changes\nWHEN: \"resolve APIView comments\", \"address API review feedback\", \"update SDK API surface after APIView\"\nDO NOT USE FOR: general code review, non-APIView feedback\n\n## Rules\n\n- Requires the `azure-sdk-mcp` server; there is no CLI fallback for retrieving APIView comments or applying TypeSpec changes.\n- Retrieve and categorize APIView comments before making changes so fixes map to reviewer intent.\n- Validate, regenerate, build, and test after applying fixes before requesting re-review.\n\n## MCP Tools\n\n| Tool | Purpose |\n| -------------------------------------------------------- | --------------------------------------------------- |\n| `azure-sdk-mcp:azsdk_apiview_get_comments` | Get APIView comments |\n| `azure-sdk-mcp:azsdk_customized_code_update` | Apply TypeSpec & code customization changes locally |\n| `azure-sdk-mcp:azsdk_typespec_delegate_apiview_feedback` | Delegate to CCA pipeline |\n| `azure-sdk-mcp:azsdk_run_typespec_validation` | Validate TypeSpec |\n| `azure-sdk-mcp:azsdk_package_generate_code` | Regenerate SDK |\n\n## Steps\n\n1. **Retrieve** — Get APIView URL from SDK PR, run `azsdk_apiview_get_comments`.\n2. **Categorize** — Group as Critical/Suggestions/Informational per [feedback steps](references/feedback-resolution-steps.md).\n3. **Resolve** — Use `azsdk_customized_code_update` for TypeSpec changes; delegate via `azsdk_typespec_delegate_apiview_feedback` for complex cases.\n4. **Validate** — Run validation, regenerate SDK, build and test.\n5. **Confirm** — Verify all items addressed. If delegated, follow [post-delegation follow-up](references/feedback-resolution-steps.md#post-delegation-follow-up). Request re-review.\n\n## Examples\n\n- \"Resolve the APIView comments on my SDK pull request\"\n- \"What feedback did the API reviewer leave?\"\n\n## Troubleshooting\n\n- **No comments**: Verify PR has APIView link and MCP server is connected.\n- **Validation fails**: Re-run after fixing TypeSpec errors.\n- **MCP unavailable**: Requires `azure-sdk-mcp` server; no CLI fallback. Connect the server and retry.\n\n\n# Evals Skill\n\nPath: `.github/skills/azsdk-common-generate-sdk-locally/evals/eval.yaml`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/.github/skills/azsdk-common-generate-sdk-locally/evals/eval.yaml)\n\n\n# Evals Skill\n\nPath: `.github/skills/azsdk-common-generate-sdk-locally/evals/trigger.eval.yaml`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/.github/skills/azsdk-common-generate-sdk-locally/evals/trigger.eval.yaml)\n\n\n# Fixtures Skill\n\nPath: `.github/skills/azsdk-common-generate-sdk-locally/fixtures/tspconfig.yaml`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/.github/skills/azsdk-common-generate-sdk-locally/fixtures/tspconfig.yaml)\n\n\n# References Skill\n\nPath: `.github/skills/azsdk-common-generate-sdk-locally/references/customization-workflow.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/.github/skills/azsdk-common-generate-sdk-locally/references/customization-workflow.md)\n\n\n# References Skill\n\nPath: `.github/skills/azsdk-common-generate-sdk-locally/references/detailed-workflow.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/.github/skills/azsdk-common-generate-sdk-locally/references/detailed-workflow.md)\n\n\n# References Skill\n\nPath: `.github/skills/azsdk-common-generate-sdk-locally/references/sdk-repos.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/.github/skills/azsdk-common-generate-sdk-locally/references/sdk-repos.md)\n\n\n---\nname: azsdk-common-generate-sdk-locally\nlicense: MIT\nmetadata:\n version: \"1.1.1\"\n distribution: shared\ndescription: 'Generate and finalize Azure SDKs locally from TypeSpec, including build, checks, tests, changelog, metadata, and version updates by default. WHEN: \"generate SDK locally\", \"build SDK\", \"run SDK tests\", \"run CI checks\", \"validate package\", \"run checks\", \"update changelog\", \"fix SDK build errors\", \"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\". 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.'\ncompatibility: \"azure-sdk-mcp server, local azure-sdk-for-{language} clone, language build tools\"\n---\n\n# Generate SDK Locally\n\nThis 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.\n\n## Triggers\n\nUSE FOR: generate, build, and test Azure SDKs locally from TypeSpec with automatic customization; update changelog; fix SDK build errors; 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\nWHEN: \"generate SDK locally\", \"build SDK\", \"run SDK tests\", \"update changelog\", \"fix SDK build errors\", \"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\"\n\n## Boundaries\n\nDo not use this skill for:\n\n- Publishing SDK packages to package registries\n- CI pipeline configuration\n- API design review\n\n## Rules\n\n- Interpret **\"generate SDK\"** and **\"generate SDK locally\"** as requests for the complete workflow: generate, build, validate, test, update changelog, update metadata, and update version. Do not treat the word \"generate\" by itself as a generate-only request.\n- Stop after generation and a successful build when the user explicitly says **\"generate only\"**, **\"only generate\"**, or otherwise explicitly asks to skip checks, tests, changelog, metadata, and version updates. Bind `only` to the generation action even when a target qualifier follows: **\"generate SDK only for Web PubSub\"** is a generate-only request scoped to Web PubSub. By contrast, **\"generate the SDK for only the Web PubSub service\"** scopes the complete workflow to one service. Once a request is classified as generate-only, do not prompt for a commit or run steps 8–11. If the user's intent is unclear, default to the complete workflow.\n- This skill generates an SDK **locally** from a local clone. Use it to generate an SDK **only when the user indicates local generation** — they say \"local\"/\"locally\", or are working from a local clone. If the user asks to \"generate SDK for **all languages**\", to generate **for a release plan / release ID** (even a single language), to generate **without a local clone**, or wants SDK **pull requests created** for them, do **not** generate locally — use the `azsdk-common-generate-sdk-pipeline` skill, which runs the SDK generation pipeline for each language and produces the SDK pull requests.\n- Never use `azure-sdk-mcp:azsdk_get_sdk_pull_request_link` or `azure-sdk-mcp:azsdk_get_pull_request` to _generate_ an SDK; those only retrieve links for SDKs that were already generated.\n- Requires the `azure-sdk-mcp` server for the MCP workflow; without MCP, use `npm exec --prefix eng/common/tsp-client -- tsp-client` CLI.\n- Verify the target language repo and the correct TypeSpec configuration file before generation.\n- After generation or customization, run the check and test steps before updating metadata or finalizing changes.\n\n## MCP Tools\n\n| Tool | Purpose |\n| ------------------------------------------------------ | ------------------------------------------------------ |\n| `azure-sdk-mcp:azsdk_verify_setup` | Verify environment |\n| `azure-sdk-mcp:azsdk_package_generate_code` | Generate SDK |\n| `azure-sdk-mcp:azsdk_package_build_code` | Build package |\n| `azure-sdk-mcp:azsdk_package_run_check` | Validate package |\n| `azure-sdk-mcp:azsdk_package_run_tests` | Run tests |\n| `azure-sdk-mcp:azsdk_customized_code_update` | Apply customizations (includes regeneration and build) |\n| `azure-sdk-mcp:azsdk_package_update_changelog_content` | Update changelog |\n| `azure-sdk-mcp:azsdk_package_update_metadata` | Update metadata including ci.yml |\n| `azure-sdk-mcp:azsdk_package_update_version` | Update version |\n\nPrerequisites: azure-sdk-mcp server must be running. Without MCP, use `npx tsp-client` CLI.\n\n## Steps\n\n1. **Select language** — Confirm target language: .NET, Java, JavaScript, Python, Go, or Rust.\n2. **Verify repo** — Ensure the user has a local clone of the correct [SDK repo](references/sdk-repos.md). If not cloned, instruct user to clone it.\n3. **Identify config file** — Determine the path to the TypeSpec configuration file. See [config file details](references/detailed-workflow.md).\n - From `azure-rest-api-specs` repo: use path to `tspconfig.yaml`.\n - From an SDK language repo: use path to `tsp-location.yaml`.\n4. **Verify setup** — Run `azure-sdk-mcp:azsdk_verify_setup` to confirm environment.\n5. **Generate** — Run `azure-sdk-mcp:azsdk_package_generate_code` with the config file path.\n6. **Build** — Run `azure-sdk-mcp:azsdk_package_build_code`. For .NET, use the `additionalArguments: \"/p:RunApiCompat=false\"` to skip API compatibility checks if user requests to skip API compatibility check.\n7. **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](references/customization-workflow.md). _(If the user requested \"generate only\", stop here — skip steps 8–11.)_\n8. **Commit checkpoint** — Prompt the user to commit generated changes before proceeding. See [commit checkpoint details](references/detailed-workflow.md).\n9. **Validate** — Run `azure-sdk-mcp:azsdk_package_run_check` and `azure-sdk-mcp:azsdk_package_run_tests`.\n10. **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.)_\n11. **Final commit** — Prompt the user to commit final changes (changelog, metadata, version). See [commit checkpoint details](references/detailed-workflow.md).\n\n[SDK repos](references/sdk-repos.md) | [Customization workflow](references/customization-workflow.md) | [Detailed workflow](references/detailed-workflow.md)\n\n## Guardrails\n\n- **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.\n- 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.\n- Only the customization tool understands the correct layering of TypeSpec decorators vs code patches and ensures regenerated code stays consistent.\n\n## Examples\n\n- \"Generate the SDK locally for my TypeSpec service\"\n- \"Build and test the Python SDK package\"\n- \"Run CI checks for my SDK package\"\n- \"Fix the SDK build errors on this PR\"\n- \"Rename FooClient to BarClient for .NET\"\n- \"Hide the internal polling operation from the Python SDK\"\n- \"Fix .NET analyzer errors AZC0030 and AZC0012\"\n- \"The build is failing because a customization references a renamed property\"\n- \"Create a subclient architecture for the Python SDK\"\n- \"Apply TypeSpec customizations to fix compilation errors\"\n- \"Update the changelog for this SDK package\"\n- \"Update the package version\"\n- \"Update the package metadata and ci.yml\"\n\n## Troubleshooting\n\n- For \"generate SDK for all languages\", pipeline-based generation, or when no local SDK clone exists, call `azure-sdk-mcp:azsdk_run_generate_sdk` instead of the local generate flow, and never substitute `azure-sdk-mcp:azsdk_get_sdk_pull_request_link` / `azure-sdk-mcp:azsdk_get_pull_request` for generation.\n- Run `azure-sdk-mcp:azsdk_verify_setup` to confirm MCP and tools.\n- If build fails with type conflicts, breaking changes, analyzer errors, or customization drift, use `azure-sdk-mcp:azsdk_customized_code_update` to apply customizations.\n- The customization tool uses a two-phase approach: TypeSpec decorators first (Phase A), then code repairs if needed (Phase B).\n- 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.\n- Without MCP, use `npx tsp-client` CLI.\n\n\n# Evals Skill\n\nPath: `.github/skills/azsdk-common-pipeline-analysis/evals/trigger.eval.yaml`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/.github/skills/azsdk-common-pipeline-analysis/evals/trigger.eval.yaml)\n\n\n# References Skill\n\nPath: `.github/skills/azsdk-common-pipeline-analysis/references/failure-patterns.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/.github/skills/azsdk-common-pipeline-analysis/references/failure-patterns.md)\n\n\n# References Skill\n\nPath: `.github/skills/azsdk-common-pipeline-analysis/references/output-format.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/.github/skills/azsdk-common-pipeline-analysis/references/output-format.md)\n\n\n---\nname: azsdk-common-pipeline-analysis\nlicense: MIT\nmetadata:\n version: \"1.0.0\"\n distribution: shared\ndescription: 'Analyze Azure SDK CI/CD pipeline failures into a structured diagnosis, and define the required output format. Load this skill before calling azsdk_analyze_pipeline, which returns raw failure data that this skill interprets and formats. USE FOR: \"pipeline failed\", \"build failure\", \"CI check failing\", \"tests failing in CI\", \"analyze pipeline\", \"debug SDK pipeline\". DO NOT USE FOR: local build issues without pipeline context, API design review, SDK publishing, applying code fixes (instead use azsdk-common-pipeline-fixer). INVOKES: azure-sdk-mcp:azsdk_analyze_pipeline, azure-sdk-mcp:azsdk_get_pipeline_llm_artifacts, azure-sdk-mcp:azsdk_get_failed_test_run_data, azure-sdk-mcp:azsdk_get_failed_test_case_data, azure-sdk-mcp:azsdk_get_pr_checks, azure-sdk-mcp:azsdk_get_pipeline_status.'\ncompatibility: \"azure-sdk-mcp server, Azure DevOps pipeline build ID or GitHub PR link\"\n---\n\n# Pipeline Analysis\n\nThis skill analyzes Azure SDK CI/CD pipeline failures and provides a structured diagnosis including root cause, affected files, and concrete instructions for how to fix each issue. It does NOT apply fixes - it tells you exactly what's wrong and how to resolve it.\n\n## Rules\n\n- Load this skill **before** running `azsdk_analyze_pipeline` — the tool returns raw failure data that this skill interprets and formats per [output format](references/output-format.md).\n- Requires the `azure-sdk-mcp` server; without it, inspect logs in the Azure DevOps UI.\n- Analysis-only: never edit files or apply fixes — use `azsdk-common-pipeline-fixer` for changes.\n- Run `azsdk_analyze_pipeline` first, then categorize each failure and cite specific files/lines.\n- For infrastructure failures (network timeouts, agent crashes, throttling), recommend retry, not code changes.\n\n## MCP Tools\n\n| Tool | Purpose |\n| ------------------------------------------------ | --------------------------------------------------- |\n| `azure-sdk-mcp:azsdk_analyze_pipeline` | Analyze pipeline failure (logs + test results) |\n| `azure-sdk-mcp:azsdk_get_pipeline_llm_artifacts` | Download test result artifacts from pipeline |\n| `azure-sdk-mcp:azsdk_get_failed_test_run_data` | Full details for every failure in one artifact file |\n| `azure-sdk-mcp:azsdk_get_failed_test_case_data` | Full details for a single failing test in a file |\n| `azure-sdk-mcp:azsdk_get_pr_checks` | Get pipeline/check results linked to a PR |\n| `azure-sdk-mcp:azsdk_get_pipeline_status` | Get pipeline run status |\n\n## Steps\n\n1. **Identify** - Get the build ID, pipeline URL, or PR link (use the PR link when triggered from a PR comment).\n2. **Analyze** - Run `azsdk_analyze_pipeline`. It returns `failed_pipeline_tasks` (log errors from failed steps) and `failed_pipeline_tests`, a lightweight index of failed tests grouped by artifact file. Each entry has `artifact_file_path`, `platform`, and `failed_test_titles` — titles only, no error text, to keep the response small.\n3. **Fetch failure details** - Fetch failure details lazily so you don't overload context: call `azsdk_get_failed_test_run_data` with the parameter `failedTestRunsPath` set to `artifact_file_path` once per file to get every failure in it. Or call `azsdk_get_failed_test_case_data` with\n `failedTestRunsPath` set to `artifact_file_path` and `testCaseTitle` set to one exact title from `failed_test_titles`. Prefer the per-file call when triaging a whole file's failures.\n4. **Categorize** each failure: test, build/compilation, validation/lint, or infrastructure.\n5. **Diagnose** - Give each failure's root cause and affected file(s)/line(s), and note if several share one root cause. See [failure patterns](references/failure-patterns.md).\n6. **Report** - Use the [output format](references/output-format.md): root cause, affected files, per-failure fix + verify command, and fixable vs infrastructure. Recommend `azsdk-common-pipeline-fixer` to apply fixes.\n\n## Examples\n\n- \"My pipeline build 6447834 failed, what went wrong?\"\n- PR comment: `@copilot Analyze the failed pipeline on this PR`\n- \"Why is my CI red? Build ID is 6455939\"\n\n## Troubleshooting\n\n- If `azsdk_analyze_pipeline` returns no data, verify the build ID is correct and the run has completed.\n- If `failed_pipeline_tests` is empty, rely on `failed_pipeline_tasks` log analysis (test-artifact upload may not be configured).\n- For a private/internal pipeline, the user may need to `az login`. See [failure patterns](references/failure-patterns.md).\n\n\n# Evals Skill\n\nPath: `.github/skills/azsdk-common-pipeline-fixer/evals/trigger.eval.yaml`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/.github/skills/azsdk-common-pipeline-fixer/evals/trigger.eval.yaml)\n\n\n---\nname: azsdk-common-pipeline-fixer\nlicense: MIT\nmetadata:\n version: \"1.0.0\"\n distribution: shared\ndescription: 'Automatically fix Azure SDK CI/CD pipeline failures by applying code changes and verifying locally. USE FOR: \"fix pipeline failure\", \"fix CI\", \"fix failing tests\", \"auto-fix and commit the fix\", \"fix build error\", \"fix mypy/pylint/type-check/lint errors\", \"auto-fix pipeline\", \"resolve pipeline failure\". DO NOT USE FOR: pipeline analysis (instead use azsdk-common-pipeline-analysis), API design review, SDK publishing. INVOKES: azure-sdk-mcp:azsdk_package_build_code, azure-sdk-mcp:azsdk_package_run_check, azure-sdk-mcp:azsdk_package_run_tests, azure-sdk-mcp:azsdk_verify_setup.'\ncompatibility: \"azure-sdk-mcp server, local azure-sdk-for-{language} clone, language build tools\"\n---\n\n# Pipeline Fixer\n\nThis skill automatically fixes Azure SDK CI/CD pipeline failures. It analyzes the failure, identifies the root cause, applies code changes, and verifies the fix locally using build, check, and test tools before committing.\n\n## Rules\n\n- Requires the `azure-sdk-mcp` server and a local clone of the SDK language repo.\n- Work on the PR branch — the failing code is there, not main.\n- Analyze first, then apply the minimal code change for the root cause.\n- Verify ONLY via the azsdk MCP package tools (build → check → tests); never raw shell build/test commands.\n- Never fix infrastructure failures (timeouts, crashes, throttling) — recommend retry. Iterate up to 3 times, then report.\n\n## MCP Tools\n\n| Tool | Purpose |\n| ---------------------------------------- | ------------------------------------- |\n| `azure-sdk-mcp:azsdk_verify_setup` | Verify local environment is ready |\n| `azure-sdk-mcp:azsdk_package_build_code` | Build the package locally |\n| `azure-sdk-mcp:azsdk_package_run_check` | Run validation/lint/typecheck locally |\n| `azure-sdk-mcp:azsdk_package_run_tests` | Run tests locally |\n\n**Prerequisites:** azure-sdk-mcp server required. Local clone of the affected SDK language repo. Language build tools installed.\n\n## Steps\n\n1. **Find analysis** - Reuse an existing analysis from the PR comments; if none, view the `azsdk-common-pipeline-analysis` skill.\n2. **Classify** - Fixable (test, type, lint, import, assertion errors) vs retry (infrastructure) vs escalate (breaking API, credentials).\n3. **Locate** - Identify the affected package, its path, and the files/lines to change.\n4. **Fix** - Read the failing code at the cited lines and apply the minimal fix.\n5. **Verify** - Run `azsdk_package_build_code` → `azsdk_package_run_check` → `azsdk_package_run_tests` on the package; all must pass. If the environment isn't ready, run `azsdk_verify_setup`. Never substitute raw shell build/test commands.\n6. **Iterate & commit** - On failure, revise and re-verify (max 3 attempts). Once all pass, commit with a descriptive message.\n\n## Examples\n\n- \"Fix the pipeline failure for build 6447834\"\n- \"My Python SDK CI is failing with a type error, fix it\"\n- \"Auto-fix the failing tests in my PR\"\n\n## Troubleshooting\n\n- If the verify tools fail because the environment isn't ready, run `azsdk_verify_setup`, report its error, and stop — don't fall back to raw shell build/test commands.\n\n\n# Evals Skill\n\nPath: `.github/skills/azsdk-common-prepare-release-plan/evals/eval.yaml`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/.github/skills/azsdk-common-prepare-release-plan/evals/eval.yaml)\n\n\n# Evals Skill\n\nPath: `.github/skills/azsdk-common-prepare-release-plan/evals/schedule-risk.eval.yaml`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/.github/skills/azsdk-common-prepare-release-plan/evals/schedule-risk.eval.yaml)\n\n\n# Evals Skill\n\nPath: `.github/skills/azsdk-common-prepare-release-plan/evals/trigger.eval.yaml`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/.github/skills/azsdk-common-prepare-release-plan/evals/trigger.eval.yaml)\n\n\n# Fixtures Skill\n\nPath: `.github/skills/azsdk-common-prepare-release-plan/fixtures/tspconfig.yaml`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/.github/skills/azsdk-common-prepare-release-plan/fixtures/tspconfig.yaml)\n\n\n# References Skill\n\nPath: `.github/skills/azsdk-common-prepare-release-plan/references/release-plan-details.md`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/.github/skills/azsdk-common-prepare-release-plan/references/release-plan-details.md)\n\n\n---\nname: azsdk-common-prepare-release-plan\nlicense: MIT\nmetadata:\n version: \"1.0.0\"\n distribution: shared\ndescription: '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_update_release_plan, azure-sdk-mcp:azsdk_update_release_plan_target, 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.'\ncompatibility: \"azure-sdk-mcp server, API spec PR in Azure/azure-rest-api-specs\"\n---\n\n# Prepare Release Plan\n\nThis skill creates, gets, updates, abandons, and links SDK PRs to release plan work items for Azure SDK releases, helping gather required release data, validate spec inputs, and link related approvals or SDK pull requests without exposing internal work item URLs.\n\n## Triggers\n\nUSE 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\nWHEN: \"create release plan\", \"get release plan\", \"update release plan\", \"abandon release plan\", \"link SDK PR to plan\", \"namespace approval\", \"check release plan status\"\nDO NOT USE FOR: SDK code generation, pipeline troubleshooting, API review feedback\n\n## Rules\n\n- Do not display Azure DevOps work item URLs; only provide the Release Plan Link and ID.\n- Require an API spec PR link or a TypeSpec project path before creating or updating a plan.\n- Validate that the spec PR repository matches the requested API release type before creation.\n- Release plan tools accept **either** a Release Plan ID or an Azure DevOps work item ID — pass whichever the user provides. Each tool resolves the value automatically (trying it as a Release Plan ID first, then as a work item ID), so you do not need to call `azure-sdk-mcp:azsdk_get_release_plan` first just to translate one ID into the other.\n- Always relay schedule-risk `warnings` and `next_steps` returned by release plan tools. For each past-due plan, show its Release Plan ID and dashboard link, then present both choices: update its target release month or abandon it and record the reason in the dashboard.\n\n## MCP Tools\n\n| Tool | Purpose |\n| ------------------------------------------------------------------ | ---------------------------------- |\n| `azure-sdk-mcp:azsdk_create_release_plan` | Create a new release plan |\n| `azure-sdk-mcp:azsdk_get_release_plan` | Get plan by ID, path, or spec PR |\n| `azure-sdk-mcp:azsdk_update_release_plan` | Update release plan metadata |\n| `azure-sdk-mcp:azsdk_update_release_plan_target` | Update the target release month |\n| `azure-sdk-mcp:azsdk_update_api_spec_pull_request_in_release_plan` | Update API spec PR URL in plan |\n| `azure-sdk-mcp:azsdk_update_sdk_details_in_release_plan` | Update SDK/package details in plan |\n| `azure-sdk-mcp:azsdk_abandon_release_plan` | Abandon a release plan |\n| `azure-sdk-mcp:azsdk_link_sdk_pull_request_to_release_plan` | Link SDK PR to release plan |\n| `azure-sdk-mcp:azsdk_link_namespace_approval_issue` | Link namespace approval issue |\n\n---\n\n## Use Cases\n\n### 1. Create Release Plan\n\n**When**: User wants to create a release plan for a TypeSpec project.\n\n**Steps**:\n\n1. **Get TypeSpec Project Path** — Ask the user for the relative TypeSpec project path (directory containing `tspconfig.yaml`, e.g. `specification/contosowidgetmanager/Contoso.WidgetManager`). Always use the relative path from the repo root, not an absolute path.\n2. **Check Existing** — Run `azure-sdk-mcp:azsdk_get_release_plan` with the relative `typeSpecProjectPath` to check if a release plan already exists.\n - If a release plan exists with the **same API release type** the user requested: inform the user that a release plan already exists, show the Release Plan ID, status, and API release type. Suggest the user use the existing release plan. Do NOT create a new one.\n - If a release plan exists but for a **different API release type**: inform the user about the existing plan and its API release type, then proceed to create a new release plan using `forceCreateReleasePlan: true` for the user's requested API release type. Do NOT attempt to update the existing release plan's API release type.\n - If no release plan exists, proceed to step 3.\n3. **Gather Info** — Collect required details from the user. See [details](references/release-plan-details.md):\n - Target release month/year (format: \"Month YYYY\", e.g. \"June 2026\"). Do NOT use formats like \"2026-06\" or \"06/2026\" — these are invalid.\n - API release type: Value must be one of the following: \"Private Preview\", \"Public Preview\", or \"GA\"\n - SDK release type: Value must be \"beta\" or \"stable\" — always ask the user explicitly\n - Spec PR URL (optional)\n - Service Tree ID (GUID) — optional if previously created\n - Product Tree ID (GUID) — optional if previously created\n4. **Create** — Run `azure-sdk-mcp:azsdk_create_release_plan` with the collected parameters including `sdkReleaseType`. Use `forceCreateReleasePlan: true` only if an existing release plan was found for a different API release type.\n5. **Namespace** — For first management plane releases, link namespace approval issue using `azure-sdk-mcp:azsdk_link_namespace_approval_issue`.\n\n> **IMPORTANT**: Do NOT default the API release type value as the SDK release type. These are separate fields — always ask the user explicitly for the SDK release type.\n>\n> **IMPORTANT**: Do NOT update an existing release plan to change its API release type. If a release plan exists for a different API release type, force-create a new one instead.\n\n**Tool**: `azure-sdk-mcp:azsdk_create_release_plan`\n\n---\n\n### 2. Get Release Plan\n\n**When**: User wants to check the status or details of an existing release plan.\n\n**Steps**:\n\n1. **Identify Plan** — Ask user for one of:\n - Release plan ID or work item ID\n - Relative TypeSpec project path (e.g. `specification/contosowidgetmanager/Contoso.WidgetManager`)\n - Spec PR URL\n2. **Query** — Run `azure-sdk-mcp:azsdk_get_release_plan` with the provided identifier. Always use a relative path for `typeSpecProjectPath`; use `specPullRequestUrl` when the user provides only a spec PR URL.\n3. **Display** — Show the release plan ID, status, linked PRs, and SDK details. Always relay schedule-risk warnings and recommended actions from the response.\n\n**Tool**: `azure-sdk-mcp:azsdk_get_release_plan`\n\n---\n\n### 3. Update Release Plan / Update API Spec in Release Plan\n\n**When**: User needs to update release plan metadata (spec PR URL, TypeSpec project path, SDK release type, service/product IDs) or update the API spec PR link.\n\n**Steps**:\n\n1. **Identify Plan** — Get the work item ID or TypeSpec project path from the user.\n2. **Update Metadata** — Run `azure-sdk-mcp:azsdk_update_release_plan` with:\n - `typeSpecProjectPath` (required)\n - `workItemId` (optional — resolved from TypeSpec path or spec PR if not provided)\n - `specPullRequestUrl` (optional)\n - `sdkReleaseType` (required — do NOT default this from API release type; always ask user explicitly)\n - `serviceTreeId` (optional)\n - `productTreeId` (optional)\n3. **Update API Spec PR** — If only the spec PR URL needs updating, run `azure-sdk-mcp:azsdk_update_api_spec_pull_request_in_release_plan` with:\n - `specPullRequestUrl` (required)\n - `workItemId` or `releasePlanId`\n\n**Tools**: `azure-sdk-mcp:azsdk_update_release_plan`, `azure-sdk-mcp:azsdk_update_api_spec_pull_request_in_release_plan`\n\n---\n\n### 4. Update SDK/Package Details in Release Plan\n\n**When**: User needs to update SDK language and package name details in the release plan after code generation or configuration changes.\n\n**Steps**:\n\n1. **Identify Plan** — Get the Release Plan ID or work item ID from the user (either is accepted).\n2. **Identify TypeSpec Project** — Get or confirm the TypeSpec project path.\n3. **Update** — Run `azure-sdk-mcp:azsdk_update_sdk_details_in_release_plan` with:\n - `workItemId` (required — accepts either the Release Plan ID or the work item ID)\n - `typeSpecProjectPath` (required)\n\n**Tool**: `azure-sdk-mcp:azsdk_update_sdk_details_in_release_plan`\n\n---\n\n### 5. Abandon a Release Plan\n\n**When**: User decides to cancel or discard a release plan that is no longer needed.\n\n**Steps**:\n\n1. **Identify Plan** — Get the work item ID or release plan ID from the user.\n2. **Confirm** — Ask user to confirm abandonment: \"Are you sure you want to abandon this release plan? This action updates the status to Abandoned.\"\n3. **Abandon** — Run `azure-sdk-mcp:azsdk_abandon_release_plan` with:\n - `workItemId` or `releasePlanId`\n\n**Tool**: `azure-sdk-mcp:azsdk_abandon_release_plan`\n\n---\n\n### 6. Link SDK Pull Request to Release Plan\n\n**When**: SDK pull requests have been created and need to be associated with the release plan.\n\n**Steps**:\n\n1. **Identify Plan** — Get the Release Plan ID or work item ID from the user (either is accepted).\n2. **Collect PR Info** — Get the SDK pull request URL and language from the user.\n3. **Link** — Run `azure-sdk-mcp:azsdk_link_sdk_pull_request_to_release_plan` with:\n - `pullRequestUrl` (required)\n - `language` (required — e.g., \".NET\", \"Java\", \"JavaScript\", \"Python\", \"Go\")\n - `workItemId` or `releasePlanId` (either accepts the Release Plan ID or the work item ID)\n4. **Repeat** — If multiple SDK PRs exist for different languages, repeat for each.\n\n**Tool**: `azure-sdk-mcp:azsdk_link_sdk_pull_request_to_release_plan`\n\n---\n\n## Examples\n\n- \"Create a release plan for my spec PR\"\n- \"Get the release plan for work item 12345\"\n- \"What is the status of my release plan?\"\n- \"Update the API spec PR in my release plan\"\n- \"Update SDK details in release plan 67890\"\n- \"Abandon release plan 11111\"\n- \"Link my SDK PR to release plan\"\n- \"Link Python SDK PR #100 to release plan 67890\"\n\n## Troubleshooting\n\n- Requires `azure-sdk-mcp` server; no CLI fallback — prompt user to configure MCP if unavailable.\n- If creation fails, verify spec PR URL and Service Tree IDs.\n- If update fails, ensure the Release Plan ID or work item ID is correct and the plan is not already abandoned.\n- If linking fails, verify the SDK PR URL is valid and the language matches a supported value.\n\n\n# Evals Skill\n\nPath: `.github/skills/azsdk-common-sdk-breaking-change/evals/eval.yaml`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/.github/skills/azsdk-common-sdk-breaking-change/evals/eval.yaml)\n\n\n# Evals Skill\n\nPath: `.github/skills/azsdk-common-sdk-breaking-change/evals/trigger.eval.yaml`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/.github/skills/azsdk-common-sdk-breaking-change/evals/trigger.eval.yaml)\n\n\n---\nname: azsdk-common-sdk-breaking-change\nlicense: MIT\nmetadata:\n version: \"1.0.0\"\n distribution: shared\ndescription: 'Detect and mitigate SDK Breaking changes for an SDK package which is generated from TypeSpec. WHEN: \"Detect SDK breaking changes for a service\", \"Detect SDK breaking changes for an SDK package\", \"Detect and mitigate SDK breaking changes for a service\", \"Detect and mitigate SDK breaking changes for an SDK package\". INVOKES: skill: azsdk-common-generate-sdk-locally; MCP tools: azure-sdk-mcp:azsdk_customized_code_update, azure-sdk-mcp:azsdk_package_detect_breaking_change.'\ncompatibility: \"azure-sdk-mcp server, local azure-sdk-for-{language} clone, language build tools\"\n---\n\n# SDK Breaking Change Detection and Mitigation\n\n## MCP Tools\n\n| Tool | Purpose |\n| ---------------------------------------------------- | --------------------------- |\n| `azure-sdk-mcp:azsdk_customized_code_update` | Apply customizations |\n| `azure-sdk-mcp:azsdk_package_detect_breaking_change` | Detect SDK breaking changes |\n\nPrerequisites: azure-sdk-mcp server must be running.\n\n## Steps\n\n1. **Select language** — First extract one or more target languages from the user's prompt. If the prompt specifies any target languages, use them without asking the user to confirm. If it does not specify a target language, prompt the user to choose one or more from this list, presented in exactly this order: Go, Java, JavaScript, Python, .NET.\n\n- For each selected language in step 1, execute steps 2 through 6 **one language at a time** — fully complete all steps for one language before starting the next. Process multiple selected languages in the same order they appear in the list above.\n\n2. Follow `azsdk-common-generate-sdk-locally` skill to generate SDK only. For .NET, require the preparatory build to disable API compatibility checks using additionalArguments: \"/p:RunApiCompat=false\". This is a requirement of this workflow: compatibility findings must reach the detection and user-selection steps rather than be automatically repaired during generation.\n3. **Detect SDK breaking Changes** - Run `azure-sdk-mcp:azsdk_package_detect_breaking_change`\n4. **Display detected breaking changes** — If step 3 fails, display the `ResponseError` message and stop processing the current language. If step 3 detects breaking changes, display a `## Detected Breaking Changes` title followed by a Markdown table. Include exactly one breaking change per row with these columns: `Breaking Change`, `Category`, and `Resolution`. Preserve the category and resolution returned by the detection tool; do not replace them with a summary. If no breaking changes are detected, report that result and stop processing the current language.\n5. **Prompt the user to choose breaking changes to mitigate** — If the user requested detection only, stop processing the current language after displaying the results. Otherwise, present the list from step 3 as a multiple-choice selection.\n6. **Mitigate selected SDK breaking changes** — If the user selects no changes in step 5, stop processing the current language. Otherwise, run `azure-sdk-mcp:azsdk_customized_code_update` for the selected changes with these parameters:\n\n- packagePath: The SDK package path\n- customizationRequest: resolve the 'breakingChanges' chosen in step 5\n- tspProjectPath: the typespec project path\n- editScope: Set this based on the repository where the skill is running. When running in the target SDK language repository, use `'CustomCode'`. When running in `azure-rest-api-specs`, use `'All'` if the target SDK language repository is also available as a local clone; otherwise, use `'SpecInputs'`.\n\nAfter step 6, begin the next iteration. If the customization modified TypeSpec, first repeat step 2 to regenerate the SDK; otherwise, resume at step 3. Then repeat steps 3 through 6. Run at most three detection-and-mitigation iterations per language, stopping earlier if no breaking changes remain or the user declines further mitigation. After the third mitigation, run step 3 once more to identify and report any remaining breaking changes, then stop without offering a fourth mitigation.\n\n## Examples\n\n- \"Detect and mitigate SDK breaking changes for the service\"\n- \"Detect SDK breaking changes for the service\"\n- \"Detect SDK breaking changes for Go SDK package\"\n- \"Detect and mitigate SDK breaking changes for Go SDK package\"\n\n## Troubleshooting\n\n- Requires the `azure-sdk-mcp` server. If it is unavailable, direct the user to the [quick-start guide](https://github.com/Azure/azure-sdk-tools/blob/main/tools/azsdk-cli/Azure.Sdk.Tools.Cli/README.md#quick-start) to configure it before continuing.\n- Requires a local clone of the target SDK repository. If unavailable, prompt the user to clone it before continuing.\n\n\n# Evals Skill\n\nPath: `.github/skills/azsdk-common-sdk-release/evals/eval.yaml`\n\n[View Raw Content on GitHub](https://raw.githubusercontent.com/Azure/azure-sdk-for-python/HEAD/.github/skills/azsdk-common-sdk-release/evals/eval.yaml)\n\n\n"}