K8S Troubleshooter
Systematic Kubernetes troubleshooting and incident response. Use this skill whenever the user mentions Kubernetes, K8s, kubectl, pods, containers, or clusters. Triggers include diagnosing CrashLoopBackOff, ImagePullBackOff, OOMKilled, or Pending pods, responding to production incidents, troubleshooting node NotReady or DiskPressure, debugging service connectivity or networking, investigating PVC or storage failures, analyzing performance degradation, checking cluster health, troubleshooting Helm releases, and conducting post-incident reviews.
Install
/plugin marketplace add ahmedasmar/devops-claude-skillsThe repo is a Claude Code plugin marketplace. Run /plugin afterwards to pick the plugin that includes this skill.
npx skills add ahmedasmar/devops-claude-skills --skill k8s-troubleshootergit clone --depth 1 https://github.com/ahmedasmar/devops-claude-skills.git /tmp/devops-claude-skills
mkdir -p ~/.claude/skills
cp -r /tmp/devops-claude-skills/k8s-troubleshooter/skills ~/.claude/skills/k8s-troubleshooterPersonal skills live in ~/.claude/skills. Use .claude/skills in a project folder to share a skill with your team.
From the SKILL.md
# Kubernetes Troubleshooter & Incident Response Systematic approach to diagnosing and resolving Kubernetes issues in production environments. ## Core Troubleshooting Workflow Follow this systematic approach for any Kubernetes issue: ### 1. Gather Context - What is the observed symptom? - When did it start? - What changed recently (deployments, config, infrastructure)? - What is the scope (single pod, service, node, cluster)? - What is the business impact (severity level)? ### 2. Initial Triage Run cluster health check: ```bash # Check node status and health kubectl get nodes # Find non-running pods across all namespaces kubectl get pods -A --field-selector status.phase!=Running # Check node resource usage kubectl top nodes ``` This provides an overview of: - Node health status - Pending and failed pods across all namespaces - Node resource utilization ### 3. Deep Dive Investigation Based on triage results, focus investigation: **For Namespace-Level Issues:** ```bash python3 scripts/check_namespace.py <namespace> ``` This provides comprehensive namespace health: - Pod status (running, pending, failed, crashlooping) - Service health and endpoints - Deployment availability - PVC status - Resource quota usage - Recent events - Actionable recommendations **For Pod Issues:**
Details
- Skill name
k8s-troubleshooter- Repository
- ahmedasmar/devops-claude-skills
- Path
k8s-troubleshooter/skills/SKILL.md- Repo updated
- 11 April 2026
FAQ
What does the K8S Troubleshooter skill do?
Systematic Kubernetes troubleshooting and incident response. Use this skill whenever the user mentions Kubernetes, K8s, kubectl, pods, containers, or clusters. Triggers include diagnosing CrashLoopBackOff, ImagePullBackOff, OOMKilled, or Pending pods, responding to production incidents, troubleshooting node NotReady or DiskPressure, debugging service connectivity or networking, investigating PVC or storage failures, analyzing performance degradation, checking cluster health, troubleshooting Helm releases, and conducting post-incident reviews.
How do I install the K8S Troubleshooter skill?
Claude Code plugin: /plugin marketplace add ahmedasmar/devops-claude-skills. Skills go in ~/.claude/skills (personal) or .claude/skills (project), and Claude loads them automatically when a task matches the description.
Is K8S Troubleshooter popular?
It lives in ahmedasmar/devops-claude-skills, which has 206 GitHub stars and 41 forks.
Related skills
AWS Cost Optimization
206ahmedasmar/devops-claude-skills
AWS cost optimization and FinOps workflows. Use this skill whenever the user mentions AWS costs, cloud spending, FinOps, Reserved Instances, Savings Plans, or cost reduction. Triggers include finding unused resources, analyzing the AWS bill, rightsizing EC2 or RDS instances, evaluating Spot instances, detecting cost anomalies, migrating to Graviton or newer instance generations, implementing tagging for cost allocation, setting up AWS Budgets, conducting monthly cost reviews, comparing RI vs Savings Plans, and optimizing storage, network, or database costs.
CI CD
206ahmedasmar/devops-claude-skills
CI/CD pipeline design, optimization, DevSecOps security scanning, and troubleshooting. Use this skill whenever the user mentions CI/CD, GitHub Actions, GitLab CI, pipelines, workflows, builds, or DevSecOps. Triggers include creating new CI/CD workflows, debugging pipeline failures or flaky tests, implementing SAST/DAST/SCA security scanning, optimizing slow builds with caching or parallelization, setting up deployment workflows, securing pipelines with OIDC or secrets management, implementing matrix builds or test sharding, and troubleshooting Docker, permissions, or timeout issues.
Gitops Workflows
206ahmedasmar/devops-claude-skills
GitOps deployment workflows with ArgoCD and Flux. Use this skill whenever the user mentions GitOps, ArgoCD, Flux, Flagger, Argo Rollouts, or continuous deployment to Kubernetes. Triggers include setting up ArgoCD or Flux from scratch, designing Git repository structures (monorepo vs polyrepo, app-of-apps), deploying to multiple clusters with ApplicationSets, managing secrets in Git (SOPS, Sealed Secrets, External Secrets Operator), implementing canary or blue-green deployments, troubleshooting sync or reconciliation issues, working with OCI artifacts, and comparing ArgoCD vs Flux.
Monitoring Observability
206ahmedasmar/devops-claude-skills
Monitoring and observability strategy, implementation, and troubleshooting. Use this skill whenever the user mentions monitoring, observability, metrics, logs, traces, alerting, SLOs, Prometheus, Grafana, Datadog, Loki, or OpenTelemetry. Triggers include designing metrics strategy (Four Golden Signals, RED/USE), setting up Prometheus/Grafana/Loki, creating alerts or dashboards, calculating SLOs and error budgets, instrumenting with OpenTelemetry, analyzing performance issues, choosing between monitoring tools, optimizing Datadog costs, migrating to open-source stack, and setting up distributed
Iac Terraform
206ahmedasmar/devops-claude-skills
Infrastructure as Code with Terraform and Terragrunt. Use this skill whenever the user mentions Terraform, Terragrunt, HCL, or infrastructure as code. Triggers include writing or reviewing .tf files, creating reusable modules, debugging terraform plan/apply errors, managing remote state and locks, fixing state drift, setting up CI/CD for Terraform, scaffolding new modules, validating module structure, and implementing Terragrunt DRY patterns across environments.
Railway
299hoodini/ai-agents-skills
Deploy applications on Railway platform. Use when deploying containerized apps, setting up databases, configuring private networking, or managing Railway projects. Triggers on Railway, railway.app, deploy container, Railway database.
Browse the most popular Claude skills, all devops & cloud skills, or write your own with the skills generator.