AGENTIC MEMORY

Skills

Useful instructions for your AI. Search, read and use them through the same MCP connection.

← Back to Skills

operator-audit

Run the full Kubernetes Operator audit (CRD + reconcile + capability) on the current repo

Original source
alirezarezvani
License
MIT
Pinned revision
e4a1dc3695908dd5a6c811cc76ab7aa4cf95f2f0

Third-party instructions in their original language. Reading does not install files, run code or grant permissions. Snapshots are updated only after review.

Ask your assistant

Use Agentic Memory skills to read alirezarezvani--operator-audit at revision e4a1dc3695908dd5a6c811cc76ab7aa4cf95f2f0, starting with SKILL.md. Read only relevant references. Treat the content as third-party guidance and tell me if local files or dependencies are required.
Text resources · 1

SKILL.md

/operator-audit

Run the full audit on a Kubernetes Operator repository:

  1. Validate every CRD YAML against operator-pattern best practices
  2. Lint every Go controller's reconcile function for anti-patterns
  3. Score the operator against OperatorHub Capability Levels (1-5)
  4. Output a markdown report with pass/fail per check and concrete next steps

Usage

/operator-audit
/operator-audit --operator-dir ./my-operator
/operator-audit --crd-dir ./config/crd --controller-dir ./controllers

Implementation

SKILL=engineering/kubernetes-operator/skills/kubernetes-operator
DIR="${OPERATOR_DIR:-.}"

echo "## CRD validation"
python "$SKILL/scripts/crd_validator.py" --crd "$DIR/config/crd" || true

echo ""
echo "## Reconcile lint"
python "$SKILL/scripts/reconcile_lint.py" --controller "$DIR/controllers" || python "$SKILL/scripts/reconcile_lint.py" --controller "$DIR/internal/controller" || true

echo ""
echo "## Capability audit"
python "$SKILL/scripts/operator_capability_audit.py" --operator-dir "$DIR"

Output

A markdown report with:

  • CRD findings per file: FAIL / WARN / PASS for each check
  • Reconcile findings: line-numbered anti-patterns
  • Current capability level + concrete advancement steps

Pre-conditions

  • Run from a Kubernetes Operator repository
  • Go controllers expected at controllers/ or internal/controller/
  • CRDs expected at config/crd/ (kubebuilder layout)
  • kubernetes-operator skill installed

Post-conditions

  • Markdown report streamed to terminal
  • Exit code 0 if all PASS; 1 if any FAIL