Gitops Cluster Debug
fluxcd/agent-skills
Debug and troubleshoot Flux CD on live Kubernetes clusters (not local repo files) via the Flux MCP server — inspects Flux resource status, reads controller logs, traces dependency chains, and…
Design, build, and operate Kubernetes operators. An agent skill from borghei/Claude-Skills.
Install Kubernetes Operator
$ npx skills add borghei/Claude-Skills --skill kubernetes-operator -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install borghei/Claude-Skills kubernetes-operator --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ git clone --depth 1 https://github.com/borghei/Claude-Skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/engineering/kubernetes-operator .claude/skills/kubernetes-operator && rm -rf skills-srcUse ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.
Claude Code skills documentation · loads skills from .claude/skills/
Install the "kubernetes-operator" agent skill from https://github.com/borghei/Claude-Skills/tree/main/engineering/kubernetes-operator into .claude/skills/kubernetes-operator/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "kubernetes-operator", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$skill-installer install https://github.com/borghei/Claude-Skills/tree/main/engineering/kubernetes-operatorType this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
$ npx skills add borghei/Claude-Skills --skill kubernetes-operator -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install borghei/Claude-Skills kubernetes-operator --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/borghei/Claude-Skills.git skills-src && mkdir -p .agents/skills && cp -r skills-src/engineering/kubernetes-operator .agents/skills/kubernetes-operator && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "kubernetes-operator" agent skill from https://github.com/borghei/Claude-Skills/tree/main/engineering/kubernetes-operator into .agents/skills/kubernetes-operator/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "kubernetes-operator", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add borghei/Claude-Skills --skill kubernetes-operator -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install borghei/Claude-Skills kubernetes-operator --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/borghei/Claude-Skills.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/engineering/kubernetes-operator .cursor/skills/kubernetes-operator && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "kubernetes-operator" agent skill from https://github.com/borghei/Claude-Skills/tree/main/engineering/kubernetes-operator into .cursor/skills/kubernetes-operator/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "kubernetes-operator", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gemini skills install https://github.com/borghei/Claude-Skills.git --path engineering/kubernetes-operator--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add borghei/Claude-Skills --skill kubernetes-operator -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install borghei/Claude-Skills kubernetes-operator --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/borghei/Claude-Skills.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/engineering/kubernetes-operator .gemini/skills/kubernetes-operator && rm -rf skills-srcUse ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "kubernetes-operator" agent skill from https://github.com/borghei/Claude-Skills/tree/main/engineering/kubernetes-operator into .gemini/skills/kubernetes-operator/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "kubernetes-operator", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install borghei/Claude-Skills kubernetes-operatorInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add borghei/Claude-Skills --skill kubernetes-operator -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/borghei/Claude-Skills.git skills-src && mkdir -p .github/skills && cp -r skills-src/engineering/kubernetes-operator .github/skills/kubernetes-operator && rm -rf skills-srcUse ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "kubernetes-operator" agent skill from https://github.com/borghei/Claude-Skills/tree/main/engineering/kubernetes-operator into .github/skills/kubernetes-operator/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "kubernetes-operator", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add borghei/Claude-Skills --skill kubernetes-operator -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install borghei/Claude-Skills kubernetes-operator --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/borghei/Claude-Skills.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/engineering/kubernetes-operator .opencode/skills/kubernetes-operator && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "kubernetes-operator" agent skill from https://github.com/borghei/Claude-Skills/tree/main/engineering/kubernetes-operator into .opencode/skills/kubernetes-operator/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "kubernetes-operator", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
Facts
- Skill name
kubernetes-operator- GitHub stars
- 874
- Token cost
- ~1.8k tokens
- SKILL.md length
- 688 words
- Files
- 8 (incl. scripts, references)
- Skills in repo
- 364
- Repo updated
- First seen
- Licence
- MIT
At a glance
Design, build, and operate Kubernetes operators. An agent skill from borghei/Claude-Skills.
- Extending Kubernetes with a custom controller
- SKILL.md covers Core Capabilities, When to Use, Clarify First and Tools, plus 3 more sections
- Runs Python scripts from its folder; calls python3
- Choosing a framework
What it does
Kubernetes Operator is an agent skill from borghei/Claude-Skills. Design, build, and operate Kubernetes operators. Use when extending Kubernetes with a custom controller, choosing a framework, designing CRDs, implementing reconciliation loops, or auditing an operator for anti-patterns.
Its SKILL.md is about 1.8k tokens, which your agent loads only when the skill is triggered. The skill folder holds 9 other files, including scripts and reference files (for example `references/controller-runtime-patterns.md`, `references/operator-anti-patterns.md` and `references/operator-decisions-and-workflows.md`).
It sits in DevOps & Cloud, covering Container orchestration and Accounting and bookkeeping. It works with Kubernetes. The repository describes itself as: 385 AI skills, 77 expert agents, and 900 stdlib Python tools for every team: engineering, PM, marketing, C-level, compliance, business ops, research, and a LinkedIn toolkit… The licence is MIT.
When your agent uses it
- Extending Kubernetes with a custom controller
- Choosing a framework
- Implementing reconciliation loops
- Auditing an operator for anti-patterns
Example prompts
- “/kubernetes-operator”
Requirements
- Python 3
What it can do on your machine
Read from SKILL.md and the folder at commit c9a1487. It shows what the files ask for, not the result of running them.
Tool permissions
Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.
From allowed-tools in the SKILL.md frontmatter.
Runs code
Ships 3 files in scripts/ (Python), which the agent can run.
Shell commands in SKILL.md call:
python3
From the folder's file list and the shell code blocks in SKILL.md.
Network
No URLs in SKILL.md.
From URLs in SKILL.md, links to its own repository left out.
Credentials
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.
Context cost
Kubernetes Operator loads about 1.8k tokens when it runs, and up to ~20k if it reads all its reference files. Until then it costs about 60 tokens; SKILL.md has 688 words of instructions outside code blocks.
Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.
Safety
Auto-check passed
The automated check found no risky patterns in SKILL.md.
Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.
SKILL.md
The full file from borghei/Claude-Skills at commit c9a1487, republished under its MIT licence (© borghei). 688 words, ~1,822 tokens.
Download SKILL.mdSave it as
.claude/skills/kubernetes-operator/SKILL.md (or your agent's skills folder). This skill also uses 7 other files; get the full folder from GitHub.- name
- kubernetes-operator
- description
- Design, build, and operate Kubernetes operators. Use when extending Kubernetes with a custom controller, choosing a framework, designing CRDs, implementing reconciliation loops, or auditing an operator for anti-patterns.
- license
- MIT + Commons Clause
- metadata.version
- 1.1.0
- metadata.author
- borghei
- metadata.category
- engineering
- metadata.domain
- engineering
- metadata.updated
- 2026-06-17
- metadata.tags
- kubernetes, operator-pattern, crd, controller-runtime, kubebuilder, platform-engineering, sre
Kubernetes Operator
End-to-end Kubernetes operator design and construction. Covers the operator pattern (control loops for stateful workloads), CRD design (schema, validation, conversion, status), the reconciliation loop (idempotency, convergence, level- vs edge-triggered), framework selection (controller-runtime / Kubebuilder / operator-SDK / metacontroller), and operational concerns (finalizers, leader election, RBAC scoping, status subresource, observability). Targets Go-based operators (the dominant ecosystem) with notes on alternatives (KOPF, JOSDK, kube-rs).
Core Capabilities
- Decide whether to write an operator — operator vs Helm vs GitOps vs admission webhook vs Crossplane, and when NOT to build one at all.
- CRD design — spec/status separation, OpenAPI v3 structural schemas, CEL cross-field validation, versioning, conversion webhooks, status subresource, printer columns, scale subresource.
- Reconciliation loops — idempotent, level-triggered, converging control loops; phase machines vs always-converge; owner references and garbage collection.
- Controller-runtime patterns (Go) — skeleton reconcilers, server-side apply, finalizers, leader election, watches/predicates/indexers, error classification, envtest.
- Framework selection — controller-runtime, Kubebuilder, operator-SDK, Metacontroller, KOPF, JOSDK, kube-rs.
- Operational hardening — finalizers, leader election, tightened RBAC, status conditions/observedGeneration, Prometheus metrics + structured logging.
- Anti-pattern audit — 24-entry catalog with severities, detection heuristics, and fixes for production-readiness review.
When to Use
| Situation | Skill applies |
|---|---|
| Building a new operator for an internal platform primitive | Yes — start with the operator pattern decision |
| Auditing an existing operator for production-readiness | Yes — use anti-patterns + scripts/reconciliation_audit.py |
| Designing CRDs for a custom resource | Yes — use CRD design + scripts/crd_validator.py |
| Deciding "operator vs Helm chart vs plain manifests" | Yes — use the decision matrix |
| Scaffolding a new operator project | Yes — scripts/operator_scaffold.py |
| Debugging a controller that "isn't reconciling" | Yes — use reconciliation troubleshooting |
| Just running someone else's operator (Postgres, Kafka, etc.) | Partially — useful for understanding what it does and how to monitor it |
Clarify First
Before scaffolding or auditing, confirm these inputs. If any is unknown or vague, ASK — do not assume:
- Task — scaffold an operator, validate a CRD, or audit a controller (selects
operator_scaffold.pyvscrd_validator.pyvsreconciliation_audit.py) - Resource identity — for scaffolding: the operator name, API group, and kind (sets
--name/--group/--kind); for validation/audit: the CRD YAML or controller path (the input the scripts read) - Framework — controller-runtime/Kubebuilder/operator-SDK (Go), or KOPF/JOSDK/kube-rs (drives the scaffold patterns)
Stop rule: ask only the 2-3 that most change the output. If the user says "just draft it," proceed and list your assumptions at the top of the artifact.
Tools
| Tool | Purpose | Command |
|---|---|---|
crd_validator.py | Validate CRD YAML against design best practices (preserve-unknown, missing descriptions/enums/printer-columns, status subresource, cluster-scope) | python3 scripts/crd_validator.py --schema my-crd.yaml --format markdown |
operator_scaffold.py | Generate a production-ready operator project skeleton with stricter RBAC, observability, and finalizer scaffolding | python3 scripts/operator_scaffold.py --name db-operator --group example.com --kind Database |
reconciliation_audit.py | Audit Go controller source + CRDs for static-detectable anti-patterns (missing finalizers, no leader election, tight loops, no ownerRef, wide RBAC) | python3 scripts/reconciliation_audit.py --controller-path ./internal/controllers --crd ./config/crd/bases/*.yaml |
All scripts: stdlib only, argparse CLI, JSON or markdown output.
Show full SKILL.md (241 more words)Show less
References
Load the reference that matches the task — keep this file lean and pull detail on demand:
- references/operator-pattern-and-crds.md — pattern fundamentals, full CRD schema design (validation, CEL, status patterns), versioning, conversion webhooks, status/scale subresources, printer columns, RBAC, and a production-CRD checklist. Read when designing or reviewing a CRD.
- references/controller-runtime-patterns.md — Go controller-runtime examples: skeleton reconciler, idempotent apply, owner refs, status updates, finalizers, leader election, watches/predicates/indexers, error handling, RBAC markers, envtest, plus the reconciliation-loop overview and operational concerns. Read when implementing or debugging a controller.
- references/operator-anti-patterns.md — the full 24-entry anti-pattern catalog with severity, symptoms, consequences, fixes, a static-detection summary, and symptom-based triage. Read during design review, code review, or pre-production audit.
- references/operator-decisions-and-workflows.md — when NOT to write an operator, operator-vs-alternatives decision matrix, framework selection, the four end-to-end workflows (scaffold / audit / design CRD / upgrade versions), and tooling outputs. Read when deciding the approach or running a workflow.
Scope & Limitations
Covers: operator pattern decisions; CRD design (schema/validation/versioning/conversion/subresources); idempotent reconciliation loops; Go controller-runtime / Kubebuilder / operator-SDK patterns; finalizers, leader election, RBAC scoping, observability; anti-pattern auditing. Primary target is Go operators, with notes on KOPF (Python), JOSDK (Java), kube-rs (Rust).
Does NOT cover: operating third-party community operators beyond understanding/monitoring them; cloud-provider-specific resource provisioning (see Crossplane); general Kubernetes cluster administration.
Integration Points
| Skill | Integration |
|---|---|
engineering/chaos-engineering | Chaos-test operators (kill the controller, partition from API server) |
engineering/observability-designer | Wire metrics + logging for operators |
engineering/incident-commander | Operators amplify blast radius; incident response matters more |
engineering/feature-flags-architect | Operators with spec.feature.<x>.enabled fields effectively become flag systems; consider the trade-off |
© borghei, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file
Files
SKILL.md and 7 other files (scripts, references) in engineering/kubernetes-operator of borghei/Claude-Skills.
- SKILL.md
- references/controller-runtime-patterns.md
- references/operator-anti-patterns.md
- references/operator-decisions-and-workflows.md
- references/operator-pattern-and-crds.md
- scripts/crd_validator.py
- scripts/operator_scaffold.py
- scripts/reconciliation_audit.py
Open the folder on GitHubat commit c9a1487
Compare with similar skills
Kubernetes Operator next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| Kubernetes Operator this skillborghei/Claude-Skills | 874 | — | ~1.8k | Automated safety check: Pass | MIT | |
| Gitops Cluster Debugfluxcd/agent-skills | 230 | — | ~4.2k | Automated safety check: Pass | Apache-2.0 | |
| Operate Cloud Posture Toolchaincyberful/cyberful | 134 | — | ~907 | Automated safety check: Pass | AGPL-3.0 | |
| Operate Kubernetes Toolchaincyberful/cyberful | 134 | — | ~898 | Automated safety check: Pass | AGPL-3.0 | |
| Kubeshark Installerkubeshark/kubeshark | 12k | — | ~3.6k | Automated safety check: Notes | Apache-2.0 | |
| KubeSphere Multi-Tenant Managementkubesphere/kubesphere | 17k | — | ~3.1k | Automated safety check: Pass | Custom licence |
Similar skills
Operate Cloud Posture Toolchain
cyberful/cyberful
Operate Prowler, Cloudsplaining, cloud CLIs, policy documents, and resource evidence for advanced AWS, Azure, GCP, and Kubernetes-adjacent posture assessment.
Operate Kubernetes Toolchain
cyberful/cyberful
Operate kubectl, kube-bench, Trivy, Prowler, and manifest/runtime evidence for advanced Kubernetes security assessment.
Kubeshark Installer
kubeshark/kubeshark
Installs and configures Kubeshark on a Kubernetes cluster, choosing between the quick CLI path and a Helm install with custom values.
KubeSphere Multi-Tenant Management
kubesphere/kubesphere
Creates and queries KubeSphere users, workspaces and projects and assigns built-in roles, defaulting to least privilege and never deleting anything.
Sim Helm
simstudioai/sim
Install, upgrade, and operate the Sim Helm chart on Kubernetes.
More from borghei/Claude-Skills
All 364 skills in this repoAgents In The Team
borghei/Claude-Skills
Run delivery when AI coding and ops agents take tickets. An agent skill from borghei/Claude-Skills.
AI Content Disclosure
borghei/Claude-Skills
Check AI-generated marketing content and reviews for required disclosures under the EU AI Act, FTC rules and platform AI-label policies.
AI Prototyping
borghei/Claude-Skills
Idea to AI-generated prototype to customer validation to engineering handoff.
Analytics Engineer
borghei/Claude-Skills
Analytics engineering across data modeling, dbt, transformation, and semantic layers.
Ansoff Matrix
borghei/Claude-Skills
Ansoff Matrix — 4-quadrant framework for growth options: market penetration, market/product development, and diversification.
Brainstorm Okrs
borghei/Claude-Skills
OKR brainstorming and validation using the Radical Focus framework — outcome objectives, measurable key results, counter-metrics.
Related
Works with
Categories
Questions about Kubernetes Operator
What does Kubernetes Operator do?
Design, build, and operate Kubernetes operators. An agent skill from borghei/Claude-Skills. Kubernetes Operator is an agent skill from borghei/Claude-Skills. Design, build, and operate Kubernetes operators.
When should I use Kubernetes Operator?
Kubernetes Operator fits situations like: extending Kubernetes with a custom controller; choosing a framework; implementing reconciliation loops; auditing an operator for anti-patterns.
How do I install Kubernetes Operator in Claude Code?
Run `npx skills add borghei/Claude-Skills --skill kubernetes-operator -a claude-code`. Or copy the skill folder (engineering/kubernetes-operator in borghei/Claude-Skills) into .claude/skills/kubernetes-operator in your project. Claude Code loads it when a task matches its description.
How do I install Kubernetes Operator in Codex?
Run `npx skills add borghei/Claude-Skills --skill kubernetes-operator -a codex`. Or copy the skill folder (engineering/kubernetes-operator in borghei/Claude-Skills) into .agents/skills/kubernetes-operator in your project. Codex loads it when a task matches its description.
Can I use Kubernetes Operator in Cursor, Gemini CLI or GitHub Copilot?
Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add borghei/Claude-Skills --skill kubernetes-operator -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/kubernetes-operator, .gemini/skills/kubernetes-operator, .github/skills/kubernetes-operator and .opencode/skills/kubernetes-operator in your project.
What does Kubernetes Operator need to run?
Going by SKILL.md and its folder, Kubernetes Operator needs Python for the scripts in its folder and the command-line tools its instructions call (python3). Our summary lists: Python 3.
Does Kubernetes Operator access the network?
SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.
Is Kubernetes Operator safe to install?
Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.
What licence does Kubernetes Operator use?
Kubernetes Operator is published under the MIT licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.
How many tokens does Kubernetes Operator use?
About 1.8k tokens (SKILL.md is roughly 7.3k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 18k tokens, read only when the agent opens those files.
What are the alternatives to Kubernetes Operator?
Skills that share tags, products or a category with Kubernetes Operator: Gitops Cluster Debug (fluxcd/agent-skills, 230 stars), Operate Cloud Posture Toolchain (cyberful/cyberful, 134 stars), Operate Kubernetes Toolchain (cyberful/cyberful, 134 stars) and Kubeshark Installer (kubeshark/kubeshark, 12k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
Who maintains Kubernetes Operator?
borghei (a GitHub user) maintains it in borghei/Claude-Skills, which has 874 GitHub stars. The repository holds 364 skills in this directory. The repository was last updated on October 7, 2026.
Source: borghei/Claude-Skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.