troubleshoot-observability

microsoft/skillsOfficial collectionCloud & DevOps

troubleshoot-observability is a skill in microsoft/skills, last changed 16 Nov 2026. It can touch credentials, reach the network, name web addresses and bundle scripts — read the findings before installing.

From the author
Coordinate Azure observability troubleshooting for application or agent health, runtime failures, operational latency, telemetry, monitoring, alerts, evidence-backed fixes and recovery. Use for an end-to-end observability investigation or explicit instrumentation, collection or alerting guidance. Not general resource/app/agent creation, model deployment, RBAC, cost or coding. Conceptual questions need no journey; explicit specialist requests stay direct. Actions require applicable approval.

At a glance

What it can touch

How much a skill can do, not whether it is risky.

Pattern check

Nothing flagged

That isn't proof the skill is harmless.

Commit 47eb388 · 20 Nov 2026

How the check works

Pattern check: nothing flagged

That isn't proof the skill is harmless.

QAI Index

76/QI

We rate every listed skill the same way, from 0 to 100.

A guide to compare by, not a verdict on the skill.

How it's scored

How the QAI Index is scored

Adoption · up to 40
GitHub stars on the repo that holds the skill, shared among its skills, and copies of the skill in other repos.
Quality · up to 30
Our pattern check, the format check, a named licence and a description of a sentence or more.
Upkeep · up to 20
How recently the skill's folder changed.
Trust · up to 10
An official collection, or an organisation that has confirmed its domain with GitHub.

Get an email when its check changes.

Keep it with the other skills you use, installed with one command.

Install

Sign in to see how to install it

Free with Google or an email link, no password needed. Then pick your agent and copy its steps.

MIT
Licence
3.2k
Repo stars
Publisher

What it can touch

Sign in to see the file and line behind each one

The summary at the top stays open to everyone. Signing in is free, with Google or an email link.

Pattern check

Pattern check: nothing flagged · commit 47eb388 · 20 Nov 2026

We checked every text file in this skill, at commit 47eb388 on 20 Nov 2026, against 45 published patterns such as download-and-run commands, hidden text and credential access. We don't run the skill, we don't read the web pages it points to, and we can't judge everything its instructions might lead an agent to do. In published tests, pattern checks like this one missed most malicious skills. Read the skill before you install it — especially anything it asks you to download or run.

How the check worksReport an incorrect finding

  • https://code.visualstudio.com/docs/agent-customization/agent-skills
  • https://docs.github.com/en/copilot/how-tos/copilot-cli/customize-copilot/add-skills
  • https://github.com/microsoft/azure-skills
  • https://github.com/microsoft/azure-skills#install-in-60-seconds
  • https://github.com/microsoft/azure-skills/tree/main/.github/plugins/azure-skills/skills/azure-diagnostics
  • https://github.com/microsoft/azure-skills/tree/main/.github/plugins/azure-skills/skills/microsoft-foundry
  • https://prometheus.monitor.azure.com
  • https://management.azure.com
  • https://learn.microsoft.com/en-us/azure/sre-agent/mcp-server
  • https://learn.microsoft.com/en-us/azure/azure-monitor/app/traces-mcp-server
Show 1 more
  • https://learn.microsoft.com/en-us/azure/managed-grafana/grafana-mcp-server

Format check

Each agent reads SKILL.md a little differently. We check the file against each one's published rules; we don't run the skill in any agent.

  • Agent Skills specPasses

    The format our Agent Skills docs set out, held to the strictest version of each rule among the agents we check.

    • Note

      Reference files that SKILL.md doesn't link: references/acquire-capability.md (linked only from references/canonical-dependencies.md), references/coverage.md (linked only from references/intent.md), references/handoff.md (linked only from references/intent.md), references/investigation/SOURCE-NOTICE.md, references/investigation/references/confidence-assessment.md and 9 more. Anthropic suggests linking every reference file directly from SKILL.md. B4

      Fix: Link each one from SKILL.md and say when to read it.

    • Note

      Reference files over 100 lines with no table of contents at the top: references/acquire-capability.md (179 lines), references/canonical-dependencies.md (105 lines), references/handoff.md (134 lines), references/intent.md (136 lines), references/journey-indicator.md (154 lines) and 5 more. B5

      Fix: Add a short list of the sections at the top of each.

  • Claude CodePasses

    Claude Code reads its own extra fields, ignores unknown ones, and still loads a skill whose frontmatter is broken, without its fields.

    • Note

      Reference files that SKILL.md doesn't link: references/acquire-capability.md (linked only from references/canonical-dependencies.md), references/coverage.md (linked only from references/intent.md), references/handoff.md (linked only from references/intent.md), references/investigation/SOURCE-NOTICE.md, references/investigation/references/confidence-assessment.md and 9 more. Anthropic suggests linking every reference file directly from SKILL.md. B4

      Fix: Link each one from SKILL.md and say when to read it.

    • Note

      Reference files over 100 lines with no table of contents at the top: references/acquire-capability.md (179 lines), references/canonical-dependencies.md (105 lines), references/handoff.md (134 lines), references/intent.md (136 lines), references/journey-indicator.md (154 lines) and 5 more. B5

      Fix: Add a short list of the sections at the top of each.

  • Claude apps & API uploadPasses

    Uploading to claude.ai or the Claude API, or packaging with Anthropic's script, accepts only the six spec fields and stops on anything else.

    • Note

      The description is 495 characters. The claude.ai Help Center says 200 at most, though Anthropic's API docs and validator allow 1,024. D4

      Fix: If the claude.ai upload refuses it, trim the description to 200 characters.

    • Note

      Reference files that SKILL.md doesn't link: references/acquire-capability.md (linked only from references/canonical-dependencies.md), references/coverage.md (linked only from references/intent.md), references/handoff.md (linked only from references/intent.md), references/investigation/SOURCE-NOTICE.md, references/investigation/references/confidence-assessment.md and 9 more. Anthropic suggests linking every reference file directly from SKILL.md. B4

      Fix: Link each one from SKILL.md and say when to read it.

    • Note

      Reference files over 100 lines with no table of contents at the top: references/acquire-capability.md (179 lines), references/canonical-dependencies.md (105 lines), references/handoff.md (134 lines), references/intent.md (136 lines), references/journey-indicator.md (154 lines) and 5 more. B5

      Fix: Add a short list of the sections at the top of each.

  • OpenAI (Codex & API)Passes
  • VS Code & CopilotPasses

SKILL.md

Files

24 files

PathSize
SKILL.md (opens in a new tab)5.9 KB
references/acquire-capability.md (opens in a new tab)11.1 KB
references/canonical-dependencies.md (opens in a new tab)6.9 KB
references/coverage.md (opens in a new tab)3.5 KB
references/handoff.md (opens in a new tab)11 KB
references/intent.md (opens in a new tab)9.2 KB
references/investigation/README.md (opens in a new tab)13.2 KB
references/investigation/SOURCE-NOTICE.md (opens in a new tab)789 B
references/investigation/references/confidence-assessment.md (opens in a new tab)1.1 KB
references/investigation/references/foundry-agent-routing.md (opens in a new tab)3.7 KB
references/investigation/references/managed-prometheus.md (opens in a new tab)3 KB
references/investigation/references/portal-links.md (opens in a new tab)4.1 KB
references/investigation/references/trace-query-patterns.md (opens in a new tab)3.1 KB
references/investigation/scripts/query_prometheus.py (opens in a new tab)9.6 KB
references/journey-indicator.md (opens in a new tab)7.8 KB
references/matching.md (opens in a new tab)8.4 KB
references/monitoring-follow-up.md (opens in a new tab)3 KB
references/next-actions.md (opens in a new tab)13.2 KB
references/reporting.md (opens in a new tab)4.6 KB
references/scope-permissions.md (opens in a new tab)4.1 KB
Show 4 more

Changelog

Newest first: each commit that changed its folder on GitHub, and each change to its listing here.

  1. Listed on QAI
  2. Updated: Sync plugin files from GitHub-Copilot-for-Azure (a5b8130 (opens in a new tab))

QAI Index badge

Show this skill's QAI Index in a README or on a website. It links back to this page and changes when we refresh the catalog.

Preview of the QAI Index badge
[![QAI Index](https://qai.io/badge/skills/microsoft/skills/troubleshoot-observability.svg)](https://qai.io/skills/microsoft/skills/troubleshoot-observability)

More from microsoft/skills

SkillQAI IndexWhat it can touchPattern checkLicenceUpdated
69/QI
  • Runs shell commands
  • Reaches the network
  • +1 more
Pattern check: Nothing flaggedMIT15 Jul 2026
68/QI
  • Runs shell commands
  • Reaches the network
Pattern check: Nothing flaggedMIT9 Oct 2026
75/QI
  • Runs shell commands
Pattern check: Nothing flaggedMIT28 Oct 2026
73/QI
  • Runs shell commands
  • Names web addresses
Pattern check: Nothing flaggedMIT9 Oct 2026
aks-known-issuesLookup documented AKS fixes only when the prompt includes an exact catalog signature and all of its qualifiers: VMCannotFitEphemeralOSDisk; NodePoolMcVersionIncompatible; 'NodeImageVersion is not accepted'; AKS SkuNotAvailable with size, location, and zone; ZonalAllocationFailed with insufficient zone capacity; OverconstrainedAllocationRequest with listed constraints; nested AKS vmssCSE/CSE VMExtensionError_OutboundConnFail, VMExtensionError_K8SAPIServerConnFail, or VMExtensionError_K8SAPIServerDNSLookupFail; or AllocationFailed with the full cataloged internal-error or insufficient-regional-capacity message. Never use for quota errors, code-only or bare wrappers, generic symptoms, incomplete signatures, or failures outside AKS; use aks-troubleshooting or azure-diagnostics.
73/QI
  • Names web addresses

Pattern check: Nothing flaggedMITUpdated 9 Oct 2026

73/QI
  • Names web addresses
Pattern check: Nothing flaggedMIT9 Oct 2026
73/QI
  • Runs shell commands
  • Reaches the network
  • +2 more
Pattern check: Nothing flaggedMIT9 Oct 2026
All skills in microsoft/skills

Other Cloud & DevOps skills

Same category, most repo stars first.

SkillQAI IndexWhat it can touchPattern checkLicenceUpdated
75/QI
  • Downloads software
  • Runs shell commands
  • +2 more
Pattern check: Nothing flaggedMIT20 Nov 2026
78/QI
  • Reaches the network
  • Names web addresses
Pattern check: Nothing flaggedMIT1 Nov 2026
78/QI
  • Instructions only
Pattern check: Nothing flaggedMIT5 Nov 2026
canaryPost-deploy canary monitoring. Use for: monitor after deploy, canary check. (gstack)

garrytan/gstack

70/QI
  • Runs shell commands
  • +3 more

Pattern check: 3 items to reviewMITUpdated 19 Nov 2026

70/QI
  • Runs shell commands
  • Reaches the network
  • +2 more
Pattern check: 3 items to reviewMIT19 Nov 2026
gstack-reviewUse before merging a branch or PR: review the diff for bugs that pass CI but break production, fix the obvious ones and ask about the rest. (gstack)

garrytan/gstack

79/QI
  • Runs shell commands
  • +2 more

RemovedPattern check: Nothing flaggedMITUpdated 5 Nov 2026

79/QI
  • Runs shell commands
  • Reaches the network
  • +1 more
Removed Pattern check: Nothing flaggedMIT5 Nov 2026
80/QI
  • Instructions only
Pattern check: Nothing flaggedMIT15 Nov 2026

Repo facts from GitHub on 20 Nov 2026. Files read at commit 47eb388.

QAI did not write these skills and is not affiliated with their authors unless a page says so. Logos and icons belong to their owners and are not a mark of approval. How we check