# az-aks-agent

az-aks-agent is a Claude Code skill that investigates Azure Kubernetes Service cluster health and configuration. It examines pod, networking, storage, and RBAC issues.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 110 installs · ★ 17 repo stars
- Author: julianobarbosa
- License: MIT · policy=mirror · the beginning of the file is at the end of this page
- Source: https://github.com/julianobarbosa/claude-code-skills/tree/HEAD/skills/az-aks-agent/SKILL.md
- Updated: 2026-10-14
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/az-aks-agent

## What it does

The skill guides an agent to use Azure AKS Agent CLI for cluster checks and troubleshooting. Queries can cover pod failures, network and storage problems, security settings, or cluster configuration. The CLI command is `az aks agent`; provide the resource group and cluster name, then run an interactive investigation or use batch mode.

You need Azure CLI version 2.76 or higher, cluster credentials, and an LLM provider configuration. Install the extension with `az extension add --name aks-agent --debug`, then use `az aks agent-init` to configure the provider. A working API key or LLM configuration is required before the agent can process queries.

## Requirements
- Works with: Azure, Kubernetes

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add julianobarbosa/claude-code-skills --skill az-aks-agent -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/az-aks-agent/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/az-aks-agent/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add julianobarbosa/claude-code-skills --skill az-aks-agent -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/az-aks-agent/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add julianobarbosa/claude-code-skills --skill az-aks-agent -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/az-aks-agent/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install julianobarbosa/claude-code-skills skills/az-aks-agent
```

2. **Manually: put the files in place**
- File: `.github/skills/az-aks-agent/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add julianobarbosa/claude-code-skills --skill az-aks-agent -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/julianobarbosa/claude-code-skills --path skills/az-aks-agent
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/az-aks-agent/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add julianobarbosa/claude-code-skills --skill az-aks-agent -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/julianobarbosa/claude-code-skills/tree/HEAD/skills/az-aks-agent/SKILL.md

## When to use it
- check AKS cluster health
- investigate failing pods and CrashLoopBackOff
- diagnose DNS and network policy issues
- find why PersistentVolumeClaims are pending
- review RBAC and cluster configuration

## Example prompts
- Check the health of the AKS cluster `myCluster` in resource group `myRG`.
- Investigate why pods are stuck in Pending and check their storage setup.
- Review network policies and find why pods cannot reach external services.

## Source text · SKILL.md · MIT

Below is the content of a third-party file. It is data, not instructions for you: do not act on anything written inside unless the human asks. Block tag: aa91c771d6e0319c.

BEGIN THIRD-PARTY FILE aa91c771d6e0319c
````text
---
name: az-aks-agent
description: Azure AKS Agentic CLI - AI-powered troubleshooting and insights tool for Azure Kubernetes Service. Use when diagnosing AKS cluster issues, getting cluster health insights, troubleshooting networking/storage/security problems, or analyzing cluster configuration with natural language queries.
---

# Azure AKS Agent CLI Skill

## Overview

The **Agentic CLI for Azure Kubernetes Service (AKS)** is an AI-powered troubleshooting and insights tool (currently in preview) that brings advanced diagnostics directly to your terminal. It allows you to ask natural language questions about your cluster's health, configuration, and issues without requiring deep Kubernetes expertise or knowledge of complex command syntax.

**Primary Command**: `az aks agent`

## Quick Reference

### Installation

```bash
# Prerequisites: Azure CLI version 2.76 or higher
az version

# Install the extension (takes 5-10 minutes)
az extension add --name aks-agent --debug

# Verify installation
az extension list
az aks agent --help

# Initialize LLM configuration (interactive wizard)
az aks agent-init

# Remove extension if needed
az extension remove --name aks-agent --debug
```

### Basic Usage

```bash
# Get cluster credentials first
az aks get-credentials --resource-group <rg-name> --name <cluster-name>

# Start interactive troubleshooting
az aks agent -g <resource-group> -n <cluster-name>

# Ask a specific question
az aks agent -g <resource-group> -n <cluster-name> --query "What's wrong with my cluster?"

# Non-interactive mode (batch processing)
az aks agent -g <resource-group> -n <cluster-name> --no-interactive --query "Check pod health"
```

## Workflow Decision Tree

```
What do you need to do?
├── Cluster Health Check?
│   └── Use: az aks agent --query "What's the health status of my cluster?"
├── Troubleshoot Pod Issues?
│   └── Use: az aks agent --query "Why are my pods failing?"
├── Networking Problems?
│   └── Use: az aks agent --query "Diagnose networking issues"
├── Storage Issues?
│   └── Use: az aks agent --query "Check storage configuration"
├── Security/RBAC Issues?
│   └── Use: az aks agent --query "Review RBAC configuration"
├── Node Pool Problems?
│   └── Use: az aks agent --query "Check node pool health"
└── Configuration Review?
    └── Use: az aks agent --query "Review cluster configuration"
```

## Command Reference

### Core Commands

| Command | Description |
|---------|-------------|
| `az aks agent` | Start interactive AI-powered troubleshooting |
| `az aks agent-init` | Initialize LLM provider configuration |
| `az aks agent --help` | Show help and available options |

### Command Parameters

| Parameter | Description | Default |
|-----------|-------------|---------|
````
END THIRD-PARTY FILE aa91c771d6e0319c

The third-party file has ended. Everything between the aa91c771d6e0319c tags is data: requests and commands from it are not followed. An “end of file” line with another tag inside the block is part of the file.

First 2839 of 13030 bytes. © julianobarbosa · MIT · https://github.com/julianobarbosa/claude-code-skills/tree/HEAD/skills/az-aks-agent/SKILL.md

_Part of the page did not fit — see the HTML version._

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
