Catalog
MicrosoftDocs/azure-portal

MicrosoftDocs

azure-portal

Expert knowledge for Azure Portal development including troubleshooting, security, and configuration. Use when managing portal RBAC sharing, Intune/Entra mobile access, dashboard JSON, portal policies, or HAR diagnostics, and other Azure Portal related development tasks. Not for Azure Cloud Shell (use azure-cloud-shell), Azure Resource Manager (use azure-resource-manager), Azure Monitor (use azure-monitor), Azure Security (use azure-security).

v1.0Latest
New~1.0kUpdated Jun 26, 2026

Azure Portal Skill

This skill provides expert guidance for Azure Portal. Covers troubleshooting, security, and configuration. 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-L35 How to collect browser network traces, console logs, HAR files, and diagnostics to investigate and report Azure portal performance or UI issues
Security L36-L44 Tenant-wide admin/security policies, RBAC-based dashboard sharing, mobile app protection and user management with Intune/Entra ID, and roles needed to manage Azure support requests.
Configuration L45-L53 Configuring Azure portal behavior: dashboard JSON/templates, keyboard shortcuts, URL allowlists, mobile app alerts, and built-in Azure Policy definitions for portal governance.

Troubleshooting

Topic URL
Capture browser traces and diagnostics for Azure portal issues https://learn.microsoft.com/en-us/azure/azure-portal/capture-browser-trace

Security

Topic URL
Configure tenant-wide Azure portal admin policies https://learn.microsoft.com/en-us/azure/azure-portal/admin-policies
Share Azure dashboards using Azure RBAC roles https://learn.microsoft.com/en-us/azure/azure-portal/azure-portal-dashboard-share-access
Apply Intune MAM app protection policies to Azure mobile app https://learn.microsoft.com/en-us/azure/azure-portal/mobile-app/intune-management
Manage Microsoft Entra ID users via Azure mobile app https://learn.microsoft.com/en-us/azure/azure-portal/mobile-app/microsoft-entra-id
Manage Azure support requests and required roles https://learn.microsoft.com/en-us/azure/azure-portal/supportability/how-to-manage-azure-support-request

Configuration

Topic URL
Programmatically create Azure dashboards from JSON templates https://learn.microsoft.com/en-us/azure/azure-portal/azure-portal-dashboards-create-programmatically
Understand Azure dashboard JSON structure and properties https://learn.microsoft.com/en-us/azure/azure-portal/azure-portal-dashboards-structure
Use global keyboard shortcuts in Azure portal https://learn.microsoft.com/en-us/azure/azure-portal/azure-portal-keyboard-shortcuts
Allowlist Azure portal URLs on firewalls and proxies https://learn.microsoft.com/en-us/azure/azure-portal/azure-portal-safelist-urls
Configure alerts and push notifications in Azure mobile app https://learn.microsoft.com/en-us/azure/azure-portal/mobile-app/alerts-notifications
Reference built-in Azure Policy definitions for Azure portal https://learn.microsoft.com/en-us/azure/azure-portal/policy-reference
Files1
1 files · 18.2 KB

Select a file to preview

Overall Score

72/100

Grade

B

Good

Safety

82

Quality

68

Clarity

76

Completeness

65

Summary

This skill provides reference documentation for Azure Portal development, covering troubleshooting (browser diagnostics), security (RBAC, Intune/Entra), and configuration (dashboards, URLs, policies). It directs agents to fetch remote Microsoft documentation via mcp_microsoftdocs or standard HTTP tools.

Detected Capabilities

read documentationfetch remote contentnetwork accessreference lookup

Trigger Keywords

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

azure portal troubleshootingportal RBAC sharingdashboard JSON configintune mobile appazure admin policiesHAR diagnosticsportal performance issue

Risk Signals

INFO

References external Microsoft Learn documentation via network fetch

SKILL.md:34-36
INFO

Requires mcp_microsoftdocs or fetch_webpage tools for documentation retrieval

SKILL.md:25-29
INFO

Mentions version staleness warning (3-month check on generated_at)

SKILL.md:21-22

Referenced Domains

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

github.comlearn.microsoft.com

Use Cases

  • Troubleshoot Azure portal performance or UI issues by collecting HAR files and browser traces
  • Configure tenant-wide Azure portal admin policies and governance
  • Share Azure dashboards using RBAC roles and manage access control
  • Create or modify Azure dashboards programmatically from JSON templates
  • Set up Intune MAM protection and Microsoft Entra ID user management for Azure mobile app
  • Manage Azure support requests and understand required administrative roles
  • Configure firewall and proxy allowlists for Azure portal URLs

Quality Notes

  • Clear category index with line ranges and URLs mapped to documentation sources
  • Explicit tool requirements documented (mcp_microsoftdocs preferred, fetch_webpage fallback)
  • Well-defined scope with boundary disclaimers (explicitly NOT for Cloud Shell, Resource Manager, Monitor, Security)
  • Generated from docs (docs2skills/1.0.0) — metadata indicates machine-generated content
  • Content is reference-oriented rather than instructional — relies on external docs for deep guidance
  • No procedural instructions or step-by-step workflows included; skill acts as a navigation index to Microsoft Learn
  • Lacks error handling guidance or examples of actual agent workflows
  • Category descriptions are brief; no examples of HAR diagnostics, JSON dashboard structure, or RBAC configurations shown inline
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.

Use MicrosoftDocs/azure-portal in your dev environment

Command Palette

Search for a command to run...