az-aks-agent

Diagnose Azure Kubernetes Service cluster health and pod issues via natural language queries.

7|1|Updated Jul 12, 2026
One-click install
npx skills add https://github.com/julianobarbosa/claude-code-skills --skill az-aks-agent
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: az-aks-agent
Source: https://github.com/julianobarbosa/claude-code-skills/tree/main/skills/az-aks-agent
Command: npx skills add https://github.com/julianobarbosa/claude-code-skills --skill az-aks-agent

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill offers AI-assisted troubleshooting for Azure Kubernetes Service clusters from the terminal.

Core Features & Use Cases

  • Interactive diagnostics: Run agent to diagnose health and pod issues.
  • Non-interactive mode: Batch queries for automation.
  • Model selection: Pick among Azure OpenAI, OpenAI, Claude, Gemini.
  • Use Case: Diagnose pod crash issues in a multi-namespace cluster.

Quick Start

Install the aks-agent extension and run a health query.

Frequently Asked Questions about az-aks-agent

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I diagnose AKS cluster health issues using AI?

AI-powered diagnostics analyze your AKS cluster health through natural language queries, identifying pod problems, networking misconfigurations, and storage issues without manual investigation. Install the aks-agent extension and run queries against your cluster to receive structured diagnostic output.

Can I troubleshoot AKS security and RBAC issues with natural language?

Yes. The agent diagnoses RBAC permissions, security policies, and access control configurations by processing natural language questions about your AKS cluster, returning actionable findings suitable for security audits and compliance reviews.

What LLM providers does the AKS diagnostics tool support?

The agent supports Azure OpenAI, OpenAI, Claude, and Gemini. Select your preferred model with the --model flag and configure credentials via environment variables or ~/.azure/aksAgent.config for seamless provider switching.

How do I run AKS diagnostics in batch mode for automation?

Use --no-interactive mode to run batch diagnostic queries without prompts, enabling automation in CI/CD pipelines or scheduled tasks. Control reasoning depth with --max-steps and retrieve structured outputs compatible with RAG systems.

Can I use AKS diagnostics to troubleshoot multi-namespace pod crashes?

Yes. The agent diagnoses pod crash issues across multiple namespaces by querying cluster state, logs, and configurations, providing AI-assisted root-cause analysis and remediation guidance through interactive or batch mode.

What credentials does the AKS troubleshooting agent require?

The agent manages credentials via environment variables or a config file at ~/.azure/aksAgent.config, supporting both LLM provider authentication and AKS cluster access without inline secret exposure.