k8s-yaml-validator

Validate Kubernetes YAML manifests for syntax and schema errors.

290|32|Updated Dec 5, 2025
One-click install
npx skills add https://github.com/akin-ozer/cc-devops-skills --skill k8s-yaml-validator
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: k8s-yaml-validator
Source: https://github.com/akin-ozer/cc-devops-skills/tree/main/devops-skills-plugin/skills/k8s-yaml-validator
Command: npx skills add https://github.com/akin-ozer/cc-devops-skills --skill k8s-yaml-validator

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires PyYAML, and includes scripts (resource) and references (resource) and assets (resource) components.

What problem does it solve?

This Skill validates Kubernetes YAML manifests to detect syntax and schema errors before cluster deployment.

Core Features & Use Cases

  • Validates YAML syntax and Kubernetes resource structure to identify indentation, type, and required-field errors.
  • Performs CRD documentation lookup and validation guidance for Custom Resources to prevent schema violations.
  • Supports multi-document manifests and optional server-side dry-run validation when a cluster is accessible to validate admission controllers and policies.

Quick Start

Use the k8s-yaml-validator to validate a Kubernetes manifest file like 'deployment.yaml'.

Frequently Asked Questions about k8s-yaml-validator

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

FAQPage Schema
How do I validate Kubernetes YAML manifests before cluster deployment?

Validate Kubernetes YAML manifests by checking syntax and schema errors before cluster deployment. This process detects indentation, type, and required-field issues across Deployments, Services, and CRDs to prevent deployment failures.

How does Kubernetes YAML linting work for multi-document resources?

Linting multi-document Kubernetes YAML resources works by parsing each document independently to verify resource structure and required fields. It uses yamllint and kubeconform to perform static checks across all bundled manifests.

Can I validate Custom Resource Definitions without applying them to a cluster?

You can validate Custom Resource Definitions without a cluster by using CRD documentation lookup and detection scripts. This offline validation provides guidance to prevent schema violations in Custom Resources without needing server-side access.

Do I need kubectl to run a server-side dry-run validation?

You need kubectl to run server-side dry-run validation because an accessible cluster is required. This method validates admission controllers and policies by simulating the deployment of your manifests against the live cluster state.

What is the best way to check Kubernetes YAML syntax and schema errors locally?

The best way to check Kubernetes YAML syntax and schema errors locally is using kubeconform and yamllint. These tools perform static validation on your manifests to catch indentation, type, and required-field errors before deployment.

What are the limitations of static Kubernetes manifest validation?

A limitation of static Kubernetes manifest validation is that it cannot evaluate admission controllers or dynamic cluster policies. You must use server-side dry-run validation with an accessible cluster to catch these runtime deployment errors.