Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion .github/skills/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -17,7 +17,7 @@ to match and distribute them to all subscribed language SDK repos.

| Skill | Triggers | Description |
| ----- | -------- | ----------- |
| [azsdk-common-generate-sdk-locally](azsdk-common-generate-sdk-locally/SKILL.md) | "generate SDK locally", "build SDK", "run SDK tests" | Generate, build, and test Azure SDKs locally from TypeSpec |
| [azsdk-common-generate-sdk-locally](azsdk-common-generate-sdk-locally/SKILL.md) | "generate SDK locally", "build SDK", "run SDK tests", "run CI checks", "passes all checks" | Generate, build, and test Azure SDKs locally from TypeSpec |
| [azsdk-common-prepare-release-plan](azsdk-common-prepare-release-plan/SKILL.md) | "create release plan", "link SDK PR to plan" | Create and manage release plan work items |
| [azsdk-common-apiview-feedback-resolution](azsdk-common-apiview-feedback-resolution/SKILL.md) | "APIView comments", "resolve API review feedback" | Retrieve and resolve APIView review feedback |
| [azsdk-common-pipeline-troubleshooting](azsdk-common-pipeline-troubleshooting/SKILL.md) | "pipeline failed", "build failure", "CI check failing" | Diagnose and resolve SDK CI and generation pipeline failures |
Expand Down
7 changes: 6 additions & 1 deletion .github/skills/azsdk-common-generate-sdk-locally/SKILL.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@ license: MIT
metadata:
version: "1.1.0"
distribution: shared
description: "Generate, build, and test Azure SDKs locally from TypeSpec with automatic customization. WHEN: \"generate SDK locally\", \"build SDK\", \"run SDK tests\", \"update changelog\", \"fix SDK build errors\", \"fix breaking changes\", \"resolve SDK generation errors\", \"customize TypeSpec\", \"rename SDK client\", \"rename SDK model\", \"hide operation from SDK\", \"fix analyzer errors\", \"resolve customization drift\", \"create subclient\", \"update metadata\", \"update version\". DO NOT USE FOR: publishing to package registries, CI pipeline configuration, API design review. INVOKES: azsdk_verify_setup, azsdk_package_generate_code, azsdk_package_build_code, azsdk_package_run_check, azsdk_package_run_tests, azsdk_customized_code_update, azsdk_package_update_changelog_content, azsdk_package_update_metadata, azsdk_package_update_version."
description: "Generate, build, and test Azure SDKs locally from TypeSpec with automatic customization. WHEN: \"generate SDK locally\", \"build SDK\", \"run SDK tests\", \"run CI checks\", \"validate CI checks\", \"passes all checks\", \"run all checks\", \"validate package\", \"update changelog\", \"fix SDK build errors\", \"fix breaking changes\", \"resolve SDK generation errors\", \"customize TypeSpec\", \"rename SDK client\", \"rename SDK model\", \"hide operation from SDK\", \"fix analyzer errors\", \"resolve customization drift\", \"create subclient\", \"update metadata\", \"update version\". DO NOT USE FOR: publishing to package registries, CI pipeline YAML configuration, API design review. INVOKES: azsdk_verify_setup, azsdk_package_generate_code, azsdk_package_build_code, azsdk_package_run_check, azsdk_package_run_tests, azsdk_customized_code_update, azsdk_package_update_changelog_content, azsdk_package_update_metadata, azsdk_package_update_version."
compatibility:
requires: "azure-sdk-mcp server, local azure-sdk-for-{language} clone, language build tools"
---
Expand All @@ -29,6 +29,8 @@ Prerequisites: azure-sdk-mcp server must be running. Without MCP, use `npx tsp-c

## Steps

> **CI checks only** (build + validate + test without regeneration): If the user asks to "run CI checks", "validate" or "check if a package passes all checks", skip to step 6. CI checks = build (`azsdk_package_build_code`) + validate (`azsdk_package_run_check`) + test (`azsdk_package_run_tests`).

1. **Select language** — Confirm target language: .NET, Java, JavaScript, Python, Go, or Rust.
2. **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.
3. **Identify config file** — Determine the path to the TypeSpec configuration file. See [config file details](references/detailed-workflow.md).
Expand Down Expand Up @@ -60,6 +62,9 @@ Prerequisites: azure-sdk-mcp server must be running. Without MCP, use `npx tsp-c
- "Update the changelog for this SDK package"
- "Update the package version"
- "Update the package metadata and ci.yml"
- "Can you run the CI checks for Azure.Health.Deidentification"
- "Can you validate Azure.Search.Documents passes all checks?"
- "Run all checks for the Azure.Storage.Blobs package"

## Troubleshooting

Expand Down
2 changes: 1 addition & 1 deletion plugins/azure-sdk-tools/skills/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -15,7 +15,7 @@ Shared skills (those distributed to other Azure SDK repositories) are identified

| Skill | Triggers | Description |
| ----- | -------- | ----------- |
| [generate-sdk-locally](generate-sdk-locally/SKILL.md) | "generate SDK locally", "build SDK", "run SDK tests" | Generate, build, and test Azure SDKs locally from TypeSpec |
| [generate-sdk-locally](generate-sdk-locally/SKILL.md) | "generate SDK locally", "build SDK", "run SDK tests", "run CI checks", "passes all checks" | Generate, build, and test Azure SDKs locally from TypeSpec |
| [prepare-release-plan](prepare-release-plan/SKILL.md) | "create release plan", "link SDK PR to plan" | Create and manage release plan work items |
| [apiview-feedback-resolution](apiview-feedback-resolution/SKILL.md) | "APIView comments", "resolve API review feedback" | Retrieve and resolve APIView review feedback |
| [pipeline-troubleshooting](pipeline-troubleshooting/SKILL.md) | "pipeline failed", "build failure", "CI check failing" | Diagnose and resolve SDK CI and generation pipeline failures |
Expand Down
7 changes: 6 additions & 1 deletion plugins/azure-sdk-tools/skills/generate-sdk-locally/SKILL.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@ license: MIT
metadata:
version: "1.1.0"
distribution: shared
description: "Generate, build, and test Azure SDKs locally from TypeSpec with automatic customization. WHEN: \"generate SDK locally\", \"build SDK\", \"run SDK tests\", \"update changelog\", \"fix SDK build errors\", \"fix breaking changes\", \"resolve SDK generation errors\", \"customize TypeSpec\", \"rename SDK client\", \"rename SDK model\", \"hide operation from SDK\", \"fix analyzer errors\", \"resolve customization drift\", \"create subclient\", \"update metadata\", \"update version\". DO NOT USE FOR: publishing to package registries, CI pipeline configuration, API design review. INVOKES: azsdk_verify_setup, azsdk_package_generate_code, azsdk_package_build_code, azsdk_package_run_check, azsdk_package_run_tests, azsdk_customized_code_update, azsdk_package_update_changelog_content, azsdk_package_update_metadata, azsdk_package_update_version."
description: "Generate, build, and test Azure SDKs locally from TypeSpec with automatic customization. WHEN: \"generate SDK locally\", \"build SDK\", \"run SDK tests\", \"run CI checks\", \"validate CI checks\", \"passes all checks\", \"run all checks\", \"validate package\", \"update changelog\", \"fix SDK build errors\", \"fix breaking changes\", \"resolve SDK generation errors\", \"customize TypeSpec\", \"rename SDK client\", \"rename SDK model\", \"hide operation from SDK\", \"fix analyzer errors\", \"resolve customization drift\", \"create subclient\", \"update metadata\", \"update version\". DO NOT USE FOR: publishing to package registries, CI pipeline YAML configuration, API design review. INVOKES: azsdk_verify_setup, azsdk_package_generate_code, azsdk_package_build_code, azsdk_package_run_check, azsdk_package_run_tests, azsdk_customized_code_update, azsdk_package_update_changelog_content, azsdk_package_update_metadata, azsdk_package_update_version."
compatibility:
requires: "azure-sdk-mcp server, local azure-sdk-for-{language} clone, language build tools"
---
Expand All @@ -29,6 +29,8 @@ Prerequisites: azure-sdk-mcp server must be running. Without MCP, use `npx tsp-c

## Steps

> **CI checks only** (build + validate + test without regeneration): If the user asks to "run CI checks", "validate" or "check if a package passes all checks", skip to step 6. CI checks = build (`azsdk_package_build_code`) + validate (`azsdk_package_run_check`) + test (`azsdk_package_run_tests`).

1. **Select language** — Confirm target language: .NET, Java, JavaScript, Python, Go, or Rust.
2. **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.
3. **Identify config file** — Determine the path to the TypeSpec configuration file. See [config file details](references/detailed-workflow.md).
Expand Down Expand Up @@ -60,6 +62,9 @@ Prerequisites: azure-sdk-mcp server must be running. Without MCP, use `npx tsp-c
- "Update the changelog for this SDK package"
- "Update the package version"
- "Update the package metadata and ci.yml"
- "Can you run the CI checks for Azure.Health.Deidentification"
- "Can you validate Azure.Search.Documents passes all checks?"
- "Run all checks for the Azure.Storage.Blobs package"

## Troubleshooting

Expand Down
Loading