scriptoriumadmin/claude-skills
1
0
Fork 0
mirror of https://github.com/alirezarezvani/claude-skills.git synced 2026-08-28 04:24:58 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions
claude-skills/engineering/kubernetes-operator
History
Exact
Claude 0f88555485
chore(versioning,docs): normalize stale versions to 2.9.0 + refresh counts 
Version normalization (scope: only plugins/skills older than 2.7.0):
- Bumped 52 plugin.json + 21 SKILL.md `version` fields from pre-2.7.0
  values (1.0.0 / 2.0.x / 2.2.x / 2.3.x / 2.4.x / 2.5.x) to 2.9.0.
  Left 2.7.0+ packages untouched. Tool mirrors (.codex/.gemini/.vibe/
  .hermes) excluded. All manifests still pass check_plugin_json --all.

Doc count refresh (recomputed raw figures: 338 skills, 16 domains,
62 plugins, 533 Python tools, 676 references):
- marketplace.json: both descriptions + metadata.version -> 2.9.0.
- Root README: headline, badges (Skills 338, Agents 51+, Commands 87+),
  intro counts, convert section (338 skills / 9 tools), and the full
  domain table rebuilt to 16 domains summing to 338 (adds research-ops,
  business-operations, commercial, compliance-os; corrects product 17,
  marketing 46, c-level 66, ra-qm 18, finance 4, engineering 51/78).
- Fixed stale per-skill README `Version:` lines left inconsistent by the
  bump (andreessen, c-level-agents, product-team, senior-qa).
- Fixed stale domain README footers (product-team 17/17, c-level 66/66,
  project-management 9/9).
- CLAUDE.md scope line, structure tree, highlight, and footer synced to
  the raw figures.

https://claude.ai/code/session_01PUNmQVE4WYvcrzpq2anC3D
2026-05-27 05:22:59 +00:00
..
.claude-plugin chore(versioning,docs): normalize stale versions to 2.9.0 + refresh counts 2026-05-27 05:22:59 +00:00
skills/kubernetes-operator chore(versioning,docs): normalize stale versions to 2.9.0 + refresh counts 2026-05-27 05:22:59 +00:00
README.md feat(skills): ship kubernetes-operator (Phase 2 — operator pattern discipline) 2026-05-09 09:01:45 +00:00

README.md

Kubernetes Operator

End-to-end discipline for building Kubernetes Operators correctly. Catches the recurring reconcile-loop bugs (missing finalizers, blocking calls, status drift, RBAC over-grants, no requeue) before they reach a cluster.

What's inside

  • 3 stdlib Python tools — CRD validator, reconcile-loop linter, OperatorHub capability auditor
  • 4 reference docs — operator pattern, CRD design, reconcile patterns, framework comparison
  • Asset templates — production CRD YAML + Go controller skeleton (both pass the linters)
  • /operator-audit slash command — runs all 3 tools and produces a report

Install

# Via Claude Code marketplace
/plugin install kubernetes-operator

# Or clone the repo
git clone https://github.com/alirezarezvani/claude-skills.git
cd claude-skills/engineering/kubernetes-operator

Quick start

SKILL=engineering/kubernetes-operator/skills/kubernetes-operator

python "$SKILL/scripts/crd_validator.py" --crd config/crd/myapp.yaml
python "$SKILL/scripts/reconcile_lint.py" --controller controllers/myapp_controller.go
python "$SKILL/scripts/operator_capability_audit.py" --operator-dir .

Scope

This is the Operator pattern specifically. For other Kubernetes work:

  • Helm chart authoring → helm-chart-builder
  • Kubectl operations / blue-green deploys → senior-devops
  • General k8s security → cloud-security
  • Cloud architecture → aws-solution-architect, azure-cloud-architect, gcp-cloud-architect

Key principles

  1. Reconcile is idempotent, declarative, and bounded in time
  2. Status subresource is non-negotiable — without it, status updates loop spec reconciles
  3. Finalizers protect external resources — cascade deletion is the operator pattern's free gift, but only for owned k8s resources
  4. RBAC is least-privilege — controllers shouldn't read secrets they don't need
  5. Capability levels are an SLA, not a label — aim for L3 (Full Lifecycle) before public release

Skill structure

kubernetes-operator/
├── README.md
├── .claude-plugin/plugin.json
└── skills/kubernetes-operator/
    ├── SKILL.md
    ├── scripts/
    │   ├── crd_validator.py
    │   ├── reconcile_lint.py
    │   └── operator_capability_audit.py
    ├── references/
    │   ├── operator_pattern.md
    │   ├── crd_design.md
    │   ├── reconcile_loop.md
    │   └── tooling_landscape.md
    └── assets/
        ├── crd_template.yaml
        └── reconcile_skeleton.go

Verifiable success

A team using this skill should achieve:

  • 100% of new CRDs pass crd_validator.py before merge
  • All reconcile functions pass reconcile_lint.py strict mode
  • Operators reach OperatorHub Capability Level 3 before public release
  • Mean time to fix a reconcile bug: <1 day (no infinite loops in production)

License

MIT — see repo root LICENSE.