debug_k8s

Inspect Kubernetes pods, logs, events, and cluster state with kubectl.

20|6|Updated Jan 16, 2026
One-click install
npx skills add https://github.com/adrielp/ai-engineering-harness --skill debug-k8s-adrielp
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: debug_k8s
Source: https://github.com/adrielp/ai-engineering-harness/tree/main/gemini/skills/debug-k8s
Command: npx skills add https://github.com/adrielp/ai-engineering-harness --skill debug-k8s-adrielp

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Kubernetes debugging can be time-consuming and error-prone. This skill streamlines the process by coordinating pod status checks, log analyses, event reviews, and cluster-state inspections using kubectl commands via Gemini CLI's run_shell_command for safe, read-only investigation.

Core Features & Use Cases

  • Pod Status & Health: Inspect current pod statuses, conditions, and restart counts to identify stability issues.
  • Logs & Events: Retrieve recent container logs and cluster events to surface root causes and timing.
  • Resource State & Recommendations: Describe related deployments, services, and configurations, offering actionable remediation steps.
  • Use Case: When a pod stays in Pending or CrashLoopBackOff, run the guided kubectl checks to determine context, symptoms, and next steps.

Quick Start

Provide the namespace and resource (pod, deployment, or service) to inspect, and I will run kubectl commands to gather status, logs, and events.

Frequently Asked Questions about debug_k8s

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

FAQPage Schema
How do I debug Kubernetes pods stuck in CrashLoopBackOff or Pending states?

To debug Kubernetes pods in CrashLoopBackOff or Pending states, you can run guided kubectl checks to inspect pod statuses, retrieve container logs, and review cluster events to identify root causes and next steps.

What is the best way to check Kubernetes pod health and stability issues?

Checking Kubernetes pod health involves inspecting current pod statuses, conditions, and restart counts to identify stability issues, which this diagnostic process gathers using safe, read-only kubectl commands.

How do I gather Kubernetes logs and events to find the root cause of a deployment failure?

Gathering Kubernetes logs and events requires retrieving recent container logs and cluster events to surface root causes and timing, providing actionable remediation steps for failing deployments.

Can I inspect cluster state and resource configurations using read-only kubectl commands?

Yes, you can inspect cluster state by describing related deployments, services, and configurations using safe, read-only kubectl commands via Gemini CLI to investigate issues without modifying the cluster.

Do I need to provide a specific namespace and resource name to diagnose Kubernetes issues?

Yes, you need to provide the namespace and the specific resource name, such as a pod, deployment, or service, to run targeted kubectl checks for status, logs, and events.

What steps are involved in diagnosing Kubernetes issues with kubectl?

Diagnosing Kubernetes issues with kubectl involves step-by-step checks and evidence gathering by examining pods, logs, events, and cluster state, which concludes by reporting findings with actionable recommendations.