azure-sdk-for-java: Skill for Claude Code

.github/skills/azsdk-common-sdk-breaking-change/SKILL.md

azsdk-common-sdk-breaking-change is a skill for Claude Code, Codex from Azure/azure-sdk-for-java. It costs 112 tokens per session (1,021 once invoked), scanned A, original, MIT.

A workflow for finding and addressing breaking changes in software development kits generated from TypeSpec. An SDK is a programming library that lets an application use a service, and a breaking change can make existing application code stop working.

In plain words
What is it for?
Use it to check an Azure SDK package or service for breaking changes, select target languages, generate the SDK locally, and apply custom updates.
Why use it?
It helps detect incompatible SDK changes before they reach users and provides a defined process for applying code customizations. It requires the Azure SDK MCP server, a service that supplies the required tools.

Skill for Claude CodeCodex ✓ vendor

Written for no agent in particular: nothing here depends on one.

This is Azure/azure-sdk-for-java's own configuration. It tells Claude Code and Codex how to work on azure-sdk-for-java itself, so it is not a mod to install elsewhere. Copy it as a starting point and replace the rules that are about this project. Everything azure-sdk-for-java configures →

About the project

Azure SDK for Java is a collection of Java libraries that let applications connect to and manage Azure services. Java developers use its client libraries to consume services and its management libraries to configure Azure resources. The catalogue add-ons support development with these libraries.

Azure/azure-sdk-for-java · 2,565 stars · on GitHub

Reuse

Borrowing it

Nothing to install: this file belongs to Azure/azure-sdk-for-java. Take a copy, put it at the same path in your own repository, and replace the rules that are about this project with yours.

Copy the file
curl -O https://raw.githubusercontent.com/Azure/azure-sdk-for-java/main/.github/skills/azsdk-common-sdk-breaking-change/SKILL.md
Clone the repo
git clone --depth 1 https://github.com/Azure/azure-sdk-for-java

Made for: Claude Code, Codex.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for azsdk-common-sdk-breaking-change

README.md
[![agentmods](https://agentmods.dev/badge/skills/azure/azure-sdk-for-java/azsdk-common-sdk-breaking-change/github.svg)](https://agentmods.dev/skills/azure/azure-sdk-for-java/azsdk-common-sdk-breaking-change)
Your own site
<a href="https://agentmods.dev/skills/azure/azure-sdk-for-java/azsdk-common-sdk-breaking-change"><img src="https://agentmods.dev/badge/skills/azure/azure-sdk-for-java/azsdk-common-sdk-breaking-change/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for azsdk-common-sdk-breaking-change

Your own site · 80×15
<a href="https://agentmods.dev/skills/azure/azure-sdk-for-java/azsdk-common-sdk-breaking-change"><img src="https://agentmods.dev/badge/skills/azure/azure-sdk-for-java/azsdk-common-sdk-breaking-change.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 112 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 1,021 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00112 $0.01021
Opus 5.5 $0.00045 $0.00408
Sonnet 5.5 $0.00022 $0.00204
Haiku 4.5 $0.00011 $0.00102

Measured 29d ago against content hash bd5da95966cb, method: parsed. Prices are Anthropic first-party input rates as of 2026-10-07, from the pricing page.

Security

Grade A, and why

azsdk-common-sdk-breaking-change scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 29d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

.github/skills/azsdk-common-sdk-breaking-change/SKILL.md · 52 lines

How it starts

The opening of the file, as written. The whole thing — 52 lines — stays where its author put it; the contents beside it link to each section on GitHub.

SDK Breaking Change Detection and Mitigation

MCP Tools

Tool Purpose
azure-sdk-mcp:azsdk_customized_code_update Apply customizations
azure-sdk-mcp:azsdk_package_detect_breaking_change Detect SDK breaking changes

Prerequisites: azure-sdk-mcp server must be running.

Steps

  1. 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.
  • 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.
  1. 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.
  2. Detect SDK breaking Changes - Run azure-sdk-mcp:azsdk_package_detect_breaking_change
  3. 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.
  4. 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.
  5. 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:

Read the full file on GitHub · 52 lines

Files

What ships with it

3 files beside SKILL.md in the same directory: the scripts, references and assets a skill reads on demand. Not counted in the per-session cost; read them before you install if any of them is executable.

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 29d ago First seen · 52 lines · 112 tokens per session scan A bd5da95966cb

Subscribe to this mod's changes

azsdk-common-sdk-breaking-change is a skill published in the GitHub repository Azure/azure-sdk-for-java (2,565 stars, last pushed today), licensed MIT. It adds 112 tokens to every session and 1,021 once invoked, about $0.0004 per session on Opus 5.5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-09-25.

Related

Other skills, from other repositories

generate-code-cs

Generate the code from typespec for C#. Parameter: C# SDK repository root location .

Azure/azure-sdk-for-net · 26 tokens

translate-a-sample

Translate the Azure SDK sample from python to C# and generate markdownn file for the sample. Parameters: C# SDK repository root; python SDK repository root; Package name: one of Azure.AI.Projects, Azure.AI.Projects.Agents or Azure.AI.Extensions.OpenAI; The name of sample file in Python SDK repository.

Azure/azure-sdk-for-net · 90 tokens

author-test

Generate a test given sample. Parameters: C# SDK repository root; Package name: one of Azure.AI.Projects, Azure.AI.Projects.Agents or Azure.AI.Extensions.OpenAI; the sample to use as a starting point for the test.

Azure/azure-sdk-for-net · 68 tokens

azure-appconfiguration-java

Azure App Configuration SDK for Java. Centralized application configuration management with key-value settings, feature flags, and snapshots. Triggers: "ConfigurationClient java", "app configuration java", "feature flag java", "configuration setting java", "azure config java".

microsoft/skills · 55 tokens

azure-monitor-query-java

Azure Monitor Query SDK for Java. Execute Kusto queries against Log Analytics workspaces and query metrics from Azure resources. Triggers: "LogsQueryClient java", "MetricsQueryClient java", "kusto query java", "log analytics java", "azure monitor query java". Note: This package is deprecated. Migrate to…

microsoft/skills · 81 tokens

azure-eventhub-java

Build real-time streaming applications with Azure Event Hubs SDK for Java. Use when implementing event streaming, high-throughput data ingestion, or building event-driven architectures.

microsoft/skills · 37 tokens