debug-runtime-platform

Diagnose deployment, rollout, and environment issues across Kubernetes and Helm platforms.

Updated Feb 10, 2026
One-click install
npx skills add https://github.com/vesviet/agent-skills --skill debug-runtime-platform-vesviet
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: debug-runtime-platform
Source: https://github.com/vesviet/agent-skills/tree/main/core/skills/platform/debug-runtime-platform
Command: npx skills add https://github.com/vesviet/agent-skills --skill debug-runtime-platform-vesviet

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? When a service behaves differently across staging and production or a rollout's health is unclear, the root cause often lies in the platform layer rather than application code. This Skill provides a structured process to compare desired state (git) against running state (cluster), isolate the failing layer, and apply the smallest safe repair. ## Core Features & Use Cases - Desired vs Running State Comparison: Inspect live deployments with kubectl, helm diff, and revision checks to detect drift between source of truth and the cluster. - Layered Failure Isolation: Distinguish rollout orchestration, runtime config, secrets, networking, capacity, and application-code failures before patching anything. - Deep Diagnostics: Use ephemeral debug containers, eBPF tooling (Hubble, Tetragon), pprof profiling, and structured OpenTelemetry log correlation for in-depth investigation. - Use Case: A checkout service crash-loops only in production after a deploy. Use this Skill to check rollout status, compare the live image and env vars against git, inspect previous container logs, and roll back to the last known good state. ## Quick Start Use the debug-runtime-platform skill to investigate why the checkout service behaves differently in production than in staging after the latest rollout.

Frequently Asked Questions about debug-runtime-platform

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

FAQPage Schema
How do I debug a Kubernetes deployment that fails after a rollout?▼

Start with kubectl rollout status and kubectl describe pod to inspect events, then check kubectl logs --previous for crash-loop containers. Compare the live image and environment variables against the git source of truth before applying any fix.

How to detect configuration drift between Helm charts and a live cluster?▼

Run helm diff upgrade with the helm-diff plugin to preview changes before applying, and compare helm get values output against the git values file. Never apply a Helm change without reviewing the diff first.

When should I use platform debugging instead of application debugging?▼

Use platform debugging when the failure looks like config, secrets, networking, or rollout orchestration rather than app logic, or when behavior differs across environments. If evidence points back into application code, switch to application-level troubleshooting.

Can I use ephemeral debug containers to inspect a running pod?▼

Yes, kubectl debug -it with an image like nicolaka/netshoot attaches an ephemeral container sharing the pod's process namespace. This lets you inspect live sockets, DNS, and traffic without restarting the application.

Why should AI-generated log analysis not be trusted directly?▼

AI log analysis tools such as Datadog Bits AI or Grafana Sift surface anomaly patterns as hypotheses, not confirmed root causes. Every AI-identified cause must be verified against raw log evidence before any remediation is applied.