Official agent skill

Capacity

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

Discovers available Azure OpenAI model capacity across regions and projects.

OfficialMITAuto-check passedDevOps & Cloud

Install Capacity

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

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

GitHub CLI
$ gh skill install microsoft/GitHub-Copilot-for-Azure capacity --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/microsoft-foundry/models/deploy-model/capacity .claude/skills/capacity && 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
capacity
GitHub stars
255
Used in
2 other repos
Token cost
~1.7k tokens
SKILL.md length
610 words
Files
5 (incl. scripts)
Skills in repo
56
Repo updated
First seen
Licence
MIT

At a glance

Discovers available Azure OpenAI model capacity across regions and projects.

  • Works in 6 steps: Validate Prerequisites → Identify Model and Version → Run Discovery → …
  • : find capacity
  • SKILL.md covers Quick Reference, When to Use This Skill, Scripts and Workflow, plus 2 more sections
  • Runs PowerShell and Shell scripts from its folder; calls az and jq

What it does

Capacity is an agent skill from microsoft/GitHub-Copilot-for-Azure, published by the product's own GitHub organization. Discovers available Azure OpenAI model capacity across regions and projects. Analyzes quota limits, compares availability, and recommends optimal deployment locations based on capacity requirements. USE FOR: find capacity, check quota, where can I deploy, capacity discovery, best region for capacity, multi-project capacity search, quota analysis, model availability, region comparison, check TPM availability. DO NOT USE FOR: actual deployment (hand off to preset or customize after discovery), quota increase…

Its SKILL.md is about 1.7k tokens, which your agent loads only when the skill is triggered. The skill folder holds 5 other files, including scripts (for example `scripts/discover_and_rank.sh` and `scripts/query_capacity.sh`).

It sits in DevOps & Cloud, covering Deployment. It works with Microsoft Azure, Azure OpenAI and OpenAI. The repository describes itself as: GitHub Copilot for Azure. The licence is MIT.

When your agent uses it

  • : find capacity
  • Where can I deploy
  • Capacity discovery
  • Best region for capacity

Example prompts

  • “Use the capacity skill to discover available Azure OpenAI model capacity across regions and projects”
  • “/capacity”

Requirements

  • A Bash shell
  • PowerShell

Workflow steps

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

  1. Validate Prerequisites
  2. Identify Model and Version
  3. Run Discovery
  4. 5: Validate Subscription Quota
  5. Present Results and Hand Off
  6. Confirm Project Before Deploying

What it can do on your machine

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

    Ships 4 files in scripts/ (PowerShell and Shell), which the agent can run.

    Shell commands in SKILL.md call:

    • az
    • jq

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

  • Network

    No URLs in SKILL.md. Its commands use az, 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.

Context cost

Capacity loads about 1.7k tokens when it runs. Until then it costs about 148 tokens; SKILL.md has 610 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~148
When it runs · the whole SKILL.md, loaded when a task matches
~1.7k

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); the scripts in this folder are not scanned.

SKILL.md

The full file from microsoft/GitHub-Copilot-for-Azure at commit d8f4f4e, republished under its MIT licence (© microsoft). 610 words, ~1,739 tokens.

Download SKILL.mdSave it as .claude/skills/capacity/SKILL.md (or your agent's skills folder). This skill also uses 4 other files; get the full folder from GitHub.
name
capacity
description
Discovers available Azure OpenAI model capacity across regions and projects. Analyzes quota limits, compares availability, and recommends optimal deployment locations based on capacity requirements. USE FOR: find capacity, check quota, where can I deploy, capacity discovery, best region for capacity, multi-project capacity search, quota analysis, model availability, region comparison, check TPM availability. DO NOT USE FOR: actual deployment (hand off to preset or customize after discovery), quota increase requests (direct user to Azure Portal), listing existing deployments.
license
MIT
metadata.author
Microsoft
metadata.version
1.0.0

Capacity Discovery

Finds available Azure OpenAI model capacity across all accessible regions and projects. Recommends the best deployment location based on capacity requirements.

Quick Reference

PropertyDescription
PurposeFind where you can deploy a model with sufficient capacity
ScopeAll regions and projects the user has access to
OutputRanked table of regions/projects with available capacity
ActionRead-only analysis — does NOT deploy. Hands off to preset or customize
AuthenticationAzure CLI (az login)

When to Use This Skill

  • ✅ User asks "where can I deploy gpt-4o?"
  • ✅ User specifies a capacity target: "find a region with 10K TPM for gpt-4o"
  • ✅ User wants to compare availability: "which regions have gpt-4o available?"
  • ✅ User got a quota error and needs to find an alternative location
  • ✅ User asks "best region and project for deploying model X"

After discovery → hand off to preset or customize for actual deployment.

Scripts

Pre-built scripts handle the complex REST API calls and data processing. Use these instead of constructing commands manually.

ScriptPurposeUsage
scripts/discover_and_rank.ps1Full discovery: capacity + projects + rankingPrimary script for capacity discovery
scripts/discover_and_rank.shSame as above (bash)Primary script for capacity discovery
scripts/query_capacity.ps1Raw capacity query (no project matching)Quick capacity check or version listing
scripts/query_capacity.shSame as above (bash)Quick capacity check or version listing

Workflow

Phase 1: Validate Prerequisites
bash
az account show --query "{Subscription:name, SubscriptionId:id}" --output table
Phase 2: Identify Model and Version

Extract model name from user prompt. If version is unknown, query available versions:

powershell
.\scripts\query_capacity.ps1 -ModelName <model-name>
bash
./scripts/query_capacity.sh <model-name>

This lists available versions. Use the latest version unless user specifies otherwise.

Phase 3: Run Discovery

Run the full discovery script with model name, version, and minimum capacity target:

powershell
.\scripts\discover_and_rank.ps1 -ModelName <model-name> -ModelVersion <version> -MinCapacity <target>
bash
./scripts/discover_and_rank.sh <model-name> <version> <min-capacity>

💡 The script automatically queries capacity across ALL regions, cross-references with the user's existing projects, and outputs a ranked table sorted by: meets target → project count → available capacity.

Phase 3.5: Validate Subscription Quota

After discovery identifies candidate regions, validate that the user's subscription actually has available quota in each region. Model capacity (from Phase 3) shows what the platform can support, but subscription quota limits what this specific user can deploy.

powershell
# For each candidate region from discovery results:
$usageData = az cognitiveservices usage list --location <region> --subscription $SUBSCRIPTION_ID -o json 2>$null | ConvertFrom-Json

# Check quota for each SKU the model supports
# Quota names follow pattern: OpenAI.<SKU>.<model-name>
$usageEntry = $usageData | Where-Object { $_.name.value -eq "OpenAI.<SKU>.<model-name>" }

if ($usageEntry) {
  $quotaAvailable = $usageEntry.limit - $usageEntry.currentValue
} else {
  $quotaAvailable = 0  # No quota allocated
}
bash
# For each candidate region from discovery results:
usage_json=$(az cognitiveservices usage list --location <region> --subscription "$SUBSCRIPTION_ID" -o json 2>/dev/null)

# Extract quota for specific SKU+model
quota_available=$(echo "$usage_json" | jq -r --arg name "OpenAI.<SKU>.<model-name>" \
  '.[] | select(.name.value == $name) | .limit - .currentValue')

Annotate discovery results:

Add a "Quota Available" column to the ranked output from Phase 3:

RegionAvailable CapacityMeets TargetProjectsQuota Available
eastus2120K TPM✅3✅ 80K
westus390K TPM✅1❌ 0 (at limit)
swedencentral100K TPM✅0✅ 100K

Regions/SKUs where quotaAvailable = 0 should be marked with ❌ in the results. If no region has available quota, hand off to the quota skill for increase requests and troubleshooting.

Show full SKILL.md (211 more words)Show less
Phase 4: Present Results and Hand Off

After the script outputs the ranked table (now annotated with quota info), present it to the user and ask:

  1. 🚀 Quick deploy to top recommendation with defaults → route to preset
  2. ⚙️ Custom deploy with version/SKU/capacity/RAI selection → route to customize
  3. 📊 Check another model or capacity target → re-run Phase 2
  4. ❌ Cancel
Phase 5: Confirm Project Before Deploying

Before handing off to preset or customize, always confirm the target project with the user. See the Project Selection rules in the parent router.

If the discovery table shows a sample project for the chosen region, suggest it as the default. Otherwise, query projects in that region and let the user pick.

Error Handling

ErrorCauseResolution
"No capacity found"Model not available or all at quotaHand off to quota skill for increase requests and troubleshooting
Script auth erroraz login expiredRe-run az login
Empty version listModel not in region catalogTry a different region: ./scripts/query_capacity.sh <model> "" eastus
"No projects found"No AI Services resourcesGuide to project/create skill or Azure Portal
  • preset — Quick deployment after capacity discovery
  • customize — Custom deployment after capacity discovery
  • quota — For quota viewing, increase requests, and troubleshooting quota errors, defer to this skill instead of duplicating guidance

© 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 4 other files (scripts) in plugins/azure-skills/skills/microsoft-foundry/models/deploy-model/capacity of microsoft/GitHub-Copilot-for-Azure.

  • SKILL.md
  • scripts/discover_and_rank.ps1
  • scripts/discover_and_rank.sh
  • scripts/query_capacity.ps1
  • scripts/query_capacity.sh

Open the folder on GitHubat commit d8f4f4e

Used in 4 other repositories

We found 8 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

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

Capacity compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Capacity this skillmicrosoft/GitHub-Copilot-for-Azure2552 repos~1.7kAutomated safety check: PassMIT
Azure Architecture Autopilotgithub/awesome-copilot40k1 repos~1.9kAutomated safety check: PassMIT
Letta Configurationletta-ai/skills147—~1.3kAutomated safety check: NotesMIT
Azure AI Deploytimothywarner-org/claude-code224—~731Automated safety check: NotesMIT
Azure AI Projects TSmicrosoft/skills3.1k6 repos~1.9kAutomated safety check: PassMIT
Azure Video IndexerMicrosoftDocs/Agent-Skills775—~2.4kAutomated safety check: PassCC-BY-4.0

Similar skills

  • 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
  • Letta Configuration

    letta-ai/skills

    Configure LLM models and providers for Letta agents and servers.

    147 GitHub stars~1.3k tokensUpdated 5 days ago
    DevOps & CloudAuto-check: notes
  • Azure AI Deploy

    timothywarner-org/claude-code

    Ship a Python generative-AI app to Azure the keyless way, using DefaultAzureCredential and azd.

    224 GitHub stars~731 tokensUpdated 2 mo ago
    DevOps & CloudAuto-check: notes
  • Azure AI Projects TS

    microsoft/skills

    Official

    Build AI applications using Azure AI Projects SDK for JavaScript (@azure/ai-projects).

    3.1k GitHub starsUsed in 6 repos~1.9k tokens
    DevOps & CloudAuto-check passed
  • Azure Video Indexer

    MicrosoftDocs/Agent-Skills

    Official

    Expert knowledge for Azure AI Video Indexer development including troubleshooting, best practices, decision making, limits & quotas, security, configuration, integrations & coding patterns, and…

    775 GitHub stars~2.4k tokensUpdated yesterday
    DevOps & CloudAuto-check passed
  • Teams App Developer

    microsoft/work-iq

    Official

    Build, test, and deploy code-based Teams apps using the M365 Agents Toolkit CLI.

    1k GitHub stars~1.8k tokensUpdated today
    DevOps & CloudAuto-check: notes

More from microsoft/GitHub-Copilot-for-Azure

All 56 skills in this repo
  • 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
  • Azure Diagnostics

    microsoft/GitHub-Copilot-for-Azure

    Official

    Debug Azure production issues on Azure using AppLens, Azure Monitor, resource health, and safe triage.

    255 GitHub starsUsed in 1 repo~1.6k tokens
    Auto-check passed
  • Azure Quotas

    microsoft/GitHub-Copilot-for-Azure

    Official

    Check/manage Azure quotas and usage across providers. An agent skill from microsoft/GitHub-Copilot-for-Azure.

    255 GitHub starsUsed in 1 repo~3k tokens
    Auto-check passed

Categories

Questions about Capacity

What does Capacity do?

Discovers available Azure OpenAI model capacity across regions and projects. Capacity is an agent skill from microsoft/GitHub-Copilot-for-Azure, published by the product's own GitHub organization. Discovers available Azure OpenAI model capacity across regions and projects.

When should I use Capacity?

Capacity fits situations like: : find capacity; where can I deploy; capacity discovery; best region for capacity.

How do I install Capacity in Claude Code?

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

How do I install Capacity in Codex?

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

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

What does Capacity need to run?

Going by SKILL.md and its folder, Capacity needs PowerShell and a shell for the scripts in its folder and the command-line tools its instructions call (az and jq). Our summary lists: A Bash shell; PowerShell.

Does Capacity 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 Capacity 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. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Capacity use?

Capacity 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 Capacity use?

About 1.7k tokens (SKILL.md is roughly 7k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Capacity?

Skills that share tags, products or a category with Capacity: Azure Architecture Autopilot (github/awesome-copilot, 40k stars), Letta Configuration (letta-ai/skills, 147 stars), Azure AI Deploy (timothywarner-org/claude-code, 224 stars) and Azure AI Projects TS (microsoft/skills, 3.1k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Capacity?

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