diagnose-storage-issue

Diagnose Kubernetes storage issues by checking PVC binding, storage classes, and volume mounts.

3|Updated Dec 2, 2025

Search Tags:#troubleshooting #kubernetes #storage #pvc #pv #pending pods

Ready to run

npx skills add https://github.com/X-McKay/kubani --skill diagnose-storage-issue

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: diagnose-storage-issue
Source: https://github.com/X-McKay/kubani/tree/main/kubani/skills/k8s/diagnostic/diagnose-storage-issue
Command: npx skills add https://github.com/X-McKay/kubani --skill diagnose-storage-issue

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps diagnose and identify the root cause of persistent storage and volume binding issues in Kubernetes clusters, preventing pods from remaining in a pending state.

Core Features & Use Cases

PVC Binding Check: Verifies if PersistentVolumeClaims are successfully bound to PersistentVolumes.
Storage Class Validation: Confirms the existence and correct configuration of StorageClasses.
Volume Mount Status: Inspects how volumes are mounted to pods.
Event Analysis: Scans Kubernetes events for storage-related errors or warnings.
Use Case: When a new database pod fails to start because its data volume cannot be provisioned, this skill can pinpoint whether the issue lies with the PVC, the StorageClass, or the underlying PV.

Quick Start

Use the diagnose-storage-issue skill to check the status of the PVC named 'my-data-pvc' in the 'production' namespace.

Frequently Asked Questions about diagnose-storage-issue

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

FAQPage Schema

Why is my Kubernetes pod stuck in pending state with a volume mount failure?▼

Pods stuck in pending states with volume mount failures occur when PersistentVolumeClaims cannot bind to PersistentVolumes or StorageClasses are misconfigured. This Skill checks PVC binding status and identifies the root cause of provisioning failures.

How do I check PVC binding status and StorageClass configuration in Kubernetes?▼

Check PVC binding status and StorageClass configuration by querying PersistentVolumeClaims, PersistentVolumes, and StorageClasses via an MCP server. This Skill verifies PVC binding and confirms StorageClass existence and correct configuration.

How do I diagnose persistent volume provisioning failures for a pending database pod?▼

Diagnose persistent volume provisioning failures by inspecting volume mount status to pods and scanning Kubernetes events for storage-related errors. This Skill pinpoints whether the issue lies with the PVC, StorageClass, or underlying PV.

Do I need an MCP server to query Kubernetes storage resources like PersistentVolumeClaims?▼

Yes, an MCP server is required to query Kubernetes resources like PersistentVolumeClaims, PersistentVolumes, StorageClasses, Pods, and Events. This Skill requires MCP server access to perform its storage issue diagnosis.

Can this Skill identify root causes for pods stuck in pending states due to PVC issues?▼

Yes, this Skill identifies root causes for pods stuck in pending states due to PVC issues by analyzing PVC binding status, StorageClass configuration, volume mount status, and Kubernetes events to pinpoint the exact storage provisioning failure.