Official agent skill

Azsdk Common Live And Recorded Tests

by Azure in Azure/azure-sdk-tools

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

OfficialMITAuto-check: notesDevOps & Cloud

Install Azsdk Common Live And Recorded Tests

skills CLI
$ npx skills add Azure/azure-sdk-tools --skill azsdk-common-live-and-recorded-tests -a claude-code

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

GitHub CLI
$ gh skill install Azure/azure-sdk-tools azsdk-common-live-and-recorded-tests --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/plugins/azure-sdk-tools/skills/live-and-recorded-tests .claude/skills/azsdk-common-live-and-recorded-tests && 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-live-and-recorded-tests
GitHub stars
134
Token cost
~1.5k tokens
SKILL.md length
746 words
Files
10 (incl. references)
Skills in repo
35
Repo updated
First seen
Licence
MIT

At a glance

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

  • Works in 8 steps: Identify service directory — Determine… → Check for existing deployment — Look for… → Verify Azure context — Run Get-AzContext… → …
  • : writing new tests
  • SKILL.md covers MCP Tools, Prerequisites, Steps and Examples, plus 1 more section
  • Calls dotnet, mvn and npm

What it does

Azsdk Common Live And Recorded Tests is an agent skill from Azure/azure-sdk-tools, published by the product's own GitHub organization. Deploy test resources and run Azure SDK tests in live, record, or playback mode. WHEN: "run live tests", "run recorded tests", "deploy test resources", "record tests", "run tests in record mode", "clean up test resources", "run tests against live resources". DO NOT USE FOR: writing new tests, authoring Bicep templates, playback-only test runs without resource deployment. INVOKES: azure-sdk-mcp:azsdkpackageruntests.

Its SKILL.md is about 1.5k tokens, which your agent loads only when the skill is triggered. The skill folder holds 11 other files, including reference files (for example `eval.yaml`, `references/test-modes.md` and `references/test-resource-cleanup.md`). Compatibility notes: azure-sdk-mcp server, Azure PowerShell (Az module), local azure-sdk-for-{language} clone

It sits in DevOps & Cloud, covering Infrastructure as code, MCP servers and Deployment. It works with Microsoft Azure, Bicep, Model Context Protocol and Azure Key Vault. The repository describes itself as: Tools repository leveraged by the Azure SDK team. The licence is MIT.

When your agent uses it

  • : writing new tests
  • Authoring Bicep templates
  • Playback-only test runs without resource deployment

Example prompts

  • “run live tests”
  • “run recorded tests”
  • “deploy test resources”
  • “/azsdk-common-live-and-recorded-tests”

Requirements

  • Compatibility (from SKILL.md): azure-sdk-mcp server, Azure PowerShell (Az module), local azure-sdk-for-{language} clone

Workflow steps

8 steps, taken from the first numbered list in SKILL.md.

  1. Identify service directory — Determine the service directory for the package under test (e.g., keyvault, storage). This is required by the…
  2. Check for existing deployment — Look for a .env file at either the service directory level (next to test-resources.bicep, e.g…
  3. Verify Azure context — Run Get-AzContext to check for an active Azure PowerShell session. If the command fails because the Az module is…
  4. Confirm deployment — Even if no existing .env file is found, confirm with the user before proceeding to deploy test resources. Deployment…
  5. Deploy test resources — Run eng/common/TestResources/New-TestResources.ps1 with the service directory, tenant ID, subscription ID, and any…
  6. Save environment — Capture the environment variables output by the deployment script. If the script writes a .env file, note its path…
  7. Run tests — Call the azure-sdk-mcp:azsdk_package_run_tests MCP tool (do NOT run test commands directly in the terminal). Provide the…
  8. Clean up — Ask the user whether to clean up test resources. If yes, run eng/common/TestResources/Remove-TestResources.ps1. If no, inform…

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

    Shell commands in SKILL.md call:

    • dotnet
    • mvn
    • npm
    • go

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

  • Network

    No URLs in SKILL.md. Its commands use npm, which can reach the network depending on how they are called.

    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, Azure PowerShell (Az module), local azure-sdk-for-{language} clone

    From compatibility in the SKILL.md frontmatter.

Context cost

Azsdk Common Live And Recorded Tests loads about 1.5k tokens when it runs, and up to ~3.1k if it reads all its reference files. Until then it costs about 115 tokens; SKILL.md has 746 words of instructions outside code blocks.

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

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: notes

The automated check noted patterns worth knowing about, such as sudo or a known installer.

  • NoteMentions a .env fileSKILL.md:31
    for existing deployment** — Look for a `.env` file at either the service directory level  (next to `test-resources.bice
  • NoteMentions a .env fileSKILL.md:33
    firm deployment** — Even if no existing `.env` file is found, confirm with the user before proceeding to deploy test res
  • NoteMentions a .env fileSKILL.md:35
    ployment script. If the script writes a `.env` file, note its path. Otherwise, collect the environment variables from th
  • NoteMentions a .env fileSKILL.md:36
    ve`, or `playback`) and the path to the `.env` file containing test environment variables. When tests run in record mode
  • NoteMentions a .env fileSKILL.md:42
    ng the live test deployment specified in .env"
  • NoteMentions a .env fileSKILL.md:53
    are being passed correctly. Verify the `.env` file path is correct.

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). 746 words, ~1,514 tokens.

Download SKILL.mdSave it as .claude/skills/azsdk-common-live-and-recorded-tests/SKILL.md (or your agent's skills folder). This skill also uses 9 other files; get the full folder from GitHub.
name
azsdk-common-live-and-recorded-tests
description
Deploy test resources and run Azure SDK tests in live, record, or playback mode. WHEN: "run live tests", "run recorded tests", "deploy test resources", "record tests", "run tests in record mode", "clean up test resources", "run tests against live resources". DO NOT USE FOR: writing new tests, authoring Bicep templates, playback-only test runs without resource deployment. INVOKES: azure-sdk-mcp:azsdk_package_run_tests.
compatibility
azure-sdk-mcp server, Azure PowerShell (Az module), local azure-sdk-for-{language} clone
license
MIT
metadata.version
0.1.0
metadata.distribution
shared

Live and Recorded Tests

MCP Tools

ToolPurpose
azure-sdk-mcp:azsdk_package_run_testsRun tests in playback, record, or live mode

IMPORTANT: ALWAYS use the azure-sdk-mcp:azsdk_package_run_tests MCP tool to run tests. NEVER run test commands directly in the terminal (e.g., pytest, dotnet test, mvn test, npm test, go test). The MCP tool handles test mode configuration, environment setup, and automatic asset pushing in record mode.

Prerequisites

  • azure-sdk-mcp server must be running
  • Azure PowerShell module (Az) must be installed. If Get-AzContext fails with a command-not-found error, instruct the user to install it with Install-Module Az -Scope CurrentUser -Force.
  • For live/record modes: an Azure subscription with permissions to create resources
    • Use the Azure SDK Test Resources - TME (id: 4d042dc6-fe17-4698-a23f-ec6a8d1e98f4) subscription if not already authenticated and no other subscription is specified.

Steps

  1. Identify service directory — Determine the service directory for the package under test (e.g., keyvault, storage). This is required by the test resource deployment script.
  2. Check for existing deployment — Look for a .env file at either the service directory level (next to test-resources.bicep, e.g. sdk/storage/.env) or at the package level (e.g. sdk/storage/storage-blob/.env). If one exists, inform the user that a previous deployment appears to be available and ask whether to reuse the existing deployment or redeploy test resources. If reusing, skip to step 7.
  3. Verify Azure context — Run Get-AzContext to check for an active Azure PowerShell session. If the command fails because the Az module is not installed, instruct the user to run Install-Module Az -Scope CurrentUser -Force first. If no context exists, guide the user through Connect-AzAccount -TenantId [TME tenant ID]. If Connect-AzAccount appears to hang and no browser window opens for authentication, tell the user to copy and paste the command into a new PowerShell window. Confirm the correct subscription is selected.
  4. Confirm deployment — Even if no existing .env file is found, confirm with the user before proceeding to deploy test resources. Deployment creates Azure resources that may incur costs.
  5. Deploy test resources — Run eng/common/TestResources/New-TestResources.ps1 with the service directory, tenant ID, subscription ID, and any user-provided parameters. Use the TME tenant ID and subscription ID if one has not already been provided. See deployment parameters for details. The script outputs environment variables needed for live/record test runs.
  6. Save environment — Capture the environment variables output by the deployment script. If the script writes a .env file, note its path. Otherwise, collect the environment variables from the script output. In azure-sdk-for-net, if the script outputs a file like test-resources.bicep.env instead of a .env file, move on to step 7 and call the MCP tool WITHOUT passing an env filepath. The test framework will automatically find and handle this special file type.
  7. Run tests — Call the azure-sdk-mcp:azsdk_package_run_tests MCP tool (do NOT run test commands directly in the terminal). Provide the appropriate test mode (record, live, or playback) and the path to the .env file containing test environment variables. When tests run in record mode and all tests pass, the tool automatically pushes recorded test assets to the assets repo.
  8. Clean up — Ask the user whether to clean up test resources. If yes, run eng/common/TestResources/Remove-TestResources.ps1. If no, inform the user that resources remain deployed for subsequent test runs. See cleanup details.
Show full SKILL.md (215 more words)Show less

Examples

  • "Deploy test resources and run live tests for this package"
  • "Run the tests in record mode using the live test deployment specified in .env"
  • "Clean up my test resources for keyvault"
  • "Run tests in record mode against my existing deployment"
  • "Set up live test resources for storage and run all tests"

Troubleshooting

  • No Azure context: Run Connect-AzAccount and select the target subscription with Set-AzContext -SubscriptionId <id>. If the browser window for authentication fails to open and the command appears to hang, tell the user to copy and paste the Connect-AzAccount command into a new PowerShell window and run it there instead.
  • Az module not installed: If Get-AzContext fails with a command-not-found error, the Azure PowerShell module is not installed. Instruct the user to run Install-Module Az -Scope CurrentUser -Force and then retry.
  • Deployment fails with auth error: Verify that the signed-in account has Contributor or Owner role on the target subscription. Check Get-AzContext output.
  • Deployment fails with resource conflict: A previous deployment may still exist. Try running Remove-TestResources.ps1 first, or use a different BaseName.
  • Tests fail in record mode: Check that all environment variables from the deployment are being passed correctly. Verify the .env file path is correct.
  • Assets push fails after recording: Ensure the assets repo is configured and accessible. Check git authentication.

© 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 9 other files (references) in plugins/azure-sdk-tools/skills/live-and-recorded-tests of Azure/azure-sdk-tools.

  • SKILL.md
  • eval.yaml
  • references/test-modes.md
  • references/test-resource-cleanup.md
  • references/test-resource-deployment.md
  • tasks/anti-trigger-write-tests.yaml
  • tasks/anti-trigger.yaml
  • tasks/cleanup-resources.yaml
  • tasks/deploy-and-run-live.yaml
  • tasks/record-with-env.yaml

Open the folder on GitHubat commit 942ef24

Compare with similar skills

Azsdk Common Live And Recorded Tests 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 Live And Recorded Tests compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Azsdk Common Live And Recorded Tests this skillAzure/azure-sdk-tools134—~1.5kAutomated safety check: NotesMIT
AWS Cdk Developmentzxkane/aws-skills3672 repos~2.5kAutomated safety check: PassMIT
Azure Architecture Autopilotgithub/awesome-copilot40k1 repos~1.9kAutomated safety check: PassMIT
Azure Bicep Skilltimothywarner-org/claude-code224—~2.9kAutomated safety check: PassMIT
Azv Bicep Diagram SyncAzure/AZVerify101—~2.9kAutomated safety check: PassMIT
Azv Azure To BicepAzure/AZVerify101—~5.4kAutomated safety check: WarnMIT

Similar skills

  • AWS Cdk Development

    zxkane/aws-skills

    AWS Cloud Development Kit (CDK) expert for building cloud infrastructure with TypeScript/Python.

    367 GitHub starsUsed in 2 repos~2.5k tokens
    DevOps & CloudAuto-check passed
  • Azure Architecture Autopilot

    github/awesome-copilot

    Official

    Designs Azure infrastructure from a natural-language description, or diagrams an existing resource group, then refines the design through conversation and deploys it with Bicep.

    40k GitHub starsUsed in 1 repo~1.9k tokens
    DevOps & CloudAuto-check passed
  • Azure Bicep Skill

    timothywarner-org/claude-code

    A skill your agent uses when authoring, reviewing, or refactoring Azure Bicep code.

    224 GitHub stars~2.9k tokensUpdated 2 mo ago
    DevOps & CloudAuto-check passed
  • Official

    Compare Bicep templates against a Draw.io Azure architecture diagram to detect resource-level divergence.

    101 GitHub stars~2.9k tokensUpdated 1 mo ago
    DevOps & CloudAuto-check passed
  • Azv Azure To Bicep

    Azure/AZVerify

    Official

    Reverse-engineer a live Azure scope (resource group or filtered subscription) into deployment-ready, modular Bicep templates with parameter files.

    101 GitHub stars~5.4k tokensUpdated 1 mo ago
    DevOps & CloudAuto-check: warnings
  • Azure Deployment Preflight

    github/awesome-copilot

    Official

    Performs comprehensive preflight validation of Bicep deployments to Azure, including template syntax validation, what-if analysis, and permission checks.

    40k GitHub starsUsed in 1 repo~1.9k tokens
    DevOps & CloudAuto-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
  • 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
  • Official

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

    134 GitHub stars~2.7k 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

Categories

Questions about Azsdk Common Live And Recorded Tests

What does Azsdk Common Live And Recorded Tests do?

Deploy test resources and run Azure SDK tests in live, record, or playback mode. Azsdk Common Live And Recorded Tests is an agent skill from Azure/azure-sdk-tools, published by the product's own GitHub organization. Deploy test resources and run Azure SDK tests in live, record, or playback mode.

When should I use Azsdk Common Live And Recorded Tests?

Azsdk Common Live And Recorded Tests fits situations like: : writing new tests; authoring Bicep templates; playback-only test runs without resource deployment.

How do I install Azsdk Common Live And Recorded Tests in Claude Code?

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

How do I install Azsdk Common Live And Recorded Tests in Codex?

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

Can I use Azsdk Common Live And Recorded Tests 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-live-and-recorded-tests -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-live-and-recorded-tests, .gemini/skills/azsdk-common-live-and-recorded-tests, .github/skills/azsdk-common-live-and-recorded-tests and .opencode/skills/azsdk-common-live-and-recorded-tests in your project.

What does Azsdk Common Live And Recorded Tests need to run?

Going by SKILL.md and its folder, Azsdk Common Live And Recorded Tests needs the command-line tools its instructions call (dotnet, mvn, npm and go). Compatibility (from SKILL.md): azure-sdk-mcp server, Azure PowerShell (Az module), local azure-sdk-for-{language} clone.

Does Azsdk Common Live And Recorded Tests access the network?

SKILL.md contains no URLs. Its commands use npm, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Azsdk Common Live And Recorded Tests safe to install?

Our automated static check of SKILL.md found notes only (mentions a .env file), nothing it rates as a warning. It is not a guarantee. Review the folder before installing.

What licence does Azsdk Common Live And Recorded Tests use?

Azsdk Common Live And Recorded Tests 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 Live And Recorded Tests use?

About 1.5k tokens (SKILL.md is roughly 6.1k 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 1.6k tokens, read only when the agent opens those files.

What are the alternatives to Azsdk Common Live And Recorded Tests?

Skills that share tags, products or a category with Azsdk Common Live And Recorded Tests: AWS Cdk Development (zxkane/aws-skills, 367 stars), Azure Architecture Autopilot (github/awesome-copilot, 40k stars), Azure Bicep Skill (timothywarner-org/claude-code, 224 stars) and Azv Bicep Diagram Sync (Azure/AZVerify, 101 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Azsdk Common Live And Recorded Tests?

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.