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

secret-scanner — скилл для Claude Code: что делает и как установить

Скилл secret-scanner находит случайно вписанные пароли, токены и приватные ключи в коде до того, как они попадут в коммит или репозиторий.

MIT ★ 788 обновлён 2026-07-03

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

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

Скилл сканирует файлы при сохранении, изменении .env и перед созданием коммита в Git. Внутри используются встроенные инструменты чтения и поиска Read и Grep. Он умеет распознавать форматы ключей AWS, Stripe и GitHub, токены OAuth, строки подключения к базам данных, сертификаты и закрытые ключи SSH.

Кроме поиска по строкам, инструмент проверяет правила в .gitignore, чтобы незашифрованные конфиги не улетели в удалённый репозиторий. Тестовые фикстуры и примеры в документации он отличает от реальных секретов и отмечает пониженным приоритетом проверки.

Для работы скиллу нужен только доступ на чтение файловой системы: доступ в сеть полностью отключён, поэтому утилита безопасно работает в изолированном окружении.

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

  • перехватить захардкоженные API-ключи перед выполнением git commit
  • проверить добавление файлов с секретами и .env в .gitignore
  • заменить открытые пароли баз данных на переменные окружения
  • найти приватные ключи SSH и сертификаты в рабочей директории

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

  • Проверь проект перед коммитом на наличие забытых API-токенов
  • Посмотри docker-compose.yml и перенеси пароли в переменные окружения
  • Просканируй репозиторий на приватные ключи и проверь .gitignore

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

1Через Skills CLI (Vercel)

npx skills add alirezarezvani/claude-code-tresor --skill secret-scanner -a claude-code

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

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

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

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

Вопросы о secret-scanner

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

Выполните в терминале команду npx skills add alirezarezvani/claude-code-tresor --skill secret-scanner -a claude-code.

Что делает этот скилл?

Он перехватывает сохранение файлов и попытки коммита, ищет в кодовой базе забытые токены провайдеров, пароли и приватные ключи, а затем предлагает безопасные варианты замены.

Нужен ли скиллу выход в интернет?

Сетевой доступ не требуется. Скилл работает локально, используя только инструменты Read и Grep с правами на чтение файлов.

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

SKILL.md · MIT
---
name: secret-scanner
description: Detect exposed secrets, API keys, credentials, and tokens in code. Use before commits, on file saves, or when security is mentioned. Prevents accidental secret exposure. Triggers on file changes, git commits, security checks, .env file modifications.
allowed-tools: Read, Grep
---

# Secret Scanner Skill

Prevent accidental secret exposure in your codebase.

## When I Activate

- ✅ Before git commits
- ✅ Files modified/saved
- ✅ User mentions secrets, keys, or credentials
- ✅ .env files changed
- ✅ Configuration files modified

## What I Detect

### API Keys & Tokens
- AWS access keys (AKIA...)
- Stripe API keys (sk_live_..., pk_live_...)
- GitHub tokens (ghp_...)
- Google API keys
- OAuth tokens
- JWT secrets

### Database Credentials
- Database connection strings
- MySQL/PostgreSQL passwords
- MongoDB connection URIs
- Redis passwords

### Private Keys
- SSH private keys
- RSA/DSA keys
- PGP/GPG keys
- SSL certificates

### Authentication Secrets
- Password variables
- Auth tokens
- Session secrets
- Encryption keys

## Alert Examples

### API Key Detection
```javascript
// You type:
const apiKey = 'sk_live_1234567890abcdef';

// I immediately alert:
🚨 CRITICAL: Exposed Stripe API key detected!
📍 File: config.js, Line 3
🔧 Fix: Use environment variables
  const apiKey = process.env.STRIPE_API_KEY;
📖 Add to .gitignore: .env
```

### AWS Credentials
```python
# You type:
aws_access_key = "AKIAIOSFODNN7EXAMPLE"

# I alert:
🚨 CRITICAL: AWS access key exposed!
📍 File: aws_config.py, Line 1
🔧 Fix: Use AWS credentials file or environment variables
  aws_access_key = os.getenv("AWS_ACCESS_KEY_ID")
📖 Never commit AWS credentials
```

### Database Password
```yaml
# You type in docker-compose.yml:
environment:
  DB_PASSWORD: "mySecretPassword123"

# I alert:
🚨 CRITICAL: Database password in configuration file!
📍 File: docker-compose.yml, Line 5
🔧 Fix: Use .env file
  DB_PASSWORD: ${DB_PASSWORD}
📖 Add .env to .gitignore
```

## Detection Patterns

### Pattern Types

**High Confidence:**
- Known API key formats (Stripe, AWS, etc.)
- Private key headers
- JWT tokens
- Connection strings with credentials

**Medium Confidence:**
- Variables named "password", "secret", "key"
- Base64 encoded strings in sensitive contexts
- Long random strings in assignments

**Low Confidence (Flagged for Review):**
- Generic secret patterns
- Potential credentials in comments

## Git Integration

### Pre-Commit Protection

```bash
# Before commit, I scan:
git add .
git commit

# I block if secrets found:
🚨 CRITICAL: Cannot commit - secrets detected!
📍 3 secrets found:
  - config.js:12 - API key
  - .env:5 - Database password (in gitignore - OK)
  - auth.js:45 - JWT secret

❌ Commit blocked - remove secrets first
```

### .gitignore Validation

I check if sensitive files are in .gitignore:

```
✅ .env - In .gitignore (good)
⚠️ config/secrets.json - NOT in .gitignore (add it!)
✅ .aws/credentials - In .gitignore (good)
```

## False Positive Handling

### Example Files
```javascript
// I understand these are examples:
// Example: const apiKey = 'your_api_key_here';
// TODO: Add your API key from environment
```

### Test Files
```javascript
// Test fixtures are OK (but flagged for review):
const mockApiKey = 'sk_test_1234567890abcdef';  // ✅ Test key
```

### Documentation
```markdown
<!-- Documentation examples are flagged but low priority -->
Set your API key: `export API_KEY=your_key_here`
```

## Relationship with security-auditor

**secret-scanner (me):** Exposed secrets and credentials
**security-auditor:** Code vulnerability patterns

### Together
```
secret-scanner: Finds hardcoded API key
security-auditor: Finds how the key is used insecurely
Combined: Complete security picture
```

## Quick Fixes

### Move to Environment Variables

```javascript
// Before:
const apiKey = 'sk_live_abc123';

// After:
const apiKey = process.env.API_KEY;

// .env file (add to .gitignore):
API_KEY=sk_live_abc123
```

### Use Secret Management

```javascript
// AWS Secrets Manager
const AWS = require('aws-sdk');
const secrets = new AWS.SecretsManager();
const secret = await secrets.getSecretValue({ SecretId: 'myApiKey' }).promise();
```

### Configuration Files

```yaml
# docker-compose.yml
services:
  app:
    environment:
      - API_KEY=${API_KEY}  # From .env file

# .env (gitignored)
API_KEY=sk_live_abc123
```

## Sandboxing Compatibility

**Works without sandboxing:** ✅ Yes (recommended)
**Works with sandboxing:** ✅ Yes

- **Filesystem**: Read-only access
- **Network**: None required
- **Configuration**: None required

## Customization

Add company-specific secret patterns:

```bash
cp -r ~/.claude/skills/security/secret-scanner \
      ~/.claude/skills/security/company-secret-scanner

# Edit SKILL.md to add:
# - Internal API key formats
# - Company-specific secret patterns
# - Custom detection rules
```

## Best Practices

1. **Never commit secrets** - Use environment variables
2. **Use .gitignore** - Add .env, secrets.json, etc.
3. **Rotate exposed secrets** - If committed, rotate immediately
4. **Use secret management** - AWS Secrets Manager, HashiCorp Vault
5. **Audit regularly** - Review code for exposed secrets

## Emergency Response

### If Secret Committed

1. **Rotate the secret immediately**
2. **Remove from git history**
   ```bash
   git filter-branch --force --index-filter \
     "git rm --cached --ignore-unmatch config/secrets.json" \
     --prune-empty --tag-name-filter cat -- --all
   ```
3. **Force push** (coordinate with team)
4. **Update all deployments** with new secret

## Related Tools

- **security-auditor skill**: Vulnerability detection
- **@code-reviewer sub-agent**: Security review
- **/review command**: Comprehensive security check

© alirezarezvani · MIT · alirezarezvani/claude-code-tresor

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

Все скиллы по теме «Безопасность» →
encore-go-secret encoredev Скилл encore-go-secret для Claude Code подключает секреты Encore Go через поля package-level структуры secrets. Срабатывает для API-ключей и других приватных учётных данных. CX Codex +1 362установок secret-hygiene sentimony Скилл secret-hygiene держит значения ключей вне ответов агента: проверка по имени, вызов сервиса через хелпер, чистые логи и текст коммитов. CX Codex +1 2 200установок ghost-scan-secrets ghostsecurity Скилл ghost-scan-secrets ищет утёкшие API-ключи, токены и пароли в кодовой базе проекта. Пригодится перед коммитом или при аудите репозитория на скрытые секреты. CX Codex +1 4 900установок secret-vault mrhlaingbwardev Скилл secret-vault для Claude Code ищет ключи и токены на VPS, проверяет их и готовит отчёт. Ценные рабочие ключи попадают в отдельный файл для оператора. CX Codex +1 ★ 326звёзд репо n8n-credentials-and-security-official n8n-io Скилл n8n-credentials-and-security-official следит, чтобы ключи и токены в воркфлоу n8n шли через систему учётных данных, а не лежали текстом в нодах. CX Codex +1 2 500установок credentials google-deepmind Скилл credentials проверяет, есть ли нужный ключ в .env, и просит добавить его так, чтобы значение не попало в чат. CX Codex +1 1 600установок

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

Весь набор →
agent Промпт agent для инженера LLM-систем. Помогает писать и улучшать промпты для Claude, GPT и открытых моделей — от системных инструкций до chain-of-thought цепочек. GP ChatGPT ★ 788звёзд репо dependency-auditor Скилл dependency-auditor проверяет зависимости на уязвимости и проблемы с лицензиями, а затем предлагает варианты исправления. Запускайте проверку после изменений в файлах зависимостей или перед деплоем. CX Codex +1 ★ 788звёзд репо test-gen Команда test-gen пишет тесты к готовому коду: юнит-тесты функций, компонентные, интеграционные, e2e и тесты API. Фреймворк и порог покрытия задаются флагами. CX Codex +1 ★ 788звёзд репо api-documenter Скилл api-documenter для Claude Code собирает спецификации API по коду и комментариям. Формирует документацию при изменении маршрутов или подготовке OpenAPI-документа. CX Codex +1 ★ 788звёзд репо readme-updater Скилл readme-updater обновляет README автоматически, когда меняется структура проекта, добавляются зависимости или новые фичи. CX Codex +1 ★ 788звёзд репо test-generator Скилл test-generator генерирует базовые заготовки тестов для новых функций и React-компонентов под популярные тест-раннеры. CX Codex +1 ★ 788звёзд репо docs-gen Команда docs-gen анализирует кодовую базу и собирает API-документацию, руководства и справочные материалы. Подходит для генерации сайта документации и автодеплоя. CX Codex +1 ★ 788звёзд репо scaffold Команда scaffold генерирует каркас проекта или отдельного компонента: исходники, конфиги, тесты и документацию. Фреймворк и набор фич задаются флагами. CX Codex +1 ★ 788звёзд репо

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

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