k8s-debug

Collect pod status, events, logs, and node context for Kubernetes diagnostics.

7|3|Updated May 4, 2026
One-click install
npx skills add https://github.com/nopperabbo/codebuddy2api --skill k8s-debug-nopperabbo
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: k8s-debug
Source: https://github.com/nopperabbo/codebuddy2api/tree/main/opencode-config/skills/_archived/k8s-debug
Command: npx skills add https://github.com/nopperabbo/codebuddy2api --skill k8s-debug-nopperabbo

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

Kubernetes operators frequently struggle to diagnose pod-related failures quickly; this skill provides a deterministic, script-driven approach to collect the essential diagnostics needed for root-cause analysis.

Core Features & Use Cases

  • Comprehensive pod diagnostics: retrieves pod status, full description, YAML, recent events, container logs (including previous containers), and node context.
  • Deterministic, repeatable workflows: uses scripted steps to reproduce and document findings in a predictable sequence.
  • Safe guidance for disruptive actions: begins with read-only exploration and only proceeds with explicit confirmation.

Quick Start

From the skill directory, run the pod diagnostics to collect status, events, logs, and node information for a given pod.

Frequently Asked Questions about k8s-debug

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

FAQPage Schema
How do I diagnose a Kubernetes pod stuck in CrashLoopBackOff?

To diagnose a Kubernetes pod stuck in CrashLoopBackOff, you need to gather pod status, recent events, container logs (including previous instances), and node context to identify the root cause. This skill automates that collection process.

What's the best way to collect Kubernetes pod logs and events automatically?

The best way to collect Kubernetes pod logs and events automatically is using a deterministic, script-driven workflow that retrieves the full pod description, YAML, recent events, and container logs in a reproducible sequence for root-cause analysis.

Can I debug Kubernetes pods across any namespace using kubectl?

Yes, you can debug Kubernetes pods across any namespace using kubectl if you have a valid kubeconfig and read permissions for pods, events, and nodes. This skill uses that access to run its diagnostic workflows.

Do I need special RBAC permissions to run Kubernetes pod diagnostics?

You need minimal privilege RBAC permissions to run Kubernetes pod diagnostics. Specifically, you require read permissions for pods, events, and nodes, along with standard kubectl access and a valid kubeconfig.

How do I troubleshoot Kubernetes pod DNS and networking issues?

To troubleshoot Kubernetes pod DNS and networking issues, you need to gather comprehensive diagnostics including pod status, events, and node context. This skill automates that data collection to support root-cause analysis.

Why does this approach to Kubernetes debugging start with read-only exploration?

This approach to Kubernetes debugging starts with read-only exploration to ensure safe guidance for disruptive actions. It collects diagnostics predictably and only proceeds with disruptive actions after receiving explicit confirmation.