SECURITY / Infisical Inc.
Infisical Secret Rotation Guide
Infisical skill for rotating credentials that already exist in a third-party system on a fixed interval and writing the new values back into Infisical secrets.
“Guide for configuring Infisical Secret Rotation — automatically rotating credentials that already exist in a third-party system on a fixed interval, writing the new values back into Infisical secrets. Covers all 28 rotation providers (PostgreSQL, MySQL, MSSQL, OracleDB, MongoDB, Redis, AWS IAM user secrets, Azure/Okta/Auth0 client secrets, LDAP passwords, Unix/Linux and Windows local accounts, Cloudflare, Datadog, Snowflake key pairs, OpenAI/OpenRouter/LiteLLM/Fireworks API keys, and more), the dual-phase vs single-phase rotation models, rotation intervals and rotateAtUtc scheduling, parameters and secretsMapping, and the two-user pattern for SQL databases. Use this skill when someone asks about: secret rotation, rotating credentials, automatic credential rotation, rotating a database password on a schedule, expiring API keys, rotationInterval, or 'how do I rotate my database password automatically'. For changing an EXISTING credential on a timer. Not for creating brand-new ephemeral credentials per request (infisical-dynamic-secrets), nor for App Connection credential rotation (infisical-app-connections).”
01 / THE REASONING
Why this made the selection.
- It covers the rotation providers its description lists and makes the agent establish whether a provider is dual-phase or single-phase, because that changes the operational advice.
- It states that SQL rotations alternate between two pre-existing users, username1 and username2, with identical grants, which Infisical does not create.
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-secret-rotation/SKILL.md
- skills/infisical-secret-rotation/references/rotation-overview.md
- README.md
- LICENSE
- .claude-plugin/marketplace.json
Our findings
- Every rotation needs an App Connection of the type its provider fixes; a PostgreSQL rotation requires a postgres connection.
- It tells the agent never to generate rotated credentials and never to print secret values.
- It says rotationInterval is in days with a minimum of 1, not hours and not a cron string.
Not established by this review
- Not executed: it was not installed or run.
- No rotation was configured or triggered.
- references/rotation-overview.md was read only for its opening section; references/sql-databases.md, references/cloud-and-saas.md and references/machine-accounts.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-secret-rotation 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-secret-rotation as its own plugin (source ./infisical-secret-rotation, 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-secret-rotation/, 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-secret-rotation.
Before you start
- An Infisical plan that includes Secret Rotation (an Enterprise / paid feature)
- An App Connection of the type the rotation provider requires
- For SQL databases, two existing users with identical grants
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-secret-rotation/SKILL.md
Supports: name, upstreamDescription, summary, whySelected, bestFor, limitations, review.findings, access.label, access.permissions, install.prerequisites
https://github.com/Infisical/ai-skills/blob/d7e7fa443893d7ba10895f926407da27751ea096/skills/infisical-secret-rotation/references/rotation-overview.md
Supports: limitations, install.prerequisites, access.cost
- 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-secret-rotation
Supports: access.permissions, review.findings
https://github.com/Infisical/ai-skills/commit/da9176b6b14d73b6925464215aa310bb800643be
Supports: limitations