← Explore all skills

SECURITY / Infisical Inc.

Infisical Agent Guide

Infisical skill for configuring the Infisical Agent, a client daemon that authenticates, renews tokens and renders secrets into files through Go templates.

“Guide for configuring the Infisical Agent — a client daemon that manages token lifecycle and renders secrets via Go templates without modifying application code. Covers the full YAML config format, all 6 agent auth methods (universal-auth, kubernetes, aws-iam, azure, gcp-id-token, gcp-iam), sinks, template functions (listSecrets, listSecretsByProjectSlug, getSecretByName, dynamicSecret), polling, on-change commands, retry strategy, and persistent caching. Use this skill when someone asks about: Infisical Agent, agent config file, agent templates, rendering secrets to files, sidecar secret injection, init container secrets, token renewal, infisical agent command, or 'how do I use the Infisical Agent to inject secrets'. Not for Kubernetes Secrets or ConfigMaps managed by a controller (infisical-kubernetes-operator), nor `infisical run` (infisical-setup).”

01 / THE REASONING

Why this made the selection.

  • It covers the agent's YAML config, all 6 agent auth methods, sinks, polling and the template functions listSecrets, listSecretsByProjectSlug, getSecretByName and dynamicSecret.
  • It separates the agent from the Kubernetes Operator: the agent writes files next to the app, the operator manages Kubernetes API objects cluster-wide.

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-agent/SKILL.md
  • README.md
  • LICENSE
  • .claude-plugin/marketplace.json

Our findings

  • It recommends platform-native auth (aws-iam on AWS, kubernetes on Kubernetes, azure on Azure) and falls back to universal-auth only when none is available.
  • It says sinks deposit access tokens while templates render actual secrets, and that most users want templates.
  • It says SSH leases return PRIVATE_KEY and SIGNED_KEY, and that the default polling interval is 5 minutes.

Not established by this review

  • Not executed: it was not installed or run.
  • No agent config was rendered and no Infisical Agent was started.
  • references/agent-config.md, references/template-functions.md and references/deployment-examples.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-agent 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-agent as its own plugin (source ./infisical-agent, 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-agent/, 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-agent.

Before you start

  • A machine identity for the agent to authenticate with, configured through infisical-setup

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-agent/SKILL.md

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

  2. README.md at d7e7fa44 ↗Checked

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

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

  3. LICENSE at d7e7fa44 ↗Checked

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

    Supports: license, publisher, access.cost

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

    Supports: install.steps

  5. https://github.com/Infisical/ai-skills/tree/d7e7fa443893d7ba10895f926407da27751ea096/skills/infisical-agent

    Supports: access.permissions, review.findings

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

    Supports: limitations

Evidence & Ask