Official agent skill

Azure AI

by microsoft in microsoft/GitHub-Copilot-for-Azure

A skill your agent uses for Azure AI: Search, Speech, OpenAI, Document Intelligence.

OfficialMITAuto-check passedMedia & Creative

Install Azure AI

skills CLI
$ npx skills add microsoft/GitHub-Copilot-for-Azure --skill azure-ai -a claude-code

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

GitHub CLI
$ gh skill install microsoft/GitHub-Copilot-for-Azure azure-ai --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/microsoft/GitHub-Copilot-for-Azure.git skills-src && mkdir -p .claude/skills && cp -r skills-src/plugins/azure-skills/skills/azure-ai .claude/skills/azure-ai && 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
azure-ai
GitHub stars
255
Used in
2 other repos
Token cost
~852 tokens
SKILL.md length
231 words
Files
17 (incl. references)
Skills in repo
56
Repo updated
First seen
Licence
MIT

At a glance

A skill your agent uses for Azure AI: Search, Speech, OpenAI, Document Intelligence.

  • Azure AI: Search
  • SKILL.md covers Services, MCP Server (Preferred), AI Search Capabilities and Speech Capabilities, plus 2 more sections
  • Calls az
  • Document Intelligence

What it does

Azure AI is an agent skill from microsoft/GitHub-Copilot-for-Azure, published by the product's own GitHub organization. Use for Azure AI: Search, Speech, OpenAI, Document Intelligence. Helps with search, vector/hybrid search, speech-to-text, text-to-speech, transcription, OCR. WHEN: AI Search, query search, vector search, hybrid search, semantic search, speech-to-text, text-to-speech, transcribe, OCR, convert text to speech.

Its SKILL.md is about 850 tokens, which your agent loads only when the skill is triggered. The skill folder holds 18 other files, including reference files (for example `references/auth-best-practices.md`, `references/sdk/azure-ai-contentsafety-java.md` and `references/sdk/azure-ai-contentsafety-py.md`).

It sits in Media & Creative, covering Transcription, Speech recognition and synthesis and Text to speech and voice. It works with Microsoft Azure, OpenAI, Azure AI Search and Azure AI Document Intelligence. The repository describes itself as: GitHub Copilot for Azure. The licence is MIT.

When your agent uses it

  • Azure AI: Search
  • Document Intelligence

Example prompts

  • “/azure-ai”

What it can do on your machine

Read from SKILL.md and the folder at commit fcf2f3b. 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:

    • az

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

  • Network

    Links to these hosts (documentation or services it may open):

    • learn.microsoft.com

    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.

Context cost

Azure AI loads about 852 tokens when it runs, and up to ~7.2k if it reads all its reference files. Until then it costs about 79 tokens; SKILL.md has 231 words of instructions outside code blocks.

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

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 microsoft/GitHub-Copilot-for-Azure at commit fcf2f3b, republished under its MIT licence (© microsoft). 231 words, ~852 tokens.

Download SKILL.mdSave it as .claude/skills/azure-ai/SKILL.md (or your agent's skills folder). This skill also uses 16 other files; get the full folder from GitHub.
name
azure-ai
description
Use for Azure AI: Search, Speech, OpenAI, Document Intelligence. Helps with search, vector/hybrid search, speech-to-text, text-to-speech, transcription, OCR. WHEN: AI Search, query search, vector search, hybrid search, semantic search, speech-to-text, text-to-speech, transcribe, OCR, convert text to speech.
license
MIT
metadata.author
Microsoft
metadata.version
0.0.0-placeholder

Azure AI Services

Services

ServiceUse WhenMCP ToolsCLI
AI SearchFull-text, vector, hybrid searchazure__searchaz search
SpeechSpeech-to-text, text-to-speechazure__speech-
OpenAIGPT models, embeddings, DALL-E-az cognitiveservices
Document IntelligenceForm extraction, OCR--

MCP Server (Preferred)

When Azure MCP is enabled:

  • azure__search with command search_index_list - List search indexes
  • azure__search with command search_index_get - Get index details
  • azure__search with command search_query - Query search index
Speech
  • azure__speech with command speech_transcribe - Speech to text
  • azure__speech with command speech_synthesize - Text to speech

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.

AI Search Capabilities

FeatureDescription
Full-text searchLinguistic analysis, stemming
Vector searchSemantic similarity with embeddings
Hybrid searchCombined keyword + vector
AI enrichmentEntity extraction, OCR, sentiment

Speech Capabilities

FeatureDescription
Speech-to-textReal-time and batch transcription
Text-to-speechNeural voices, SSML support
Speaker diarizationIdentify who spoke when
Custom modelsDomain-specific vocabulary

SDK Quick References

For programmatic access to these services, see the condensed SDK guides:

Service Details

For deep documentation on specific services:

© microsoft, 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 16 other files (references) in plugins/azure-skills/skills/azure-ai of microsoft/GitHub-Copilot-for-Azure.

  • SKILL.md
  • references/auth-best-practices.md
  • references/sdk/azure-ai-contentsafety-java.md
  • references/sdk/azure-ai-contentsafety-py.md
  • references/sdk/azure-ai-contentsafety-ts.md
  • references/sdk/azure-ai-document-intelligence-dotnet.md
  • references/sdk/azure-ai-document-intelligence-ts.md
  • references/sdk/azure-ai-openai-dotnet.md
  • references/sdk/azure-ai-transcription-py.md
  • references/sdk/azure-ai-translation-text-py.md
  • references/sdk/azure-ai-translation-ts.md
  • references/sdk/azure-ai-vision-imageanalysis-java.md
  • references/sdk/azure-ai-vision-imageanalysis-py.md
  • references/sdk/azure-search-documents-dotnet.md
  • references/sdk/azure-search-documents-py.md
  • references/sdk/azure-search-documents-ts.md
  • version.json

Open the folder on GitHubat commit fcf2f3b

Used in 4 other repositories

We found 12 copies of this SKILL.md (exact, near-identical or edited) in other folders, from 2 other GitHub owners. This page covers the copy in microsoft/GitHub-Copilot-for-Azure, which our catalogue first saw on October 7, 2026.

Compare with similar skills

Azure AI 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.

Azure AI compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Azure AI this skillmicrosoft/GitHub-Copilot-for-Azure2552 repos~852Automated safety check: PassMIT
Neurolink Guidejuspay/neurolink143—~1.4kAutomated safety check: PassMIT
Local AI Useamd/skills398—~5kAutomated safety check: NotesMIT
Local AI App Integrationamd/skills398—~6kAutomated safety check: PassMIT
Delive Transcript AnalyzerXimilalaXiang/DeLive281—~1.4kAutomated safety check: PassApache-2.0
Agent Squad for TypeScript2FastLabs/agent-squad7.8k—~4.3kAutomated safety check: PassApache-2.0

Similar skills

  • Neurolink Guide

    juspay/neurolink

    Guide for using the NeuroLink SDK and CLI. An agent skill from juspay/neurolink.

    143 GitHub stars~1.4k tokensUpdated today
    AI & LLM EngineeringAuto-check passed
  • Local AI Use

    amd/skills

    Makes this agent generate images, transcribe audio, and synthesize speech on the user's own machine through a local Lemonade Server instead of a paid cloud API.

    398 GitHub stars~5k tokensUpdated today
    Media & CreativeAuto-check: notes
  • Integrates local AI capabilities into applications using Embeddable Lemonade.

    398 GitHub stars~6k tokensUpdated today
    Media & CreativeAuto-check passed
  • Delive Transcript Analyzer

    XimilalaXiang/DeLive

    Analyze, summarize, and extract insights from DeLive transcription sessions.

    281 GitHub stars~1.4k tokensUpdated yesterday
    Media & CreativeAuto-check passed
  • Agent Squad for TypeScript

    2FastLabs/agent-squad

    Guide to building Node.js and TypeScript apps on the agent-squad package: orchestrator, agent types, classifier routing, storage, retrievers and MCP tools.

    7.8k GitHub stars~4.3k tokensUpdated yesterday
    AI & LLM EngineeringAuto-check passed
  • GitHub Commenting

    juspay/neurolink

    How to post clean, rich, deduplicated GitHub PR review comments — suggestion blocks, multi-line anchors, markers, formatting rules.

    143 GitHub stars~698 tokensUpdated today
    DevelopmentAuto-check passed

More from microsoft/GitHub-Copilot-for-Azure

All 56 skills in this repo
  • Capacity

    microsoft/GitHub-Copilot-for-Azure

    Official

    Discovers available Azure OpenAI model capacity across regions and projects.

    255 GitHub starsUsed in 2 repos~1.7k tokens
    Auto-check passed
  • Deploy Model

    microsoft/GitHub-Copilot-for-Azure

    Official

    Unified Azure OpenAI model deployment skill with intelligent intent-based routing.

    255 GitHub starsUsed in 1 repo~1.8k tokens
    Auto-check passed
  • Entra Agent Id

    microsoft/GitHub-Copilot-for-Azure

    Official

    Provision Microsoft Entra Agent Identity Blueprints, BlueprintPrincipals, and per-instance Agent Identities via Microsoft Graph, and configure OAuth 2.0 token exchange (fmipath, OBO, cross-tenant)…

    255 GitHub starsUsed in 3 repos~4k tokens
    Auto-check passed
  • Microsoft Foundry

    microsoft/GitHub-Copilot-for-Azure

    Official

    Build, deploy, evaluate, optimize, fine-tune, and manage Microsoft Foundry agents, models, and resources end to end.

    255 GitHub starsUsed in 1 repo~6.7k tokens
    Auto-check passed
  • Azure Storage

    microsoft/GitHub-Copilot-for-Azure

    Official

    Azure Storage Services including Blob Storage, File Shares, Queue Storage, Table Storage, and Data Lake.

    255 GitHub starsUsed in 2 repos~1.3k tokens
    Auto-check passed
  • Preset

    microsoft/GitHub-Copilot-for-Azure

    Official

    Intelligently deploys Azure OpenAI models to optimal regions by analyzing capacity across all available regions.

    255 GitHub starsUsed in 2 repos~1.2k tokens
    Auto-check passed

Questions about Azure AI

What does Azure AI do?

A skill your agent uses for Azure AI: Search, Speech, OpenAI, Document Intelligence. Azure AI is an agent skill from microsoft/GitHub-Copilot-for-Azure, published by the product's own GitHub organization. Use for Azure AI: Search, Speech, OpenAI, Document Intelligence.

When should I use Azure AI?

Azure AI fits situations like: azure AI: Search; document Intelligence.

How do I install Azure AI in Claude Code?

Run `npx skills add microsoft/GitHub-Copilot-for-Azure --skill azure-ai -a claude-code`. Or copy the skill folder (plugins/azure-skills/skills/azure-ai in microsoft/GitHub-Copilot-for-Azure) into .claude/skills/azure-ai in your project. Claude Code loads it when a task matches its description.

How do I install Azure AI in Codex?

Run `npx skills add microsoft/GitHub-Copilot-for-Azure --skill azure-ai -a codex`. Or copy the skill folder (plugins/azure-skills/skills/azure-ai in microsoft/GitHub-Copilot-for-Azure) into .agents/skills/azure-ai in your project. Codex loads it when a task matches its description.

Can I use Azure AI 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 microsoft/GitHub-Copilot-for-Azure --skill azure-ai -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/azure-ai, .gemini/skills/azure-ai, .github/skills/azure-ai and .opencode/skills/azure-ai in your project.

What does Azure AI need to run?

Going by SKILL.md and its folder, Azure AI needs the command-line tools its instructions call (az).

Does Azure AI access the network?

SKILL.md names 1 domain. As links in the text: learn.microsoft.com. This is read from the text; nothing was executed.

Is Azure AI 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 Azure AI use?

Azure AI 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 Azure AI use?

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

What are the alternatives to Azure AI?

Skills that share tags, products or a category with Azure AI: Neurolink Guide (juspay/neurolink, 143 stars), Local AI Use (amd/skills, 398 stars), Local AI App Integration (amd/skills, 398 stars) and Delive Transcript Analyzer (XimilalaXiang/DeLive, 281 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Azure AI?

microsoft (a GitHub organization, an official publisher) maintains it in microsoft/GitHub-Copilot-for-Azure, which has 255 GitHub stars. The repository holds 56 skills in this directory. The repository was last updated on October 8, 2026.

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