К основному содержанию
скилл CX Codex

secrets-scanner — скилл для Claude Code: поиск утечек ключей

Скилл secrets-scanner для Claude Code ищет утёкшие ключи, токены и пароли в коде. Ставит проверки до коммита и в CI.

MIT 287 установок ★ 64 обновлён 2026-01-12

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add patricio0312rev/skills --skill secrets-scanner -a claude-code
Открыть на GitHub

Что делает secrets-scanner

Скилл ищет в коде ключи, токены, пароли и строки подключения к базе. Внутри — готовый .gitleaks.toml с правилами под AWS, GitHub, Slack, приватные ключи и общий шаблон api_key, плюс allowlist для node_modules/, .git/ и заглушек вроде your_api_key_here.

Дальше два уровня защиты. Локально это .pre-commit-config.yaml с хуками gitleaks и detect-secrets и отдельная проверка, которая валит коммит, если в индекс попал .env. В CI стоит workflow GitHub Actions: gitleaks и trufflehog с --only-verified. Хук detect-secrets читает baseline из .secrets.baseline: файла нет — проверка не пройдёт.

Есть и свой сканер на TypeScript: scripts/scan-secrets.ts рекурсивно обходит каталог, печатает файл, строку и severity, а на находках выходит с кодом 1. Плюс чек-лист на случай утечки: отозвать ключ, вычистить историю через BFG, уведомить команду.

Какие задачи решает

  • найти ключ AWS, случайно попавший в коммит
  • заблокировать коммит с .env до пуша
  • прогнать историю репозитория на токены GitHub и Slack
  • отозвать утёкший ключ и вычистить его из истории через BFG
  • добавить скан секретов в GitHub Actions

Примеры запросов агенту

  • Проверь репозиторий на утёкшие ключи и токены и покажи, где они лежат.
  • Настрой .pre-commit-config.yaml, чтобы коммит с .env не проходил.
  • Ключ AWS попал в историю — распиши шаги: отзыв, BFG, уведомление команды.

Как установить secrets-scanner

1Через Skills CLI (Vercel)

npx skills add patricio0312rev/skills --skill secrets-scanner -a claude-code

2Вручную: положить файлы

~/.claude/skills/secrets-scanner/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/secrets-scanner/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о secrets-scanner

Как установить secrets-scanner в Claude Code?

Выполните npx skills add patricio0312rev/skills --skill secrets-scanner -a claude-code. Скилл появится по пути ~/.claude/skills/secrets-scanner/SKILL.md.

Что делает secrets-scanner?

Ищет ключи, токены, пароли и строки подключения в коде, а рядом даёт готовые конфиги для pre-commit и GitHub Actions.

Что нужно, чтобы заработал хук detect-secrets?

Поставить pre-commit командой pip install pre-commit и завести .secrets.baseline: хук берёт baseline именно из этого файла.

Исходный текст

SKILL.md · MIT
---
name: secrets-scanner
description: Detects leaked API keys, tokens, passwords, and credentials in code with pre-commit hooks, CI checks, scanning rules, and remediation procedures. Use for "secret scanning", "credential detection", "API key leaks", or "secret management".
---

# Secrets Scanner

Detect and prevent leaked credentials in your codebase.

## Secret Detection Patterns

````yaml
# .gitleaks.toml
title = "Gitleaks Configuration"

[[rules]]
id = "aws-access-key"
description = "AWS Access Key"
regex = '''(A3T[A-Z0-9]|AKIA|AGPA|AIDA|AROA|AIPA|ANPA|ANVA|ASIA)[A-Z0-9]{16}'''
tags = ["key", "AWS"]

[[rules]]
id = "aws-secret-key"
description = "AWS Secret Key"
regex = '''(?i)aws(.{0,20})?(?-i)['\"][0-9a-zA-Z\/+]{40}['\"]'''
tags = ["key", "AWS"]

[[rules]]
id = "github-token"
description = "GitHub Personal Access Token"
regex = '''ghp_[0-9a-zA-Z]{36}'''
tags = ["key", "GitHub"]

[[rules]]
id = "github-oauth"
description = "GitHub OAuth Token"
regex = '''gho_[0-9a-zA-Z]{36}'''
tags = ["key", "GitHub"]

[[rules]]
id = "slack-webhook"
description = "Slack Webhook URL"
regex = '''https://hooks\.slack\.com/services/T[a-zA-Z0-9_]{8,10}/B[a-zA-Z0-9_]{8,10}/[a-zA-Z0-9_]{24}'''
tags = ["webhook", "Slack"]

[[rules]]
id = "private-key"
description = "Private Key"
regex = '''-----BEGIN (RSA|OPENSSH|DSA|EC|PGP) PRIVATE KEY-----'''
tags = ["key", "private"]

[[rules]]
id = "generic-api-key"
description = "Generic API Key"
regex = '''(?i)(api[_-]?key|apikey|access[_-]?key)(.{0,20})?['"][0-9a-zA-Z]{32,}['"]'''
tags = ["key", "generic"]

[[rules]]
id = "database-connection"
description = "Database Connection String"
regex = '''(?i)(postgresql|mysql|mongodb):\/\/[^\s:]+:[^\s@]+@[^\s\/]+'''
tags = ["database", "credentials"]

[allowlist]
description = "Allowlist"
paths = [
  '''node_modules/''',
  '''\.git/''',
  '''\.lock$''',
]

regexes = [
  '''EXAMPLE_KEY_123''',
  '''your_api_key_here''',
  '''<API_KEY>''',
]

## Pre-commit Hook Setup

```yaml
# .pre-commit-config.yaml
repos:
  - repo: https://github.com/gitleaks/gitleaks
    rev: v8.18.0
    hooks:
      - id: gitleaks

  - repo: https://github.com/Yelp/detect-secrets
    rev: v1.4.0
    hooks:
      - id: detect-secrets
        args: ['--baseline', '.secrets.baseline']

  - repo: local
    hooks:
      - id: check-env-files
        name: Check for .env files
        entry: bash -c 'if git diff --cached --name-only | grep -E "\.env$"; then echo "❌ .env file detected! Add to .gitignore"; exit 1; fi'
        language: system
        pass_filenames: false
````

```bash
# Install pre-commit
pip install pre-commit

# Install hooks
pre-commit install

# Run on all files
pre-commit run --all-files
```

## CI Integration

```yaml
# .github/workflows/secrets-scan.yml
name: Secrets Scan

on:
  push:
    branches: [main, develop]
  pull_request:
    branches: [main, develop]

jobs:
  gitleaks:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
        with:
          fetch-depth: 0 # Full history for scanning

      - name: Run Gitleaks
        uses: gitleaks/gitleaks-action@v2
        env:
          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
          GITLEAKS_LICENSE: ${{ secrets.GITLEAKS_LICENSE }}

  trufflehog:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
        with:
          fetch-depth: 0

      - name: TruffleHog OSS
        uses: trufflesecurity/trufflehog@main
        with:
          path: ./
          base: ${{ github.event.repository.default_branch }}
          head: HEAD
          extra_args: --debug --only-verified
```

## Custom Secret Scanner

```typescript
// scripts/scan-secrets.ts
import * as fs from "fs";
import * as path from "path";

interface SecretPattern {
  name: string;
  regex: RegExp;
  severity: "critical" | "high" | "medium";
}

const SECRET_PATTERNS: SecretPattern[] = [
  {
    name: "AWS Access Key",
    regex: /(A3T[A-Z0-9]|AKIA|AGPA|AIDA|AROA|AIPA|ANPA|ANVA|ASIA)[A-Z0-9]{16}/g,
    severity: "critical",
  },
  {
    name: "Private Key",
    regex: /-----BEGIN (RSA|OPENSSH|DSA|EC|PGP) PRIVATE KEY-----/g,
    severity: "critical",
  },
  {
    name: "Generic API Key",
    regex:
      /['"]?[a-zA-Z0-9_-]*api[_-]?key['"]?\s*[:=]\s*['"][a-zA-Z0-9]{32,}['"]/gi,
    severity: "high",
  },
  {
    name: "Database URL",
    regex: /(postgresql|mysql|mongodb):\/\/[^\s:]+:[^\s@]+@[^\s\/]+/gi,
    severity: "critical",
  },
  {
    name: "JWT Token",
    regex: /eyJ[a-zA-Z0-9_-]*\.eyJ[a-zA-Z0-9_-]*\.[a-zA-Z0-9_-]*/g,
    severity: "high",
  },
];

interface SecretFinding {
  file: string;
  line: number;
  column: number;
  pattern: string;
  match: string;
  severity: string;
}

function scanFile(filePath: string): SecretFinding[] {
  const findings: SecretFinding[] = [];
  const content = fs.readFileSync(filePath, "utf-8");
  const lines = content.split("\n");

  lines.forEach((line, lineIndex) => {
    SECRET_PATTERNS.forEach((pattern) => {
      const matches = line.matchAll(pattern.regex);

      for (const match of matches) {
        findings.push({
          file: filePath,
          line: lineIndex + 1,
          column: match.index || 0,
          pattern: pattern.name,
          match: match[0].substring(0, 50) + "...",
          severity: pattern.severity,
        });
      }
    });
  });

  return findings;
}

function scanDirectory(dir: string): SecretFinding[] {
  const findings: SecretFinding[] = [];
  const files = fs.readdirSync(dir, { withFileTypes: true });

  const ignorePaths = ["node_modules", ".git", "dist", "build"];

  files.forEach((file) => {
    const fullPath = path.join(dir, file.name);

    if (file.isDirectory() && !ignorePaths.includes(file.name)) {
      findings.push(...scanDirectory(fullPath));
    } else if (file.isFile()) {
      findings.push(...scanFile(fullPath));
    }
  });

  return findings;
}

// Run scan
const findings = scanDirectory("./src");

if (findings.length > 0) {
  console.error("🚨 Secrets detected!\n");

  findings.forEach((f) => {
    console.error(
      `[${f.severity.toUpperCase()}] ${f.file}:${f.line}:${f.column}`
    );
    console.error(`  Pattern: ${f.pattern}`);
    console.error(`  Match: ${f.match}\n`);
  });

  process.exit(1);
} else {
  console.log("✅ No secrets detected");
}
```

## Remediation Steps

````markdown
# Secret Leak Remediation Checklist

## Immediate Actions (< 1 hour)

1. **Revoke the compromised secret**

   - [ ] Deactivate API key/token immediately
   - [ ] Rotate credentials in production
   - [ ] Update all services using the secret

2. **Remove from git history**

   ```bash
   # Using BFG Repo-Cleaner
   bfg --replace-text secrets.txt repo.git
   git reflog expire --expire=now --all
   git gc --prune=now --aggressive

   # Force push (requires team coordination)
   git push --force --all
   ```
````

3. **Notify stakeholders**
   - [ ] Security team
   - [ ] DevOps team
   - [ ] Service owners
   - [ ] Management (if public repo)

## Short-term Actions (< 24 hours)

4. **Audit access logs**

   - [ ] Check CloudWatch/CloudTrail for suspicious activity
   - [ ] Review API usage for unauthorized access
   - [ ] Check for data exfiltration

5. **Update secret management**

   - [ ] Store in vault (AWS Secrets Manager, HashiCorp Vault)
   - [ ] Use environment variables
   - [ ] Remove hardcoded secrets

6. **Add scanning**
   - [ ] Install pre-commit hooks
   - [ ] Add CI secret scanning
   - [ ] Set up monitoring alerts

## Long-term Actions (< 1 week)

7. **Review and improve**
   - [ ] Conduct security training
   - [ ] Update secret management policies
   - [ ] Implement secret rotation schedule
   - [ ] Document incident and lessons learned

````

## Secret Management Best Practices

```typescript
// ❌ BAD: Hardcoded secrets
const API_KEY = 'sk_live_abc123xyz789';
const db = connect('mongodb://admin:password@localhost');

// ✅ GOOD: Environment variables
const API_KEY = process.env.API_KEY;
const db = connect(process.env.DATABASE_URL);

// ✅ BETTER: Secret management service
import { SecretsManagerClient, GetSecretValueCommand } from '@aws-sdk/client-secrets-manager';

async function getSecret(secretName: string): Promise<string> {
  const client = new SecretsManagerClient({ region: 'us-east-1' });
  const response = await client.send(
    new GetSecretValueCommand({ SecretId: secretName })
  );
  return response.SecretString!;
}

const apiKey = await getSecret('prod/api/stripe-key');
````

## GitHub Secret Scanning

```yaml
# Enable GitHub secret scanning (Enterprise)
# Settings → Security & analysis → Secret scanning

# Configure custom patterns
# .github/secret_scanning.yml
patterns:
  - name: Company API Key
    pattern: "company_[a-zA-Z0-9]{32}"
    secret_type: company_api_key
```

## Environment Variable Validation

```typescript
// config/env-validation.ts
import { z } from "zod";

const envSchema = z
  .object({
    NODE_ENV: z.enum(["development", "production", "test"]),
    DATABASE_URL: z.string().url(),
    API_KEY: z.string().min(32),
    JWT_SECRET: z.string().min(64),
    // Never allow default/example values in production
  })
  .refine((env) => {
    if (env.NODE_ENV === "production") {
      const invalidValues = ["example", "test", "localhost", "changeme"];
      return !invalidValues.some((val) =>
        Object.values(env).some((envVal) =>
          String(envVal).toLowerCase().includes(val)
        )
      );
    }
    return true;
  }, "Production environment cannot use example/test values");

// Validate on startup
try {
  envSchema.parse(process.env);
} catch (error) {
  console.error("❌ Invalid environment configuration:", error);
  process.exit(1);
}
```

## Monitoring & Alerts

```typescript
// monitoring/secret-monitoring.ts
import {
  CloudWatchClient,
  PutMetricDataCommand,
} from "@aws-sdk/client-cloudwatch";

async function monitorSecretUsage(secretName: string) {
  const cloudwatch = new CloudWatchClient();

  await cloudwatch.send(
    new PutMetricDataCommand({
      Namespace: "Security/Secrets",
      MetricData: [
        {
          MetricName: "SecretAccess",
          Value: 1,
          Unit: "Count",
          Dimensions: [
            {
              Name: "SecretName",
              Value: secretName,
            },
          ],
        },
      ],
    })
  );
}

// Alert on unusual secret access patterns
```

## Best Practices

1. **Never commit secrets**: Use .gitignore for .env files
2. **Use secret managers**: AWS Secrets Manager, Vault
3. **Rotate regularly**: 90-day rotation policy
4. **Scan continuously**: Pre-commit + CI + scheduled scans
5. **Least privilege**: Minimal secret access
6. **Audit logs**: Track secret access
7. **Incident response**: Have remediation playbook ready

## Output Checklist

- [ ] Gitleaks configuration created
- [ ] Pre-commit hooks installed
- [ ] CI secret scanning configured
- [ ] Custom scanner implemented (optional)
- [ ] Remediation playbook documented
- [ ] Secret management best practices
- [ ] Environment validation
- [ ] Monitoring and alerts
- [ ] .gitignore includes .env files
- [ ] Team trained on secret handling

© patricio0312rev · MIT · patricio0312rev/skills

Похожие скиллы

Все скиллы по теме «Безопасность» →
secrets-in-git-history UseOSINT Скилл secrets-in-git-history учит агента искать ключи, токены и адреса в истории git и на GitHub, а не только в текущем коде. CX Codex +1 1 900установок secrets-scan OWASP Скилл secrets-scan ищет захардкоженные пароли, API-ключи и токены в коде и конфигах — до коммита или при аудите репозитория. CX Codex +1 427установок implementing-secret-scanning-with-gitleaks mahipal Скилл implementing-secret-scanning-with-gitleaks для Claude Code, Codex, Cursor, GitHub Copilot и Gemini CLI учит агента настраивать Gitleaks для поиска захардкоженных секретов в git-репозитории. CX Codex +1 577установок secrets-audit briiirussell Скилл secrets-audit находит утечки токенов и паролей в коде, истории Git и сборках, а также проверяет правила хранения секретов. CX Codex +1 594установок secrets-management sickn33 Скилл secrets-management проводит агента по работе с секретами в CI/CD: выбор хранилища, короткоживущие identity, ротация и проверка, что значения не утекли в логи и артефакты. CX Codex +1 ★ 50 109звёзд репо Secrets Management taste f Промпт Secrets Management taste для ChatGPT задаёт стандарты безопасного обращения с секретами и ключами в инфраструктуре. GP ChatGPT ★ 178 201звёзд репо

Из того же набора148

Весь набор →
agent-orchestration-planner Скилл agent-orchestration-planner для проектирования многошаговых агентов: цикл с инструментами, повторные попытки, память и лимит расходов в виде готовых схем на Python. CX Codex +1 288установок react-server-components Помогает проектировать архитектуру React Server Components в Next.js App Router, разделять серверный и клиентский код, настраивать выборку данных и стриминг через Suspense. CX Codex +1 288установок github-actions-pipeline-creator Скилл github-actions-pipeline-creator для Claude Code собирает GitHub Actions workflow для линтинга, тестов, сборки и деплоя. Описывает CI с кэшем, матрицей и артефактами. CX Codex +1 288установок webhook-receiver-hardener Скилл webhook-receiver-hardener помогает проектировать защищённые эндпоинты для вебхуков. Защищает обработчики от подделки запросов, повторных доставок и сбоев сторонних сервисов. CX Codex +1 287установок project-scaffolder Скилл project-scaffolder разворачивает стартовые репозитории под популярные фреймворки с настроенным линтингом, тестовым эндпоинтом и документацией по запуску. CX Codex +1 287установок background-jobs-designer Скилл background-jobs-designer для Claude Code проектирует очереди фоновых задач, повторы и мониторинг. Описывает работу с BullMQ, Celery и асинхронными воркерами. CX Codex +1 286установок adr-writer Скилл adr-writer для Claude Code оформляет архитектурные решения в ADR: фиксирует контекст, выбранный вариант, альтернативы, компромиссы и последствия. Структурирует командные решения. CX Codex +1 286установок quality-gates-enforcer Скилл quality-gates-enforcer внедряет в CI пороги качества кода: следит за покрытием тестами, типами TypeScript, линтингом, безопасностью и размером сборки. CX Codex +1 284установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой