Skip to content
Skill

Troubleshoot observability

Coordinate Azure observability troubleshooting for application or agent health, runtime failures, operational latency, telemetry, monitoring

Install
Scripts
Python
Platforms
Claude Code, Codex, Cursor
GitHub stars
3.2K
Last commit
today
License
MIT
Listing updated
today

When your agent uses it

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.

From the skill's SKILL.md. Your agent reads this description to decide when to load the skill.

What it can access

From a static check of its 24 files (172 KB) on GitHub on 17 November 2026. Nothing was run. Read the files before you install a skill: it can tell your agent to run anything its tools allow.

Install

Copy the skill folder to ~/.claude/skills/troubleshoot-observability to use it in all your projects:

tmp=$(mktemp -d) &&
git clone --depth 1 https://github.com/microsoft/skills.git "$tmp" &&
mkdir -p ~/.claude/skills &&
rm -rf ~/.claude/skills/troubleshoot-observability &&
cp -R "$tmp/.github/plugins/azure-observability/skills/troubleshoot-observability" ~/.claude/skills/troubleshoot-observability &&
rm -rf "$tmp"

For one project only, put the folder in .claude/skills/troubleshoot-observability inside it instead.

Claude Code docs on skills

Copy the skill folder to ~/.agents/skills/troubleshoot-observability to use it in every repository:

tmp=$(mktemp -d) &&
git clone --depth 1 https://github.com/microsoft/skills.git "$tmp" &&
mkdir -p ~/.agents/skills &&
rm -rf ~/.agents/skills/troubleshoot-observability &&
cp -R "$tmp/.github/plugins/azure-observability/skills/troubleshoot-observability" ~/.agents/skills/troubleshoot-observability &&
rm -rf "$tmp"

For one repository only, put the folder in .agents/skills/troubleshoot-observability inside it instead.

Codex docs on skills

Copy the skill folder to ~/.cursor/skills/troubleshoot-observability to use it in every project:

tmp=$(mktemp -d) &&
git clone --depth 1 https://github.com/microsoft/skills.git "$tmp" &&
mkdir -p ~/.cursor/skills &&
rm -rf ~/.cursor/skills/troubleshoot-observability &&
cp -R "$tmp/.github/plugins/azure-observability/skills/troubleshoot-observability" ~/.cursor/skills/troubleshoot-observability &&
rm -rf "$tmp"

For one project only, put the folder in .cursor/skills/troubleshoot-observability inside it instead.

Cursor docs on skills

Run in a terminal (add --scope workspace to install it for the current workspace only):

gemini skills install https://github.com/microsoft/skills.git --path .github/plugins/azure-observability/skills/troubleshoot-observability

Or copy the folder to ~/.gemini/skills/troubleshoot-observability yourself.

Gemini CLI docs on skills

For GitHub Copilot in VS Code, copy the skill folder to ~/.copilot/skills/troubleshoot-observability:

tmp=$(mktemp -d) &&
git clone --depth 1 https://github.com/microsoft/skills.git "$tmp" &&
mkdir -p ~/.copilot/skills &&
rm -rf ~/.copilot/skills/troubleshoot-observability &&
cp -R "$tmp/.github/plugins/azure-observability/skills/troubleshoot-observability" ~/.copilot/skills/troubleshoot-observability &&
rm -rf "$tmp"

For one project only, put the folder in .github/skills/troubleshoot-observability inside it instead.

VS Code docs on skills

Get the folder:

git clone --depth 1 https://github.com/microsoft/skills.git

Then copy skills/.github/plugins/azure-observability/skills/troubleshoot-observability into your agent's skills folder as troubleshoot-observability. Agents that support SKILL.md read one folder per skill.

The SKILL.md format

Troubleshoot observability FAQ

How do I install Troubleshoot observability in Claude Code?

Copy the skill folder from GitHub to ~/.claude/skills/troubleshoot-observability to use it in all your projects, or to .claude/skills/troubleshoot-observability in one project.

Does Troubleshoot observability run scripts?

Yes. It runs Python scripts. Its scripts contain network calls. This comes from a static check of the files on GitHub; nothing was run. Read the files before you install it.

Which AI agents can use Troubleshoot observability?

Claude Code, Codex, Cursor, Gemini CLI, GitHub Copilot, Windsurf and Goose. Each reads skills in the SKILL.md format from its own folder; the install steps on this page list them.

More from microsoft/skills

  1. Diagnose Day-2 AKS GPU and KAITO incidents using profile-aware, read-only evidence

    • Open source
    • 3.2K GitHub stars
  2. Lookup documented AKS fixes only when the prompt includes an exact catalog signature and all of its qualifiers: VMCannotFitEphemeralOSDisk;

    • Open source
    • 3.2K GitHub stars
  3. Collects bounded packet captures from AKS nodes and Azure network configuration for wire-level evidence

    • Open source
    • 3.2K GitHub stars
  4. Debug live Azure Kubernetes Service (AKS) incidents with a read-only, evidence-first investigation

    • Open source
    • 3.2K GitHub stars
  5. Builds an Azure portal deep link to a specific blade/menu item for supported Microsoft.ContainerService, Microsoft.Kubernetes, and Microsoft

    • Open source
    • 3.2K GitHub stars
    • Cloud and infrastructure