service-debug

Investigates Kubernetes services and detects pod recreations via creation timestamps.

1|Updated Jun 8, 2025
One-click install
npx skills add https://github.com/ryosukesuto/dotfiles --skill service-debug-ryosukesuto
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: service-debug
Source: https://github.com/ryosukesuto/dotfiles/tree/main/config/claude/skills/service-debug
Command: npx skills add https://github.com/ryosukesuto/dotfiles --skill service-debug-ryosukesuto

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps diagnose and resolve issues within Kubernetes services, focusing on identifying performance bottlenecks and understanding service behavior.

Core Features & Use Cases

  • Service Discovery: Lists and searches for services within a Kubernetes cluster.
  • Bottleneck Identification: Pinpoints common performance issues, such as Spanner latency in GetUserStage.
  • Pod Recreation Detection: Identifies pods that have been recreated due to node drains or other events, even when RESTARTS count doesn't reflect it, by analyzing creationTimestamp.
  • Event Monitoring: Checks for Killing or Evicted events for services.
  • Parallel Investigation: Facilitates simultaneous investigation of multiple services.

Quick Start

Use the service-debug skill to find all services in the default namespace.

Frequently Asked Questions about service-debug

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

FAQPage Schema
How do I debug Kubernetes services for performance bottlenecks?

Debug Kubernetes services by discovering services, pinpointing latency issues like Spanner bottlenecks in GetUserStage, and monitoring killing or eviction events to understand service behavior. It supports parallel investigation of multiple services within a cluster.

How do I detect pod recreations in Kubernetes when the restart count is zero?

Detect pod recreations by analyzing the creationTimestamp of pods. This identifies pods recreated due to node drains or other events even when the standard RESTARTS count does not reflect the disruption.

How do I find Killing or Evicted events for services in a Kubernetes cluster?

Find Killing or Evicted events by monitoring Kubernetes event logs for targeted services. This helps diagnose unexpected pod terminations and understand underlying cluster disruptions.

Can I investigate multiple Kubernetes services at the same time?

You can investigate multiple Kubernetes services simultaneously. The debugging process facilitates parallel investigation to identify performance bottlenecks across different services within the same environment.

What is the best way to list and search for services in a Kubernetes namespace?

List and search for services using service discovery commands within the Kubernetes cluster. This allows you to quickly find all services in the default namespace before deeper bottleneck analysis.

Why does my Kubernetes service have high latency in GetUserStage queries?

High latency in GetUserStage queries often points to Spanner performance bottlenecks. Investigating service behavior and monitoring pod events helps isolate whether the issue is database latency or pod recreation overhead.