---

name: k8s-troubleshoot description: Kubernetes troubleshooting toolkit - search pods by labels and execute diagnostic commands inside containers. Use when user reports service errors, exceptions, crashes, timeouts, or needs to check logs, processes, network, or resource usage in K8s pods.

Kubernetes Troubleshooting Skill

A complete toolkit for diagnosing Kubernetes applications. Find pods by labels, then execute commands inside containers for deep diagnostics.

When to Use

• User reports service errors, exceptions, failures, timeouts
• Need to check application logs or process status
• Diagnose network, memory, or disk issues
• Keywords: error, exception, failed, timeout, crash, not working, logs, troubleshoot, diagnose, pod, container

Workflow

1. Search pods - Find target pods by label selector
2. Execute diagnostics - Run commands inside containers

Scripts

1. Search Pods

Find pods by label selector:

Copyuv run python .claude/skills/k8s-troubleshoot/scripts/search_pods.py -l "app=nginx" -n default

Output: JSON with success, podCount, pods (name, namespace, phase, containers)

2. Execute Command in Pod

Run diagnostic commands inside a container:

Copyuv run python .claude/skills/k8s-troubleshoot/scripts/exec_pod.py -p "pod-name" -n default -cmd "tail -n 100 /root/logs/app.log"

Output: JSON with success, pod, namespace, command, output

Common Diagnostic Patterns

View application logs

Copyuv run python .claude/skills/k8s-troubleshoot/scripts/exec_pod.py -p my-pod -n default -cmd "tail -n 100 /root/logs/app.log"

Check Nacos config (dubbo3 issues)

Copyuv run python .claude/skills/k8s-troubleshoot/scripts/exec_pod.py -p my-pod -n default -cmd "cat /root/logs/nacos/config.log | grep nacos"

Check processes

Copyuv run python .claude/skills/k8s-troubleshoot/scripts/exec_pod.py -p my-pod -n default -cmd "ps aux | head -20"

Check network

Copyuv run python .claude/skills/k8s-troubleshoot/scripts/exec_pod.py -p my-pod -n default -cmd "netstat -tlnp"

Check disk and memory

Copyuv run python .claude/skills/k8s-troubleshoot/scripts/exec_pod.py -p my-pod -n default -cmd "df -h && free -m"

Troubleshooting Tips