Official agent skill

Azsdk Common Prepare Release Plan

by Azure in Azure/azure-sdk-tools

Create, get, update, abandon, and link SDK PRs to release plan work items for Azure SDK releases.

OfficialMITAuto-check passedProduct & Project Management

Install Azsdk Common Prepare Release Plan

skills CLI
$ npx skills add Azure/azure-sdk-tools --skill azsdk-common-prepare-release-plan -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install Azure/azure-sdk-tools azsdk-common-prepare-release-plan --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/Azure/azure-sdk-tools.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.github/skills/azsdk-common-prepare-release-plan .claude/skills/azsdk-common-prepare-release-plan && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
azsdk-common-prepare-release-plan
GitHub stars
134
Token cost
~2.7k tokens
SKILL.md length
1,240 words
Files
6 (incl. references)
Skills in repo
35
Repo updated
First seen
Licence
MIT

At a glance

Create, get, update, abandon, and link SDK PRs to release plan work items for Azure SDK releases.

  • Works in 6 steps: Create Release Plan → Get Release Plan → Update Release Plan / Update API Spec in… → …
  • : create release plan
  • SKILL.md covers Triggers, Rules, MCP Tools and Use Cases, plus 2 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Azsdk Common Prepare Release Plan is an agent skill from Azure/azure-sdk-tools, published by the product's own GitHub organization. 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:azsdkcreatereleaseplan…

Its SKILL.md is about 2.7k tokens, which your agent loads only when the skill is triggered. The skill folder holds 8 other files, including reference files (for example `evals/eval.yaml`, `evals/schedule-risk.eval.yaml` and `evals/trigger.eval.yaml`). Compatibility notes: azure-sdk-mcp server, API spec PR in Azure/azure-rest-api-specs

It sits in Product & Project Management, covering Feature launches and release readiness and OpenAPI specifications. It works with Microsoft Azure, Model Context Protocol and Azure DevOps. The repository describes itself as: Tools repository leveraged by the Azure SDK team. The licence is MIT.

When your agent uses it

  • : create release plan
  • Get release plan
  • Update release plan
  • Update API spec in release plan

Example prompts

  • “create release plan”
  • “get release plan”
  • “update release plan”
  • “/azsdk-common-prepare-release-plan”

Requirements

  • Python 3
  • Compatibility (from SKILL.md): azure-sdk-mcp server, API spec PR in Azure/azure-rest-api-specs

Workflow steps

6 steps, taken from the step headings in SKILL.md.

  1. Create Release Plan
  2. Get Release Plan
  3. Update Release Plan / Update API Spec in Release Plan
  4. Update SDK/Package Details in Release Plan
  5. Abandon a Release Plan
  6. Link SDK Pull Request to Release Plan

What it can do on your machine

Read from SKILL.md and the folder at commit 942ef24. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

  • Compatibility

    azure-sdk-mcp server, API spec PR in Azure/azure-rest-api-specs

    From compatibility in the SKILL.md frontmatter.

Context cost

Azsdk Common Prepare Release Plan loads about 2.7k tokens when it runs, and up to ~3.4k if it reads all its reference files. Until then it costs about 233 tokens; SKILL.md has 1,240 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~233
When it runs · the whole SKILL.md, loaded when a task matches
~2.7k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~3.4k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from Azure/azure-sdk-tools at commit 942ef24, republished under its MIT licence (© Azure). 1,240 words, ~2,735 tokens.

Download SKILL.mdSave it as .claude/skills/azsdk-common-prepare-release-plan/SKILL.md (or your agent's skills folder). This skill also uses 5 other files; get the full folder from GitHub.
name
azsdk-common-prepare-release-plan
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
license
MIT
metadata.version
1.0.0
metadata.distribution
shared

Prepare Release Plan

This 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.

Triggers

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 WHEN: "create release plan", "get release plan", "update 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

Rules

  • Do not display Azure DevOps work item URLs; only provide the Release Plan Link and ID.
  • Require an API spec PR link or a TypeSpec project path before creating or updating a plan.
  • Validate that the spec PR repository matches the requested API release type before creation.
  • Release plan tools accept either a Release Plan ID or an Azure DevOps work item ID, except metadata updates: azure-sdk-mcp:azsdk_update_release_plan requires the exact WorkItemId. If only a Release Plan ID is known, get that plan and use its returned WorkItemId; do not treat the two IDs as interchangeable.
  • Create/update accept optional specCommitSha; omission on update preserves the saved SHA.
  • 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.

MCP Tools

ToolPurpose
azure-sdk-mcp:azsdk_create_release_planCreate a new release plan
azure-sdk-mcp:azsdk_get_release_planGet plan by ID, path, or spec PR
azure-sdk-mcp:azsdk_update_release_planUpdate release plan metadata
azure-sdk-mcp:azsdk_update_release_plan_targetUpdate the target release month
azure-sdk-mcp:azsdk_update_api_spec_pull_request_in_release_planUpdate API spec PR URL in plan
azure-sdk-mcp:azsdk_update_sdk_details_in_release_planUpdate SDK/package details in plan
azure-sdk-mcp:azsdk_abandon_release_planAbandon a release plan
azure-sdk-mcp:azsdk_link_sdk_pull_request_to_release_planLink SDK PR to release plan
azure-sdk-mcp:azsdk_link_namespace_approval_issueLink namespace approval issue

Use Cases

1. Create Release Plan

When: User wants to create a release plan for a TypeSpec project.

Steps:

  1. 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.
  2. Check Existing — Run azure-sdk-mcp:azsdk_get_release_plan with the relative typeSpecProjectPath to check if a release plan already exists.
    • 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.
    • 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.
    • If no release plan exists, proceed to step 3.
  3. Gather Info — Collect required details from the user. See details:
    • Target release month/year (format: "Month YYYY", e.g. "June 2026"). Do NOT use formats like "2026-06" or "06/2026" — these are invalid.
    • API release type: Value must be one of the following: "Private Preview", "Public Preview", or "GA"
    • Spec PR URL (optional)
    • Service Tree ID (GUID) — optional if previously created
    • Product Tree ID (GUID) — optional if previously created
  4. Create — Run azure-sdk-mcp:azsdk_create_release_plan with the collected parameters. Use forceCreateReleasePlan: true only if an existing release plan was found for a different API release type.
  5. Namespace — For first management plane releases, link namespace approval issue using azure-sdk-mcp:azsdk_link_namespace_approval_issue.

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.

Tool: azure-sdk-mcp:azsdk_create_release_plan


2. Get Release Plan

When: User wants to check the status or details of an existing release plan.

Steps:

  1. Identify Plan — Ask user for one of:
    • Release plan ID or work item ID
    • Relative TypeSpec project path (e.g. specification/contosowidgetmanager/Contoso.WidgetManager)
    • Spec PR URL
  2. 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.
  3. Display — Show the release plan ID, status, linked PRs, and SDK details. Always relay schedule-risk warnings and recommended actions from the response.

Tool: azure-sdk-mcp:azsdk_get_release_plan


Show full SKILL.md (503 more words)Show less
3. Update Release Plan / Update API Spec in Release Plan

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.

Steps:

  1. Identify Plan — Use the exact Azure DevOps work item ID. If only a Release Plan ID is known, get the plan and use its returned WorkItemId.
  2. Update Metadata — Run azure-sdk-mcp:azsdk_update_release_plan with:
    • typeSpecProjectPath (required)
    • workItemId (required — exact Azure DevOps work item ID; no PR/path fallback)
    • specPullRequestUrl (optional)
    • sdkReleaseType (required — do NOT default this from API release type; always ask user explicitly)
    • serviceTreeId (optional)
    • productTreeId (optional)
  3. 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:
    • specPullRequestUrl (required)
    • workItemId or releasePlanId

Tools: azure-sdk-mcp:azsdk_update_release_plan, azure-sdk-mcp:azsdk_update_api_spec_pull_request_in_release_plan


4. Update SDK/Package Details in Release Plan

When: User needs to update SDK language and package name details in the release plan after code generation or configuration changes.

Steps:

  1. Identify Plan — Get the Release Plan ID or work item ID from the user (either is accepted).
  2. Identify TypeSpec Project — Get or confirm the TypeSpec project path.
  3. Update — Run azure-sdk-mcp:azsdk_update_sdk_details_in_release_plan with:
    • workItemId (required — accepts either the Release Plan ID or the work item ID)
    • typeSpecProjectPath (required)

Tool: azure-sdk-mcp:azsdk_update_sdk_details_in_release_plan


5. Abandon a Release Plan

When: User decides to cancel or discard a release plan that is no longer needed.

Steps:

  1. Identify Plan — Get the work item ID or release plan ID from the user.
  2. Confirm — Ask user to confirm abandonment: "Are you sure you want to abandon this release plan? This action updates the status to Abandoned."
  3. Abandon — Run azure-sdk-mcp:azsdk_abandon_release_plan with:
    • workItemId or releasePlanId

Tool: azure-sdk-mcp:azsdk_abandon_release_plan


When: SDK pull requests have been created and need to be associated with the release plan.

Steps:

  1. Identify Plan — Get the Release Plan ID or work item ID from the user (either is accepted).
  2. Collect PR Info — Get the SDK pull request URL and language from the user.
  3. Link — Run azure-sdk-mcp:azsdk_link_sdk_pull_request_to_release_plan with:
    • pullRequestUrl (required)
    • language (required — e.g., ".NET", "Java", "JavaScript", "Python", "Go")
    • workItemId or releasePlanId (either accepts the Release Plan ID or the work item ID)
  4. Repeat — If multiple SDK PRs exist for different languages, repeat for each.

Tool: azure-sdk-mcp:azsdk_link_sdk_pull_request_to_release_plan


Examples

  • "Create a release plan for my spec PR"
  • "Get the release plan for work item 12345"
  • "What is the status of my release plan?"
  • "Update the API spec PR in my release plan"
  • "Update SDK details in release plan 67890"
  • "Abandon release plan 11111"
  • "Link my SDK PR to release plan"
  • "Link Python SDK PR #100 to release plan 67890"

Troubleshooting

  • Requires azure-sdk-mcp server; no CLI fallback — prompt user to configure MCP if unavailable.
  • If creation fails, verify spec PR URL and Service Tree IDs.
  • If update fails, ensure the Release Plan ID or work item ID is correct and the plan is not already abandoned.
  • If linking fails, verify the SDK PR URL is valid and the language matches a supported value.

© Azure, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 5 other files (references) in .github/skills/azsdk-common-prepare-release-plan of Azure/azure-sdk-tools.

  • SKILL.md
  • evals/eval.yaml
  • evals/schedule-risk.eval.yaml
  • evals/trigger.eval.yaml
  • fixtures/tspconfig.yaml
  • references/release-plan-details.md

Open the folder on GitHubat commit 942ef24

Compare with similar skills

Azsdk Common Prepare Release Plan next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Azsdk Common Prepare Release Plan compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Azsdk Common Prepare Release Plan this skillAzure/azure-sdk-tools134—~2.7kAutomated safety check: PassMIT
Azsdk Common Prepare Release PlanAzure/azure-sdk-for-android121—~733Automated safety check: PassMIT
Azsdk Common SDK ReleaseAzure/azure-sdk-for-android121—~478Automated safety check: PassMIT
Repo Genomeruvnet/metaharness696—~772Automated safety check: PassMIT
Verify Witnessruvnet/metaharness696—~472Automated safety check: PassMIT
Azsdk Common Pipeline TroubleshootingAzure/azure-sdk-for-android121—~496Automated safety check: PassMIT

Similar skills

  • Azsdk Common Prepare Release Plan

    Azure/azure-sdk-for-android

    Official

    Create and manage release plan work items for Azure SDK releases across languages.

    121 GitHub stars~733 tokensUpdated 4 mo ago
    Product & Project ManagementAuto-check passed
  • Azsdk Common SDK Release

    Azure/azure-sdk-for-android

    Official

    Check release readiness and trigger the release pipeline for Azure SDK packages.

    121 GitHub stars~478 tokensUpdated 4 mo ago
    Product & Project ManagementAuto-check passed
  • Repo Genome

    ruvnet/metaharness

    7-section readiness scorecard for a LOCAL repo. An agent skill from ruvnet/metaharness.

    696 GitHub stars~772 tokensUpdated yesterday
    Product & Project ManagementAuto-check passed
  • Verify Witness

    ruvnet/metaharness

    Verify the Ed25519 witness manifest of a scaffolded harness.

    696 GitHub stars~472 tokensUpdated yesterday
    Product & Project ManagementAuto-check passed
  • Azsdk Common Pipeline Troubleshooting

    Azure/azure-sdk-for-android

    Official

    Diagnose and resolve failures in Azure SDK CI and generation pipelines.

    121 GitHub stars~496 tokensUpdated 4 mo ago
    Agent WorkflowsAuto-check passed
  • Roam Release Readiness

    Cranot/roam-code

    Qualify a Roam commit or accumulated batch for package, website, or server publication; reconcile source, tests, review, CI and deployed identities, and identify the next authorized release step.

    517 GitHub stars~1.7k tokensUpdated yesterday
    Product & Project ManagementAuto-check passed

More from Azure/azure-sdk-tools

All 35 skills in this repo
  • Apiview Feedback Resolution

    Azure/azure-sdk-tools

    Official

    Analyze and resolve APIView review feedback on Azure SDK PRs.

    134 GitHub stars~547 tokensUpdated yesterday
    Auto-check passed
  • Official

    Deploy test resources and run Azure SDK tests in live, record, or playback mode.

    134 GitHub stars~1.5k tokensUpdated yesterday
    Auto-check: notes
  • Azsdk Common Pipeline Analysis

    Azure/azure-sdk-tools

    Official

    Analyze Azure SDK CI/CD pipeline failures into a structured diagnosis, and define the required output format.

    134 GitHub stars~1.2k tokensUpdated yesterday
    Auto-check passed
  • Azure Typespec Assessment

    Azure/azure-sdk-tools

    Official

    Assess Azure TypeSpec Git diffs for semantic intent, REST and downstream SDK breaking changes, Azure Guidelines compliance, and documentation completeness.

    134 GitHub stars~1.9k tokensUpdated yesterday
    Auto-check passed
  • Azure Typespec Author

    Azure/azure-sdk-tools

    Official

    Authors and modifies Azure TypeSpec (.tsp) API specifications.

    134 GitHub stars~1.9k tokensUpdated yesterday
    Auto-check passed

Questions about Azsdk Common Prepare Release Plan

What does Azsdk Common Prepare Release Plan do?

Create, get, update, abandon, and link SDK PRs to release plan work items for Azure SDK releases. Azsdk Common Prepare Release Plan is an agent skill from Azure/azure-sdk-tools, published by the product's own GitHub organization. Create, get, update, abandon, and link SDK PRs to release plan work items for Azure SDK releases.

When should I use Azsdk Common Prepare Release Plan?

Azsdk Common Prepare Release Plan fits situations like: : create release plan; get release plan; update release plan; update API spec in release plan.

How do I install Azsdk Common Prepare Release Plan in Claude Code?

Run `npx skills add Azure/azure-sdk-tools --skill azsdk-common-prepare-release-plan -a claude-code`. Or copy the skill folder (.github/skills/azsdk-common-prepare-release-plan in Azure/azure-sdk-tools) into .claude/skills/azsdk-common-prepare-release-plan in your project. Claude Code loads it when a task matches its description.

How do I install Azsdk Common Prepare Release Plan in Codex?

Run `npx skills add Azure/azure-sdk-tools --skill azsdk-common-prepare-release-plan -a codex`. Or copy the skill folder (.github/skills/azsdk-common-prepare-release-plan in Azure/azure-sdk-tools) into .agents/skills/azsdk-common-prepare-release-plan in your project. Codex loads it when a task matches its description.

Can I use Azsdk Common Prepare Release Plan in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add Azure/azure-sdk-tools --skill azsdk-common-prepare-release-plan -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/azsdk-common-prepare-release-plan, .gemini/skills/azsdk-common-prepare-release-plan, .github/skills/azsdk-common-prepare-release-plan and .opencode/skills/azsdk-common-prepare-release-plan in your project.

What does Azsdk Common Prepare Release Plan need to run?

SKILL.md names no scripts, command-line tools or credentials: Azsdk Common Prepare Release Plan is instructions for the agent only. Our summary lists: Python 3. Compatibility (from SKILL.md): azure-sdk-mcp server, API spec PR in Azure/azure-rest-api-specs.

Does Azsdk Common Prepare Release Plan access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Azsdk Common Prepare Release Plan safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Azsdk Common Prepare Release Plan use?

Azsdk Common Prepare Release Plan is published under the MIT licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Azsdk Common Prepare Release Plan use?

About 2.7k tokens (SKILL.md is roughly 11k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 624 tokens, read only when the agent opens those files.

What are the alternatives to Azsdk Common Prepare Release Plan?

Skills that share tags, products or a category with Azsdk Common Prepare Release Plan: Azsdk Common Prepare Release Plan (Azure/azure-sdk-for-android, 121 stars), Azsdk Common SDK Release (Azure/azure-sdk-for-android, 121 stars), Repo Genome (ruvnet/metaharness, 696 stars) and Verify Witness (ruvnet/metaharness, 696 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Azsdk Common Prepare Release Plan?

Azure (a GitHub organization, an official publisher) maintains it in Azure/azure-sdk-tools, which has 134 GitHub stars. The repository holds 35 skills in this directory. The repository was last updated on October 10, 2026.

Source: Azure/azure-sdk-tools on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.