quota-debug

Diagnose Kubernetes ResourceQuota and LimitRange admission rejections preventing pod creation.

225|28|Updated Mar 2, 2026
One-click install
npx skills add https://github.com/scitix/siclaw --skill quota-debug
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: quota-debug
Source: https://github.com/scitix/siclaw/tree/main/skills/core/quota-debug
Command: npx skills add https://github.com/scitix/siclaw --skill quota-debug

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps diagnose and resolve issues where pods cannot be created in Kubernetes due to exceeding resource quotas or violating limit range constraints.

Core Features & Use Cases

  • ResourceQuota Diagnosis: Identifies if a namespace's ResourceQuota for CPU, memory, pods, or other resources has been exhausted.
  • LimitRange Violation Detection: Pinpoints specific LimitRange violations, such as minimum/maximum resource requirements, ratio constraints, or missing resource specifications.
  • Use Case: When a new deployment fails to create pods and events show FailedCreate with messages like "exceeded quota" or "forbidden: LimitRange", this skill guides you through checking namespace quotas, current usage, and LimitRange configurations to find the exact cause.

Quick Start

Use the quota-debug skill to diagnose why pods are failing to be created in the 'default' namespace.

Frequently Asked Questions about quota-debug

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

FAQPage Schema
Why does Kubernetes pod creation fail with exceeded quota errors?

Kubernetes pod creation fails with exceeded quota errors when a namespace's ResourceQuota for CPU, memory, pods, or storage is fully exhausted. Diagnosing the issue requires analyzing current resource usage against namespace quotas to identify the exhausted dimension.

How do I debug LimitRange violations preventing pod creation in Kubernetes?

Debug Kubernetes LimitRange violations by pinpointing specific constraint breaches like minimum or maximum resource requirements, ratio constraints, or missing resource specifications in pod manifests. Analyze ReplicaSet events to find the exact Forbidden LimitRange rejection cause.

What causes FailedCreate errors in a Kubernetes ReplicaSet?

FailedCreate errors in a Kubernetes ReplicaSet occur when admission control rejects pod creation due to ResourceQuota exhaustion or LimitRange violations. Analyzing namespace quotas, current usage, and LimitRange constraints identifies the specific root cause.

How do I check if a namespace ResourceQuota is exhausted in Kubernetes?

Check if a Kubernetes namespace ResourceQuota is exhausted by validating current resource usage against configured quota dimensions for CPU, memory, pods, and storage. This comparison reveals which specific resource limit is preventing new pod creation.

Can missing resource specifications cause Kubernetes pod creation failures?

Missing resource specifications cause Kubernetes pod creation failures when LimitRange constraints require explicit resource requests or limits. The admission controller rejects pods lacking these specifications to enforce namespace resource governance policies.

Does this Skill diagnose all types of Kubernetes admission control rejections?

This Skill diagnoses Kubernetes native ResourceQuota and LimitRange admission rejections specifically. It validates quota dimensions like CPU and memory, and checks LimitRange specifics including minimums, maximums, ratios, and defaults.