mcpField
A
azure-cloud-shell

azure-cloud-shell

github.com/microsoftdocsCloud & DevOps796172 installsUpdated 3d ago
Repository

About azure-cloud-shell

A documentation skill for agents using Azure Cloud Shell. It combines local references with remotely fetched Microsoft documentation on troubleshooting, usage limits, storage, and security.

Key features

  1. 01Cloud Shell troubleshooting
  2. 02Session and storage limits
  3. 03Secure shared storage guidance
  4. 04Private endpoint guidance
  5. 05RBAC for VNet deployments

Use cases

  1. 01Diagnosing storage or connectivity errors
  2. 02Checking session and storage constraints
  3. 03Securing storage for multiple users
  4. 04Configuring private endpoint access

MCP support

The skill can fetch documentation through the mcp_microsoftdocs microsoft_docs_fetch tool, with webpage fetching as a fallback.

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/microsoftdocs/agent-skills --skill azure-cloud-shell

After installing, type/azure-cloud-shellin Claude Code to confirm it loaded.

Details

From the project README

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

CategoryLinesDescription
TroubleshootingL31-L36Diagnosing and fixing common Cloud Shell errors, storage and connectivity issues, plus deployment and network problems when running Cloud Shell in private VNets.
Limits & QuotasL37-L41Details on Cloud Shell session duration, resource and storage limits, quotas, and how these constraints affect usage and persistence of files and settings.
SecurityL42-L47Securing Cloud Shell storage: configuring shared storage safely, using private endpoints, and setting RBAC for VNet-based Cloud Shell deployments.
Troubleshooting
TopicURL
Troubleshoot common Azure Cloud Shell issues and FAQshttps://learn.microsoft.com/en-us/azure/cloud-shell/faq-troubleshooting
Troubleshoot Cloud Shell deployments in private VNetshttps://learn.microsoft.com/en-us/azure/cloud-shell/vnet/troubleshooting
Limits & Quotas
TopicURL
Understand Azure Cloud Shell session and storage limitshttps://learn.microsoft.com/en-us/azure/cloud-shell/overview
Security
TopicURL
Configure Cloud Shell storage for multiple users securelyhttps://learn.microsoft.com/en-us/azure/cloud-shell/security/how-to-support-multiple-users
Secure Cloud Shell storage with private endpointshttps://learn.microsoft.com/en-us/azure/cloud-shell/vnet/how-to-use-private-endpoint-storage
Configure RBAC for Cloud Shell VNet migrationhttps://learn.microsoft.com/en-us/azure/cloud-shell/vnet/migrate-container-permissions

Comments

Markdown supported