k8s-debug

Diagnose K3s cluster issues with kubectl commands and log inspection.

Updated Dec 5, 2025
One-click install
npx skills add https://github.com/doleval013/Barak-web --skill k8s-debug-doleval013
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: k8s-debug
Source: https://github.com/doleval013/Barak-web/tree/main/.agent/skills/k8s-debug
Command: npx skills add https://github.com/doleval013/Barak-web --skill k8s-debug-doleval013

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill provides quick, actionable debugging commands for K3s Kubernetes clusters, reducing mean time to recovery during outages and misconfigurations.

Core Features & Use Cases

  • Pod and Node Diagnostics: check pod status, node health, and resource usage to pinpoint bottlenecks.
  • Networking & TLS Troubleshooting: verify services, ingresses, TLS certificates, and DNS resolution.
  • Use Case: when a frontend deployment fails to respond, use the commands to gather logs, describe resources, and validate end-to-end connectivity.

Quick Start

Ensure kubectl is configured for your AWS-hosted K3s cluster, then run the recommended diagnostic commands from the Skill's quick-start guide to reproduce issues and collect telemetry.

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 failing pod in a K3s Kubernetes cluster?

To troubleshoot a failing pod in a K3s Kubernetes cluster, you inspect pod logs and describe resource statuses. This Skill prescribes concrete kubectl commands and resource checks to pinpoint failures and guide remediation.

How do I debug ingress and TLS certificate issues in Kubernetes?

Debugging ingress and TLS certificate issues in Kubernetes requires verifying service routing, ingress configurations, and DNS resolution. This Skill provides specific kubectl commands to validate connectivity and surface TLS misconfigurations.

Can I use this to diagnose ArgoCD workflow issues on AWS?

Yes, you can diagnose ArgoCD workflow issues on AWS using this Skill. Its troubleshooting scope explicitly covers ArgoCD workflows and common deployment issues within AWS-hosted K3s Kubernetes clusters.

What is the best way to check node health and resource usage in Kubernetes?

The best way to check node health and resource usage in Kubernetes is by running targeted diagnostic commands. This Skill offers prescribed kubectl commands to check node health and pinpoint cluster bottlenecks.

Do I need any extra tools to start debugging my K3s cluster?

You need kubectl configured for your AWS-hosted K3s cluster to start debugging. Once configured, you can run the recommended diagnostic commands from this Skill to reproduce issues and collect telemetry.