microsoft/azure-skills

azure-ai

Build and troubleshoot Azure AI Search, Speech, Document Intelligence, Content Understanding, Translator, Content Safety, and OpenAI apps.

View source

How to use

  1. Copy the installation command and review the source package before installing it in your own agent environment.
  2. Check the source document for required tools, credentials and supported hosts.
  3. Describe your input and desired deliverable; review the output against the source material.
npx skills add https://github.com/microsoft/azure-skills --skill azure-ai

Before you start

  • Installation does not include a model subscription, API allowance or permission to access your files.
  • Repository stars and installation counts describe activity, not an independent quality or security test.
Original skill document

Rendered from the source repository. Headings, examples, code, tables, links, and referenced images are preserved.

Azure AI Services

Scope and Handoffs

Request ScopeRoute To
Foundry projects, agents (Prompt/Hosted/Voice), model deployments, fine-tuning, quota, project RBAC, Foundry VNetmicrosoft-foundry
Foundry IQ knowledge bases and connectorsfoundry-iq (separate foundry-iq-skills plugin; if absent, say so)
Azure API Management AI Gateway policies (llm-content-safety, semantic cache, token limits)azure-aigateway
Classic AI Search, Speech SDK/REST/batch, Document Intelligence, Content Understanding, Translator, standalone Content Safety, OpenAI SDKStay in azure-ai
Roles, private endpoints, Studio storage or data handling for Document Intelligence or Content Understanding calls (including CU in the Foundry portal)Stay in azure-ai

Services and Diagnostic Workflows

Read the matching reference before diagnosing errors, validating local inputs, or collecting support evidence:

ServiceMCP / CLIPreflight & Diagnostics
AI Search (classic indexes, vector/hybrid/semantic queries, indexers/skillsets)azure__search (search_service_list, search_index_get, search_index_query), az searchIndex, query, and indexer diagnostics
Speech (STT, TTS, Fast/Batch Transcription, Batch Synthesis, SDK logs)azure__speech (speech_stt_recognize, speech_tts_synthesize), az cognitiveservicesSpeech SDK client diagnostics \Audio & REST/batch preflight
Document Intelligence (v4.0 Analyze, layout/OCR, custom extraction, classifiers, composed models)az cognitiveservicesInput, v4 migration, and Analyze diagnostics \Custom models, labels, and confidence
Content Understanding (analyzers, CU Studio, model defaults, custom analyzers)az cognitiveservicesSetup, API versions, and defaults \Custom analyzers \Diagnostics
Access, network, and data for Document Intelligence and Content Understandingazure__role (role_assignment_list), az role, az networkRoles and auth \Studio storage \Private networking \Data handling \Evidence without content
Translator (Text & Document Translation, glossaries, Blob auth)az cognitiveservicesDocument Translation & glossary preflight
Content Safety (standalone text:analyze, image:analyze, text:shieldPrompt, blocklists)az cognitiveservicesStandalone API preflight & diagnostics
OpenAI (direct SDK/API usage)az cognitiveservices.NET SDK

If Azure MCP is not enabled: In Copilot CLI or Claude Code, ask the user to run /mcp and enable Azure MCP; in other hosts, ask the user to enable Azure MCP through the host's MCP configuration. Offline local preflight scripts do not require Azure MCP or Azure sign-in.

For keyless authentication patterns across Azure AI SDKs, read Azure Authentication Best Practices.

SDK Quick References

Service Documentation

from this repository

More skills

All skills
microsoft
Official

microsoft-foundry

Build, deploy, evaluate, optimize, fine-tune, and manage Microsoft Foundry agents, models, and resources end to end. USE FOR: foundry, azd ai agent, azd provision/deploy, hosted agent scaffold/develop/run/deploy/troubleshoot, prompt agent, managed harness agent, Copilot harness, voice agent, create/update/invoke/evaluate agent, add tool to agent, agent insights, batch/continuous eval, continuous monitoring, agent CI/CD, optimize/improve prompt, optimize agent instructions, Agent Optimizer, datas

Total installs
768.3K
GitHub stars
1.7K
Updated
Nov 20
microsoft
Official

azure-diagnostics

Debug Azure production issues using AppLens, Azure Monitor, resource health, and safe triage, including evidence-only diagnosis without live access. WHEN: debug production issues, troubleshoot app service, app service high CPU, app service deployment failure, troubleshoot container apps, container app 503 or target port mismatch, troubleshoot functions, function telemetry missing or stopped after a config/connection-string change, troubleshoot AKS, VM RDP, Linux SSH, VM black screen, can't conne

Total installs
758.9K
GitHub stars
1.7K
Updated
Nov 20
microsoft
Official

azure-prepare

Prepare azd-based Azure projects for deployment: generates azure.yaml, infrastructure (Bicep/Terraform), and Dockerfiles for the Azure Developer CLI (azd) workflow. USE ONLY when the user explicitly wants to use azd as the deployment tool, or the project already has an azure.yaml file. DO NOT USE FOR: non-azd deployments, Python App Service code-only deploys (use python-appservice-deploy), or cross-cloud migration (use azure-cloud-migrate). WHEN: prepare app for azd, create azure.yaml, set up az

Total installs
758K
GitHub stars
1.7K
Updated
Nov 20
microsoft
Official

azure-compliance

Run Azure compliance and security audits with azqr plus Key Vault expiration checks. Covers best-practice assessment, resource review, policy/compliance validation, and security posture checks. WHEN: compliance scan, security audit, BEFORE running azqr (compliance cli tool), Azure best practices, Key Vault expiration check, expired certificates, expiring secrets, orphaned resources, compliance assessment.

Total installs
755.4K
GitHub stars
1.7K
Updated
Nov 20