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.
- 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.
- 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.
- 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).
- 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.
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
- README.md at d7e7fa44 ↗Checked
https://github.com/Infisical/ai-skills/blob/d7e7fa443893d7ba10895f926407da27751ea096/README.md
Supports: install.command, install.sourceUrl, install.steps, compatibility, summary
- LICENSE at d7e7fa44 ↗Checked
https://github.com/Infisical/ai-skills/blob/d7e7fa443893d7ba10895f926407da27751ea096/LICENSE
Supports: license, publisher, access.cost
https://github.com/Infisical/ai-skills/blob/d7e7fa443893d7ba10895f926407da27751ea096/.claude-plugin/marketplace.json
Supports: install.steps
https://github.com/Infisical/ai-skills/tree/d7e7fa443893d7ba10895f926407da27751ea096/skills/infisical-agent
Supports: access.permissions, review.findings
https://github.com/Infisical/ai-skills/commit/da9176b6b14d73b6925464215aa310bb800643be
Supports: limitations