infisical-secret-scanning — скилл для Claude Code
Скилл infisical-secret-scanning помогает найти утёкшие ключи в репозитории и поставить проверку до пуша: облачные источники, infisical scan, pre-commit хук.
MIT 254 установок ★ 41 обновлён 2026-10-19
npx skills add Infisical/ai-skills --skill infisical-secret-scanning -a claude-codeЧто делает infisical-secret-scanning
Скилл ведёт агента через настройку Infisical Secret Scanning, отдельного продукта со своим типом проекта secret-scanning. Внутри две половины. Облачные источники (GitHub, GitLab, Bitbucket) следят за подключёнными репозиториями и запускают сканирование на push, то есть находка появляется уже после утечки. CLI infisical scan проверяет локальные каталоги, историю Git, изменения в индексе и пайплайны — до пуша, если поставить хук или шаг в CI.
Ставится pre-commit хук командой infisical scan install --pre-commit-hook. Обойти его можно флагом --no-verify, поэтому его советуют подпирать сканированием в CI. Шум гасят через infisical-scan:ignore, файл .infisicalignore, пороги энтропии и свои правила; отключать правило целиком не стоит — вместе с шумом уходит и покрытие.
GitHub-сканирование требует подключения github-radar, а не github: это разные GitHub Apps с разными правами, и с обычным подключением настройка падает. Ещё в скилле есть AWS honey tokens — приманки, которые срабатывают, когда кто-то пробует украденный ключ. Порядок действий при находке: сначала ротация через infisical-secret-rotation, потом чистка истории. После пуша секрет уже скомпрометирован.
Какие задачи решает
- найти утёкшие ключи в истории Git раньше, чем их заметят снаружи
- поставить pre-commit хук, который ловит секрет до пуша
- подключить GitHub, GitLab или Bitbucket и включить сканирование на push
- убрать ложные срабатывания через
.infisicalignoreи пороги энтропии - развернуть приманку, которая сработает при использовании украденного ключа
Примеры запросов агенту
- Настрой pre-commit хук
infisical scan install --pre-commit-hookв этом репозитории и объясни, что именно он проверяет. - Просканируй историю Git на утёкшие креды и разложи находки по серьёзности.
- Слишком много ложных срабатываний в скане — покажи, как добавить исключения в
.infisicalignore.
Как установить infisical-secret-scanning
1Через Skills CLI (Vercel)
npx skills add Infisical/ai-skills --skill infisical-secret-scanning -a claude-code2Вручную: положить файлы
~/.claude/skills/infisical-secret-scanning/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/infisical-secret-scanning/
1Через Skills CLI (Vercel)
npx skills add Infisical/ai-skills --skill infisical-secret-scanning -a codex2Вручную: положить файлы
.agents/skills/infisical-secret-scanning/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add Infisical/ai-skills --skill infisical-secret-scanning -a cursor2Вручную: положить файлы
.cursor/skills/infisical-secret-scanning/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install Infisical/ai-skills skills/infisical-secret-scanning2Вручную: положить файлы
.github/skills/infisical-secret-scanning/SKILL.md1Через Skills CLI (Vercel)
npx skills add Infisical/ai-skills --skill infisical-secret-scanning -a gemini-cli2Командой платформы
gemini skills install https://github.com/Infisical/ai-skills --path skills/infisical-secret-scanningВручную: положить файлы
.devin/skills/infisical-secret-scanning/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add Infisical/ai-skills --skill infisical-secret-scanning -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы об infisical-secret-scanning
Как установить infisical-secret-scanning в Claude Code?
Выполните npx skills add Infisical/ai-skills --skill infisical-secret-scanning -a claude-code. Файл скилла появится по пути ~/.claude/skills/infisical-secret-scanning/SKILL.md.
Что делает infisical-secret-scanning?
Это гид по Infisical Secret Scanning: подключение облачных источников репозиториев, работа с CLI infisical scan, pre-commit хук и настройка подавления ложных срабатываний.
Почему сканирование GitHub не подключается?
Для GitHub нужно App Connection github-radar, а не github. Приложения ставятся с разными правами, и с обычным подключением сканирование не заработает.
Исходный текст
SKILL.md · MIT
--- name: infisical-secret-scanning description: "Guide for Infisical Secret Scanning — detecting leaked credentials in source code and developer systems. Covers the 3 cloud data sources (GitHub via a GitHub Radar connection, GitLab, Bitbucket), full scans vs automatic diff scans on push, finding lifecycle and severity, the `infisical scan` CLI for Git history, working directories, staged changes and CI pipelines, pre-commit hook installation with `infisical scan install --pre-commit-hook`, noise reduction via infisical-scan:ignore, .infisicalignore, entropy thresholds and custom rules, and AWS honey tokens as decoy credentials that alert on use. Use this skill when someone asks about: Infisical secret scanning, finding leaked secrets in a repo, scanning git history for credentials, pre-commit secret scanning, false positives in scanning, or honey tokens. Not for storing secrets so they stop leaking (infisical-setup) or rotating one that leaked (infisical-secret-rotation). GitHub scanning needs a github-radar App Connection, not a github one." --- # Infisical Secret Scanning Guide You are a setup assistant helping users detect leaked credentials in source code and respond when they find them. Secret Scanning is a **separate Infisical product** with its own project type (`secret-scanning`). ## Two halves that solve different problems Keep these distinct when advising: | Half | What it does | When it catches a leak | |------|-------------|------------------------| | **Cloud data sources** | Monitor connected GitHub/GitLab/Bitbucket repos | **After** the secret is pushed | | **CLI (`infisical scan`)** | Scan local directories, Git history, staged changes, CI | **Before** the push, if wired into a hook or pipeline | A user who only sets up data sources is detecting leaks after they exist. A user who only uses the CLI has no coverage of what is already in the repo. **Recommend both**: the CLI as a pre-commit hook to stop new leaks, and a data source to find existing ones and catch anything that bypasses the hook. ## Not this skill | If the user wants... | Use | |----------------------|-----| | To **store** secrets so they stop ending up in code | `infisical-setup` — the actual fix for leaks | | To **rotate** a credential that leaked | `infisical-secret-rotation` | | To **revoke** a leaked dynamic credential | `infisical-dynamic-secrets` | | To create the `github-radar` App Connection | `infisical-app-connections` | | Audit logs of Infisical activity | `infisical-access-control` | Worth raising unprompted: scanning is detection, not remediation. When a real finding turns up, the response is **rotate the credential first**, then clean the history. A secret in Git history is compromised even after the commit is removed, because it was already cloned. Point users at `infisical-secret-rotation` as part of the incident response, not as a separate conversation. ## Data sources `SecretScanningDataSource` values, and the App Connection each requires: | Data source | Value | App Connection | |-------------|-------|----------------| | GitHub | `github` | **`github-radar`** | | GitLab | `gitlab` | `gitlab` | | Bitbucket | `bitbucket` | `bitbucket` | **GitHub scanning needs a `github-radar` connection, not a `github` connection.** They install different GitHub Apps with different permissions — Radar needs to read repository contents and receive push webhooks. Using a `github` connection here fails. This is the most common setup error for this product. See `infisical-app-connections`. All three trigger automatic scans on **push**. ## How to use this skill 1. **Wire the CLI into pre-commit** so new leaks are stopped at the source 2. **Connect the data sources** for repositories that matter 3. **Run a full scan** to establish a baseline of what already exists 4. **Triage findings** — resolve, mark false positive, or ignore 5. **Tune to reduce noise** so the signal stays credible 6. **Enable automatic diff scans** for ongoing coverage 7. **Consider honey tokens** for detecting misuse rather than exposure ## Reference files | File | When to read | |------|-------------| | `references/scanning-and-findings.md` | Data source setup, scan types and statuses, finding lifecycle and severity, noise reduction | | `references/cli-and-honey-tokens.md` | `infisical scan` usage, pre-commit hooks, CI integration, AWS honey tokens | ## Guiding principles - **`github-radar`, not `github`.** Repeat it; it is the error users hit first. - **Rotate before cleaning history.** A leaked credential is compromised the moment it is pushed. Rewriting history does not un-leak it. - **False positives destroy the control.** A noisy scanner gets ignored, and then a real finding gets ignored too. Invest in ignore rules and entropy tuning early. - **Prefer `.infisicalignore` and `infisical-scan:ignore` over disabling rules.** Targeted suppressions keep coverage; disabled rules remove it silently. - **Pre-commit hooks are advisory, not enforcement.** They can be skipped with `--no-verify`. Back them with CI scanning that cannot be bypassed. - **Honey tokens detect a different thing.** Scanning finds secrets that leaked; honey tokens tell you someone is *using* stolen credentials. They complement each other. - **Never echo a discovered secret value** back to the user in full.
© Infisical · MIT · Infisical/ai-skills