kyverno-troubleshooting

Diagnose Kyverno policy violations and admission webhook failures in Kubernetes clusters.

18|2|Updated Jan 30, 2026
One-click install
npx skills add https://github.com/foxj77/claude-code-skills --skill kyverno-troubleshooting
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: kyverno-troubleshooting
Source: https://github.com/foxj77/claude-code-skills/tree/main/kyverno-troubleshooting
Command: npx skills add https://github.com/foxj77/claude-code-skills --skill kyverno-troubleshooting

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Kyverno Troubleshooting helps diagnose and resolve failures in Kyverno — the Kubernetes-native policy engine that validates, mutates, generates, and cleans up resources using policies written as Kubernetes resources.

Core Features & Use Cases

  • Diagnose admission webhook failures and policy violations.
  • Validate policy status, review ClusterPolicy and Policy results, and identify misconfigurations.
  • Quick reference workflows for debugging Kyverno components (admission, background, reports).

Quick Start

Run the Kyverno troubleshooting workflow to identify the blocking policy and verify the policy status in the cluster.

Frequently Asked Questions about kyverno-troubleshooting

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

FAQPage Schema
How do I troubleshoot Kyverno policy violations blocking resource creation in Kubernetes?

To troubleshoot Kyverno policy violations blocking resource creation, run the diagnostic workflow to identify the blocking ClusterPolicy, review admission webhook denial logs, and verify the policy enforcement status across namespaces and resource kinds.

Why does my Kyverno admission webhook deny Kubernetes resource deployments?

Kyverno admission webhook denials occur when resources violate active enforce-mode policies; validate the policy status and inspect the specific ClusterPolicy results to identify the misconfiguration causing the deployment failure.

How do I diagnose Kyverno generate-rule failures across namespaces?

Diagnose Kyverno generate-rule failures by validating the policy status and reviewing the background controller logs to identify why Kyverno fails to mutate or generate resources in the target namespaces.

What is the difference between audit and enforce mode when diagnosing Kyverno policy errors?

Audit mode logs Kyverno policy violations without blocking resource creation, while enforce mode actively denies admission requests; checking the policy status determines which mode is causing the observed policy errors.

Can I use this to fix Kyverno mutate rules that are not applying to my cluster resources?

Yes, you can diagnose Kyverno mutate rules not applying by validating the ClusterPolicy status and tracing the admission webhook processing logic to identify misconfigurations in the policy definitions.

What's the best way to validate Kyverno ClusterPolicy status during an incident?

The best way to validate Kyverno ClusterPolicy status during an incident is to run the troubleshooting workflow, which checks policy results and admission webhook errors to quickly remediate enforcement failures.