kubernetes-operator

Build Kubernetes operators with controller-runtime or kubebuilder workflows.

Updated Apr 24, 2026
One-click install
npx skills add https://github.com/Veloxia-agency/VELOXIA-WEB --skill kubernetes-operator
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: kubernetes-operator
Source: https://github.com/Veloxia-agency/VELOXIA-WEB/tree/main/.claude/skills/engineering/kubernetes-operator/skills/kubernetes-operator
Command: npx skills add https://github.com/Veloxia-agency/VELOXIA-WEB --skill kubernetes-operator

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This Skill helps you design, validate, and harden Kubernetes Operators so they reconcile custom resources correctly instead of drifting, looping, or leaving external resources orphaned.

Core Features & Use Cases

  • CRD Design Guidance: Shape production-ready APIs with status subresources, conditions, printer columns, and schema validation.
  • Reconcile Loop Hardening: Catch common controller bugs such as spec mutation, missing finalizers, blocking calls, and bad requeue behavior.
  • Operator Capability Audits: Assess an operator’s maturity across install, upgrades, lifecycle handling, observability, and automation.
  • Use Case: A platform team can use this Skill to review a new controller before release, confirm the CRD is safe, and identify exactly what is needed to reach the next OperatorHub capability level.

Quick Start

Ask for help designing or auditing a Kubernetes operator, including the CRD schema, reconcile loop, finalizers, status conditions, and framework choice.

Frequently Asked Questions about kubernetes-operator

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

FAQPage Schema
How do I build a Kubernetes operator with controller-runtime that reconciles custom resources safely?

To build a Kubernetes operator with controller-runtime, design a CRD with structural schema validation and implement an idempotent reconcile loop that handles status subresources, finalizers, and deterministic requeues to prevent resource drift.

Why does my Kubernetes operator reconcile loop keep drifting or leaving orphaned resources?

A Kubernetes operator reconcile loop drifts or orphans resources due to missing finalizers, accidental spec mutations, blocking calls, or improper requeue handling. Enforce idempotent reconciliation and correct finalizer cleanup to resolve these issues.

What is the best way to design a CRD schema with status conditions and printer columns?

The best way to design a CRD schema is to apply structural schema validation, configure status subresources to prevent spec mutation, and define standard status conditions and printer columns for production-ready operator API surfaces.

How do I audit a Kubernetes operator for OperatorHub capability levels?

Audit a Kubernetes operator for OperatorHub capability levels by assessing its maturity across installation, upgrades, lifecycle handling, observability, and automation, ensuring leader election and operator capability best practices are met.

Does this Skill work with kubebuilder workflows for controller debugging?

Yes, this Skill works with kubebuilder and controller-runtime workflows to debug reconcile loops, enforce finalizer handling, validate status conditions, and harden custom resource reconciliation for production-grade operator deployment.

When should I add finalizers to my Kubernetes custom resources?

Add finalizers to Kubernetes custom resources when your operator manages external resources that require explicit cleanup. Finalizers ensure the reconcile loop blocks deletion until external dependencies are safely removed, preventing orphaned resources.