k8s-debug

Attach ephemeral debugging containers to running Kubernetes pods for live inspection.

10|2|Updated Dec 23, 2025
One-click install
npx skills add https://github.com/eveld/claude --skill k8s-debug-eveld
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: k8s-debug
Source: https://github.com/eveld/claude/tree/main/skills/k8s-debug
Command: npx skills add https://github.com/eveld/claude --skill k8s-debug-eveld

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Launch an ephemeral debug container attached to a running Kubernetes pod to enable live inspection without restarting the production container.

Core Features & Use Cases

  • Attach an ephemeral debug container to a running pod to perform interactive debugging.
  • Use common debugging tools inside the ephemeral container to diagnose network, process, or filesystem issues without modifying the pod.
  • Support multi-container pods by targeting a specific container or injecting a new debug container, including the option to use a custom image.
  • Preserve pod stability: the debugging session runs alongside the existing containers and the pod remains operational.

Quick Start

Attach an ephemeral debug container to a running pod to begin interactive debugging immediately.

Frequently Asked Questions about k8s-debug

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

FAQPage Schema
How do I debug a running Kubernetes pod without restarting it?

Attach an ephemeral debug container to a running Kubernetes pod using kubectl debug. This allows live inspection of processes, network issues, and filesystems without modifying or restarting the production containers.

What is an ephemeral container in Kubernetes used for?

An ephemeral container is used for live troubleshooting in Kubernetes. It attaches to a running pod to provide temporary debugging tools, enabling diagnosis of network, process, or filesystem issues without altering the pod configuration.

Does kubectl debug work with multi-container pods?

Yes, kubectl debug supports multi-container pods. You can target a specific container to share its namespace or inject a new debug container alongside existing ones, and you can specify a custom image for the debugging session.

Do I need cluster support to use ephemeral containers?

Yes, using ephemeral containers requires cluster support for the feature. You need access to kubectl debug or equivalent tooling, and the target Kubernetes cluster must have ephemeral-container support enabled to attach debugging sessions.

What's the best way to diagnose network issues in a Kubernetes pod?

The best way to diagnose network issues is to attach an ephemeral debug container to the running pod. This preserves pod stability while allowing you to use common network debugging tools to inspect the live environment interactively.