← Explore all skills

SECURITY / Infisical Inc.

Infisical App Connections Guide

Infisical skill for creating App Connections, the stored credentials Infisical uses to authenticate out to third-party services for secret syncs, rotations, PKI and secret scanning.

“Guide for creating and managing Infisical App Connections — the reusable authenticated links between Infisical and third-party services that Secret Syncs, Secret Rotations, PKI certificate authorities, PKI Syncs, and Secret Scanning data sources all depend on. Covers all 83 connection types and their exact auth methods (AWS assume-role vs access-key, GitHub OAuth vs GitHub App vs PAT, Azure OAuth vs client-secret vs certificate, GCP service account impersonation, and more), platform-managed credentials, Gateway-routed connections for private networks, and connection-level credential rotation. Use this skill when someone asks about: App Connections, connecting Infisical to AWS/GCP/Azure/GitHub, 'connection not found' when creating a sync, which auth method a connection needs, reusing a connection across syncs, or 'how do I authenticate Infisical to a third-party service'. This is Infisical authenticating OUTWARD to a third party. Not for machine identities, which are workloads authenticating INTO Infisical (infisical-setup).”

01 / THE REASONING

Why this made the selection.

  • Two of its reference files are generated from the Infisical source by tools/generate-app-connection-refs.py: the API surface, and the exact method values and credential fields for all 83 connections.
  • It separates the direction of trust: an App Connection lets Infisical authenticate out to a third party, a machine identity lets a workload authenticate into Infisical.

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

Our findings

  • It says auth method values are exact strings (assume-role, access-key, github-app, pat, client-secret, service-account-impersonation) and that near-misses such as access-keys or github_app fail validation.
  • It tells the agent never to generate credentials on the user's behalf and never to echo a credential back.
  • It says gatewayId and gatewayPoolId are mutually exclusive, and that a connection's third-party permissions bound what every consuming sync and rotation can do.

Not established by this review

  • Not executed: it was not installed or run.
  • No App Connection was created and no third-party credential was used.
  • None of the reference files was read, and tools/generate-app-connection-refs.py was not run.

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

Before you start

  • A credential or role on the third-party service, scoped to the minimum the consuming feature needs

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-app-connections/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-app-connections

    Supports: access.permissions, review.findings

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

    Supports: limitations

Evidence & Ask