Individual skill
kubernetes-operator
Use when building a Kubernetes operator or CRD (controller-runtime, kubebuilder, operator-sdk, KOPF), before writing the controller. Validates CRDs with crd_validator.py, lints reconcile loops with reconcile_lint.py and scores OperatorHub capability level.
engineering/skills/kubernetes-operator/SKILL.md
Source commit 9ef0c3c213932e645cc5cbeeb3c35c3a762a2437
What was checked
- Matches the observed repository HEAD
- Yes
- Scanner rules are current
- No
- Repository scan complete
- No
- Skill scan complete
- No
- Observed behavior
- Not checked yet
- Last checked
- Nov 3, 2026
These are observations at the recorded commit, not a guarantee of safety. Review the source before running it.
Install this skill
Choose an agent in your Stack or copy a command below. Commands fetch the pinned commit and copy only this skill directory. Existing destinations are refused. Copying a command does not install anything.
An install command is unavailable: current rules, complete repository and skill scans, an eligible behavior level and a permitted license are required.
Repository context
- Repository stars (not skill ratings)
- 29,484
- Repository last updated
- Nov 5, 2026
- License
- MIT
Observed agent integration: No specific integration evidence. Standard SKILL.md installation does not imply verified compatibility.
- agentic-ai Repository topic
- anthropic-claude Repository topic
- claude-ai Repository topic
- claude-code Repository topic
- claude-skills Repository topic
- claude-code-skills Repository topic
- ai-coding-agent Repository topic
- claude-code-plugins Repository topic
- developer-tools Repository topic
- openai-codex Repository topic
- kubernetes Declared skill tag
- operator Declared skill tag
- crd Declared skill tag
- controller-runtime Declared skill tag
- kubebuilder Declared skill tag
- operator-sdk Declared skill tag
- metacontroller Declared skill tag
- kopf Declared skill tag
- reconcile Declared skill tag
- devops Declared skill tag
- devops Derived category
- writing Derived category
- devops-containers Derived category
Files and excerpt
File metadata and permitted, redacted excerpts come from the recorded scan. Source links are pinned to that commit.
Browse files
SKILL.mdcore · 10,938 bytesSKILL.mdcore · 10,938 bytesSKILL.mdcore · 10,938 bytesSKILL.mdcore · 10,938 bytesSKILL.mdcore · 10,938 bytesSKILL.mdcore · 10,938 bytesSKILL.mdcore · 10,938 bytesSKILL.mdcore · 10,938 bytesSKILL.mdcore · 10,938 bytesassets/crd_template.yamlasset · 2,620 bytesassets/reconcile_skeleton.goruns · 4,052 bytesreferences/crd_design.mddoc · 6,998 bytesreferences/operator_pattern.mddoc · 7,157 bytesreferences/reconcile_loop.mddoc · 7,275 bytesreferences/tooling_landscape.mddoc · 7,642 bytesscripts/crd_validator.pyruns · 5,939 bytesscripts/operator_capability_audit.pyruns · 5,916 bytesscripts/reconcile_lint.pyruns · 6,495 bytes
Read excerpt
# Kubernetes Operator
Build operators that reconcile correctly. Most operator bugs are not Kubernetes bugs — they are reconcile-loop bugs: missing finalizers, blocking calls, no requeue on transient errors, status drift, RBAC over-grants. This skill catches them deterministically before they reach a cluster.
## When to use
- Building a new Kubernetes Operator (controller for a CRD)
- Reviewing an existing operator for capability-level gaps
- Auditing a CRD spec for status/conditions/finalizer correctness
- Choosing a framework (controller-runtime / kubebuilder / operator-sdk / metacontroller / KOPF)
- Designing the API surface of a Custom Resource
- Hardening RBAC, leader election, or webhook validation
## When NOT to use