skills.rest
X-McKay
X-McKayCOMMUNITY
Explore all skills by this author →
GitHub

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
One-click install
npx skills add https://github.com/X-McKay/kubani --skill diagnose-storage-issue
Or copy as Structured Prompt for Agent▼
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.

Related Skills

Explore More Software Engineering Skills→
rohitg00rohitg00
944

k8s-storage

Provision, inspect, and troubleshoot Kubernetes PVCs, PVs, and storage classes.

Community
Intermediate
googlegoogle
17.1k

gke-storage

Automate GKE storage management by configuring PersistentVolumes, PersistentVolumeClaims, Filestore, and GCS FUSE.

Official
Intermediate
gavinmcfallgavinmcfall
3

k8s-operator

Queries and diagnoses Kubernetes clusters including Talos nodes, Ceph storage, and Cilium networking.

Community
Advanced
keiretsu-labskeiretsu-labs
9

Pod Troubleshooting

Diagnose Kubernetes pod failures with kubectl commands in the openclaw namespace.

Official
Intermediate