Catalog
MicrosoftDocs/azure-cloud-shell

MicrosoftDocs

azure-cloud-shell

Expert knowledge for Azure Cloud Shell development including troubleshooting, limits & quotas, and security. Use when debugging Cloud Shell storage/connectivity, session limits, required storage accounts, or private VNet access, and other Azure Cloud Shell related development tasks. Not for Azure Portal (use azure-portal), Azure Resource Manager (use azure-resource-manager).

globalRequires network access. Uses mcp_microsoftdocs:microsoft_docs_fetch or fetch_webpage to retrieve documentation.
generated_at:2026-05-24
generator:docs2skills/1.0.0
New~762
v1.0Saved Jun 26, 2026

Azure Cloud Shell Skill

This skill provides expert guidance for Azure Cloud Shell. Covers troubleshooting, limits & quotas, and security. It combines local quick-reference content with remote documentation fetching capabilities.

How to Use This Skill

IMPORTANT for Agent: Use the Category Index below to locate relevant sections. For categories with line ranges (e.g., L35-L120), use read_file with the specified lines. For categories with file links (e.g., [security.md](security.md)), use read_file on the linked reference file

IMPORTANT for Agent: If metadata.generated_at is more than 3 months old, suggest the user pull the latest version from the repository. If mcp_microsoftdocs tools are not available, suggest the user install it: Installation Guide

This skill requires network access to fetch documentation content:

  • Preferred: Use mcp_microsoftdocs:microsoft_docs_fetch with query string from=learn-agent-skill. Returns Markdown.
  • Fallback: Use fetch_webpage with query string from=learn-agent-skill&accept=text/markdown. Returns Markdown.

Category Index

Category Lines Description
Troubleshooting L31-L36 Diagnosing and fixing common Cloud Shell errors, storage and connectivity issues, plus deployment and network problems when running Cloud Shell in private VNets.
Limits & Quotas L37-L41 Details on Cloud Shell session duration, resource and concurrency limits, required storage accounts, quotas, and how these constraints affect shell usage and persistence
Security L42-L46 Securing Cloud Shell storage accounts, including multi-user access patterns, network isolation, and configuring private endpoints for locked-down access.

Troubleshooting

Topic URL
Troubleshoot common Azure Cloud Shell issues and FAQs https://learn.microsoft.com/en-us/azure/cloud-shell/faq-troubleshooting
Troubleshoot Cloud Shell deployments in private VNets https://learn.microsoft.com/en-us/azure/cloud-shell/vnet/troubleshooting

Limits & Quotas

Topic URL
Azure Cloud Shell session and storage limits https://learn.microsoft.com/en-us/azure/cloud-shell/overview

Security

Topic URL
Configure Cloud Shell storage for multiple users securely https://learn.microsoft.com/en-us/azure/cloud-shell/security/how-to-support-multiple-users
Secure Cloud Shell storage with private endpoints https://learn.microsoft.com/en-us/azure/cloud-shell/vnet/how-to-use-private-endpoint-storage
Files1
1 files · 18.2 KB

Select a file to preview

Overall Score

78/100

Grade

B

Good

Safety

82

Quality

75

Clarity

82

Completeness

68

Summary

This skill provides expert guidance for Azure Cloud Shell development, covering troubleshooting, limits & quotas, and security. It combines a local category index with remote documentation fetching via MCP tools (microsoft_docs_fetch or fetch_webpage), enabling agents to retrieve up-to-date Microsoft Learn documentation on demand.

Detected Capabilities

HTTP request (documentation fetching)File read (local reference content)Remote documentation retrieval via MCP

Trigger Keywords

Phrases that MCP clients use to match this skill to user intent.

cloud shell troubleshootingazure cloud shell limitscloud shell securitycloud shell storageprivate vnet cloud shellcloud shell session timeout

Risk Signals

INFO

Network access to microsoft.com and github.com for documentation retrieval

compatibility field, remote fetch tool usage
INFO

Dependency on external MCP tool (mcp_microsoftdocs) with fallback to fetch_webpage

compatibility field, tool description

Referenced Domains

External domains referenced in skill content, detected by static analysis.

github.comlearn.microsoft.com

Use Cases

  • Debug Azure Cloud Shell session timeouts and storage connectivity issues
  • Understand Cloud Shell resource quotas and session duration limits
  • Configure multi-user Cloud Shell storage accounts securely
  • Troubleshoot private VNet deployment issues in Cloud Shell
  • Secure Cloud Shell storage with private endpoints

Quality Notes

  • Skill properly scopes its domain: explicitly excludes Azure Portal and Azure Resource Manager (not for those tasks)
  • Clear agent instructions with bolded IMPORTANT notes for using the Category Index
  • Includes helpful guidance on checking metadata age (3 months) and suggesting tool installation if unavailable
  • References structured URLs for four distinct documentation topics (FAQs, private VNet, session limits, multi-user security, private endpoints)
  • Minimal content in SKILL.md itself — relies on remote documentation, which is appropriate for an index/reference skill
  • Uses tables effectively for Category Index and topic URLs
  • Fallback mechanism provided if mcp_microsoftdocs unavailable (fetch_webpage with query params)
  • Supporting materials present (LICENSE file with proper CC-BY 4.0 attribution)
Model: claude-haiku-4-5-20251001Analyzed: Jun 26, 2026

Reviews

Add this skill to your library to leave a review.

No reviews yet

Be the first to share your experience.

Add MicrosoftDocs/azure-cloud-shell to your library

Command Palette

Search for a command to run...