SECURITY / Infisical Inc.
Infisical API Skill
Infisical skill for calling the Infisical REST API directly: Universal Auth login, /api/v4/secrets CRUD and batch calls, projects and identities, pagination and rate limits.
“Interact with the Infisical REST API to manage secrets, projects, environments, machine identities, and more. Supports secret CRUD operations, machine identity authentication, pagination, and rate limiting on cloud deployments. Not for the CLI/SDKs (infisical-setup), KMS crypto endpoints (infisical-kms), certificate endpoints (infisical-pki), or human SSO login (infisical-sso).”
01 / THE REASONING
Why this made the selection.
- It states that /api/v4/secrets is not paginated and ignores offset and limit, while identities, memberships and certificates paginate and return { <resource>: [...], totalCount: n }.
- It gives the instance default rate limits, which apply to self-hosted too (60 reads/min, 200 writes/min, 60 secrets-ops/min, 60 auth/min per IP), and says to honour retry-after as seconds remaining.
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-api/SKILL.md
- README.md
- LICENSE
- .claude-plugin/marketplace.json
Our findings
- The quick start posts clientId and clientSecret to /api/v1/auth/universal-auth/login and sends the returned accessToken as a Bearer token.
- It says service tokens are deprecated in favour of machine identities.
- It says viewSecretValue defaults to true and can be set to false when only key names are needed.
Not established by this review
- Not executed: it was not installed or run.
- No Infisical API request was sent.
- references/authentication.md, references/secrets-endpoints.md, references/projects-and-identities.md and references/pagination-and-rate-limits.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-api 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-api as its own plugin (source ./infisical-api, 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-api/, 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-api.
Before you start
- A machine identity with Universal Auth, whose client ID and client secret the login call takes
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-api/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-api
Supports: access.permissions, review.findings
https://github.com/Infisical/ai-skills/commit/da9176b6b14d73b6925464215aa310bb800643be
Supports: limitations