CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

kubernetes-operator

Use when building a Kubernetes Operator — custom controllers that reconcile CRD state. Triggers on "build an operator", "CRD design", "reconcile loop", "controller-runtime", "kubebuilder", "operator-sdk", "metacontroller", "KOPF", "operator capability levels", or "custom resource". Ships CRD validator, reconcile-loop linter, and OperatorHub capability auditor (all stdlib Python), 4 references on the operator pattern + CRD design + reconcile patterns + tooling landscape, and a /operator-audit slash command. NOT a generic k8s skill — specifically the Operator pattern.

66

Quality

83%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

The canonical home for this skill is kubernetes-operator in alirezarezvani/claude-skills

SKILL.md
Quality
Evals
Security

Quality

Content

66%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

The body is well-organized and unusually actionable, with concrete tool invocations, enumerated checks, and gated workflows that include validation and triage. Its two real weaknesses are redundancy — the same anti-patterns are explained three times, alongside restatement of Kubernetes basics Claude already knows — and a bundle that does not ship any of the files it references, leaving the quick-start commands and all reference links non-functional as distributed.

Suggestions

Ship the referenced bundle files (scripts/crd_validator.py, scripts/reconcile_lint.py, scripts/operator_capability_audit.py, the four references/*.md, and the two assets/*) or remove the references — as distributed, every Quick start command and 'See references/...' pointer fails.

Consolidate the triple-enumerated anti-pattern material: fold the 'Core principle' failure-mode list and the 'Anti-patterns' section into the single reconcile_lint check list (or vice versa) and keep one canonical copy.

Trim explanations of concepts Claude already knows (what finalizers, leader election, and OwnerReferences are for) down to bare checklist rules to tighten token efficiency.

DimensionReasoningScore

Conciseness

The body is mostly efficient and dense, but it re-explains well-known Kubernetes concepts Claude already has ("Add finalizers. Without finalizers, deletion races the controller", "Leader-elect when running >1 replica", "Set OwnerReferences. Cascading deletion is the operator pattern's free gift") and enumerates the same anti-patterns three times — the 7 failure modes in 'Core principle', the reconcile_lint checks, and the 'Anti-patterns' section. That is more than the 'minor instances' of the 4 anchor; it fits 'mostly efficient but ... could be tightened', not the 'severely verbose' 2 anchor.

3 / 5

Actionability

Concrete, copy-paste-ready commands throughout: 'python "$SKILL/scripts/crd_validator.py" --crd config/crd/myapp.yaml', 'kubebuilder init --domain example.com --repo github.com/org/myapp-operator', enumerated validator/linter checks, and decision rules ('New operator + Python shop → KOPF'). Not 5 because the commands invoke scripts/ and templates in assets/ that are not present in the skill bundle, so they do not actually execute as shipped — a real gap beyond the 'minor gaps' of the 4 anchor, but the guidance itself is specific and complete in form, well above the 3 anchor's pseudocode level.

4 / 5

Workflow Clarity

The three workflows have clear sequences with explicit validation gates and error triage: 'Fix every WARN before writing controller code', 'Run operator_capability_audit.py ... — confirm L1', 'Test in a kind cluster', and Workflow 2's 'FAIL → block release; fix before next deploy / WARN → file an issue; fix in next 30 days'. This matches 'clear sequence with explicit validation steps; feedback loops for error recovery'. No destructive/batch operations are involved, so no cap applies.

5 / 5

Progressive Disclosure

The in-file structure is good — one-level-deep, clearly labeled pointers ('See references/crd_design.md for full detail', a References section, named assets) — but scoring against the actual bundle, none of the referenced files exist: references/*.md, scripts/*.py, and assets/* are all absent, so every disclosure path (and the scripts central to the Quick start) is dangling. That is effectively broken navigation rather than the 'minor organization gaps' of 4 or the merely suboptimal organization of 3; it sits between 'references are buried'/broken structure (2) and 'some structure but could be better organized' (3), and the total absence of the referenced layer pulls it to 2.

2 / 5

Total

14

/

20

Passed

Description

95%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A strong description: explicit 'Use when' clause, a comprehensive natural-language trigger list including framework synonyms, concrete named tooling, and an explicit boundary ('NOT a generic k8s skill') that sharply reduces conflict risk. The only softness is that the 'what' leans on inventory (shipped scripts, reference count) rather than the skill's actions.

DimensionReasoningScore

Specificity

The description names the domain ("custom controllers that reconcile CRD state") and several concrete capabilities — "Ships CRD validator, reconcile-loop linter, and OperatorHub capability auditor (all stdlib Python), 4 references ... and a /operator-audit slash command" — matching the anchor 'lists several specific actions; minor gaps in coverage'. It falls short of 5 because the description emphasizes what the skill *ships* over what it *does*, leaving coverage of the actual operator-building guidance (workflows, design rules) implicit; it is above 3 because far more than 1-2 concrete actions are named.

4 / 5

Completeness

Both halves are explicit: what — "custom controllers that reconcile CRD state ... Ships CRD validator, reconcile-loop linter, and OperatorHub capability auditor"; when — "Use when building a Kubernetes Operator" plus "Triggers on" a concrete phrase list. This matches the anchor 'clearly and explicitly answers both what AND when with concrete trigger phrases'.

5 / 5

Trigger Term Quality

The explicit trigger list is comprehensive and natural: "build an operator", "CRD design", "reconcile loop", "controller-runtime", "kubebuilder", "operator-sdk", "metacontroller", "KOPF", "operator capability levels", or "custom resource" — covering the synonyms and framework names a user would actually say. Not below 5 since no plausible user phrasing for this domain is missing (the domain has no meaningful file extensions to include).

5 / 5

Distinctiveness Conflict Risk

It occupies a clear niche and actively disambiguates: "NOT a generic k8s skill — specifically the Operator pattern", and the trigger terms (kubebuilder, KOPF, reconcile loop, CRD design) are operator-specific rather than generic Kubernetes. Minimal conflict risk, matching the 5 anchor; 4 would require some overlap concern, which the explicit negative boundary rules out.

5 / 5

Total

19

/

20

Passed

Validation

87%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

referenced_paths_exist

Referenced path issues: 14 missing

Warning

Total

14

/

16

Passed

Repository

alirezarezvani/claude-skills

Path

.gemini/skills/skills-kubernetes-operator/SKILL.md

Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.