Microsoftdocs Agent Skills

Included skill

Azure Cloud Shell

Expert knowledge for Azure Cloud Shell development including troubleshooting, limits & quotas, and security. Use when handling Cloud Shell storage mounts, session persistence, private VNet access, RBAC roles, or private endpoints, and other Azure Cloud Shell related development tasks. Not for Azure Portal (use azure-portal), Azure Virtual Machines (use azure-virtual-machines), Azure App Service (use azure-app-service), Azure Functions (use azure-functions).

Source: /skills/azure-cloud-shell/SKILL.md

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 storage limits, quotas, and how these constraints affect usage and persistence of files and settings.
Security L42-L47 Securing Cloud Shell storage: configuring shared storage safely, using private endpoints, and assigning RBAC roles for secure VNet-based Cloud Shell deployments.

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
Understand 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
Assign RBAC roles for Cloud Shell VNet migration https://learn.microsoft.com/en-us/azure/cloud-shell/vnet/migrate-container-permissions