← Explore all skills

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.

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-api 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-api as its own plugin (source ./infisical-api, 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-api/, 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-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.

  1. 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

  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-api

    Supports: access.permissions, review.findings

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

    Supports: limitations

Evidence & Ask