k8s-troubleshoot

Locate Kubernetes pods by label selectors and execute diagnostic commands inside their containers.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/XiaoMi/mone --skill k8s-troubleshoot
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: k8s-troubleshoot
Source: https://github.com/XiaoMi/mone/tree/main/jcommon/mcp/mcp-smartsre/.claude/skills/k8s-troubleshoot
Command: npx skills add https://github.com/XiaoMi/mone --skill k8s-troubleshoot

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires kubernetes, python-dotenv, and includes scripts (resource) components.

What problem does it solve?

A Toolkit to diagnose Kubernetes applications by locating pods with a label selector and running commands inside containers to inspect logs, processes, network, and resource usage.

Core Features & Use Cases

  • Find pods by label selector: Locate target pods swiftly.
  • Execute commands inside containers: Run diagnostic commands to inspect state.
  • Common tasks: View logs, check processes, network status, and resource usage.

Quick Start

Find pods with search_pods.py and then run exec_pod.py to diagnose a pod.

Frequently Asked Questions about k8s-troubleshoot

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

FAQPage Schema
How do I diagnose errors in Kubernetes pods using label selectors?

Kubernetes troubleshooting locates pods by label selector and executes diagnostic commands inside their containers to inspect logs, processes, and resource usage. Use search_pods.py to find target pods, then exec_pod.py to run commands and diagnose service errors, timeouts, or crashes.

Can I run commands inside Kubernetes containers to check logs and network status?

Yes. This toolkit executes diagnostic commands directly inside containers to view logs, check running processes, inspect network connectivity, and monitor resource usage across pods in your cluster.

What's the best way to locate and troubleshoot multiple pods in Kubernetes at scale?

Label-based pod discovery lets you locate and execute commands across multiple containers matching your search criteria. Structured JSON output includes pod name, namespace, container, command, and results for systematic troubleshooting.

Do I need Python to run Kubernetes pod diagnostics?

Yes. This toolkit uses Python scripts (search_pods.py and exec_pod.py) with python-dotenv for environment configuration to automate pod discovery and in-container command execution.

What container and pod issues can I diagnose with this toolkit?

Diagnose service errors, timeouts, application crashes, resource bottlenecks, and network issues by inspecting logs, processes, and system state inside running containers across your Kubernetes cluster.