← Explore all skills

CONTAINERS / Infisical Inc.

Infisical Kubernetes Operator Guide

Infisical skill for running the Infisical Kubernetes Operator: syncing secrets into Kubernetes Secrets and ConfigMaps, pushing secrets back to Infisical, and managing dynamic secret leases in-cluster.

“Guide for the Infisical Kubernetes Operator — syncing secrets from Infisical into Kubernetes Secrets and ConfigMaps, pushing secrets from Kubernetes to Infisical, and managing dynamic secret leases in-cluster. Covers the v1beta1 CRDs (InfisicalConnection, InfisicalAuth, InfisicalStaticSecret) and the legacy v1alpha1 CRDs (InfisicalSecret, InfisicalDynamicSecret, InfisicalPushSecret), Helm installation cluster-wide or namespace-scoped, all 7 operator auth methods, sources and targets, creationPolicy Owner vs Orphan, refreshInterval, the secrets.infisical.com/auto-reload annotation for automatic Deployment rollouts, and Go templating of rendered secrets. Use this skill when someone asks about: Infisical Kubernetes Operator, InfisicalSecret CRD, InfisicalStaticSecret, syncing Infisical secrets into a Kubernetes Secret, auto-reloading pods on secret change, pushing Kubernetes secrets to Infisical, or 'how do I get Infisical secrets into my Kubernetes cluster'. Not for self-hosting Infisical on Kubernetes (infisical-self-host) — that is a different Helm chart — nor for rendering secrets to files (infisical-agent).”

01 / THE REASONING

Why this made the selection.

  • It makes the agent establish the CRD API version first: v1beta1 splits the work into InfisicalConnection, InfisicalAuth and InfisicalStaticSecret, while legacy v1alpha1 puts it all in one InfisicalSecret.
  • It states that a synced Secret restarts nothing by itself and that dependent Deployments need the secrets.infisical.com/auto-reload: "true" annotation.

02 / THE REVIEW RECORD

What we actually inspected.

Source review has boundaries.
A clear record is more useful than a “safe” badge.

Material inspected

  • skills/infisical-kubernetes-operator/SKILL.md
  • skills/infisical-kubernetes-operator/references/install-and-auth.md
  • README.md
  • LICENSE
  • .claude-plugin/marketplace.json

Our findings

  • It says creationPolicy Owner ties the managed Secret to the CRD and Orphan leaves it behind on delete, and defaults to Owner.
  • It says never to put a client secret inline in a manifest; credentials go in a Kubernetes Secret that the CRD references.
  • The operator chart is secrets-operator from the same Cloudsmith Helm repository that holds the self-hosting chart.
  • It suggests External Secrets Operator, which has an Infisical provider, for users who already run it.

Not established by this review

  • Not executed: it was not installed or run.
  • No Helm chart was installed and no manifest was applied.
  • references/install-and-auth.md was read only in part (supported versions, Helm install and the start of the auth sections); references/syncing-secrets.md and references/dynamic-and-push.md were not read.

The review applies to the material and revision named here. A newer upstream release can change its behavior.

03 / PUT IT TO WORK

Add a skill to your workflow.

Upstream setup instructions ↗
  1. The README's universal install, npx skills add Infisical/ai-skills, names the whole Infisical/ai-skills repository, which the README says holds 17 skills; no file at the pin prints a line that installs infisical-kubernetes-operator alone.
  2. For Claude Code the README prints /plugin marketplace add Infisical/ai-skills. That adds the infisical-ai-skills marketplace, whose .claude-plugin/marketplace.json lists infisical-kubernetes-operator as its own plugin (source ./infisical-kubernetes-operator, plugin root ./plugins); no file at the pin prints the line that installs that plugin.
  3. For a manual install the README says to copy skill folders from skills/ into the agent's skills directory; for this skill that is skills/infisical-kubernetes-operator/, copied to .claude/skills/ (Claude Code), ~/.codex/skills/ (Codex), .cursor/skills/ or .agents/skills/ (Cursor), or .github/skills/ (GitHub Copilot).
  4. The README recommends Infisical's hosted docs MCP at https://infisical.com/docs/mcp ahead of the skills; that is a separate server and does not install infisical-kubernetes-operator.

Before you start

  • Kubernetes 1.29 to 1.33 for official support
  • Helm, with the chart repository https://dl.cloudsmith.io/public/infisical/helm-charts/helm/charts/

04 / FOLLOW THE EVIDENCE

The source trail.

Our notes are separate from the original resource.
Check upstream before adopting a new version.

  1. https://github.com/Infisical/ai-skills/blob/d7e7fa443893d7ba10895f926407da27751ea096/skills/infisical-kubernetes-operator/SKILL.md

    Supports: name, upstreamDescription, summary, whySelected, bestFor, limitations, review.findings, access.label, access.permissions, install.prerequisites

  2. https://github.com/Infisical/ai-skills/blob/d7e7fa443893d7ba10895f926407da27751ea096/skills/infisical-kubernetes-operator/references/install-and-auth.md

    Supports: limitations, install.prerequisites, access.permissions, review.findings

  3. README.md at d7e7fa44 ↗Checked

    https://github.com/Infisical/ai-skills/blob/d7e7fa443893d7ba10895f926407da27751ea096/README.md

    Supports: install.command, install.sourceUrl, install.steps, compatibility, summary

  4. LICENSE at d7e7fa44 ↗Checked

    https://github.com/Infisical/ai-skills/blob/d7e7fa443893d7ba10895f926407da27751ea096/LICENSE

    Supports: license, publisher, access.cost

  5. https://github.com/Infisical/ai-skills/blob/d7e7fa443893d7ba10895f926407da27751ea096/.claude-plugin/marketplace.json

    Supports: install.steps

  6. https://github.com/Infisical/ai-skills/tree/d7e7fa443893d7ba10895f926407da27751ea096/skills/infisical-kubernetes-operator

    Supports: access.permissions, review.findings

  7. https://github.com/Infisical/ai-skills/commit/da9176b6b14d73b6925464215aa310bb800643be

    Supports: limitations

Evidence & Ask