k8s-debug

Diagnose Kubernetes cluster issues by inspecting pod logs, network policies, and cluster health.

9|Updated Feb 21, 2026
One-click install
npx skills add https://github.com/pantheon-org/tekhne --skill k8s-debug-pantheon-org
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: k8s-debug
Source: https://github.com/pantheon-org/tekhne/tree/main/skills/infrastructure/k8s/debug
Command: npx skills add https://github.com/pantheon-org/tekhne --skill k8s-debug-pantheon-org

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This Skill provides a comprehensive toolkit for diagnosing and resolving issues within Kubernetes clusters, from pod failures to network problems and cluster health.

Core Features & Use Cases

  • Pod Troubleshooting: Debug pods stuck in pending, crashing, or unresponsive states.
  • Network Diagnostics: Trace network policies, test connectivity, and resolve DNS issues.
  • Cluster Health Checks: Perform in-depth analysis of cluster components and resource utilization.
  • Use Case: When a critical microservice pod is repeatedly restarting with CrashLoopBackOff, use this Skill to inspect its logs, events, and resource constraints to pinpoint the root cause.

Quick Start

Use the k8s-debug skill to run a cluster health check and save the report to cluster-health-report.txt.

Frequently Asked Questions about k8s-debug

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

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

To troubleshoot a Kubernetes pod stuck in CrashLoopBackOff, inspect its logs, events, and resource constraints. This Skill provides detailed inspection capabilities to systematically pinpoint the root cause of pod crashes and unresponsive states.

What is the best way to perform a Kubernetes cluster health check?

The best way to perform a Kubernetes cluster health check is by analyzing cluster components and resource utilization. This Skill performs comprehensive diagnostics of your cluster health and can save the detailed report to a text file.

How do I diagnose DNS and network policy issues in a Kubernetes cluster?

Diagnosing DNS and network policy issues in a Kubernetes cluster involves tracing network policies and testing connectivity. This Skill provides dedicated network diagnostics capabilities to trace policies, test connectivity, and resolve DNS problems.

Can I inspect deployment rollouts and resource quotas using kubectl?

Yes, you can inspect deployment rollouts and resource quotas using kubectl. This Skill enables detailed inspection of deployment rollouts, resource quotas, and pod logs to help SREs systematically resolve common operational problems.

Do I need any external dependencies to debug Kubernetes pods with this Skill?

You do not need external dependencies to debug Kubernetes pods with this Skill. It operates independently using integrated scripts and references to systematically inspect pending, crashing, or unresponsive pod states without additional packages.