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

doppler-secret-validation — скилл для Claude Code: проверка секретов

Скилл doppler-secret-validation помогает добавить секреты в Doppler, проверить их хранение и протестировать API-аутентификацию. Пригодится перед тем, как использовать токен в проекте.

MIT 135 установок ★ 3 обновлён 2026-10-25

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

Что делает doppler-secret-validation

Скилл проверяет формат токена до сохранения, добавляет секрет в указанный проект и конфигурацию Doppler, а затем запускает проверку хранения и извлечения. Скрипт scripts/validate_secret.py также проверяет передачу секрета через doppler run. Для теста API есть scripts/test_api_auth.py, который можно адаптировать под нужный API.

Секрет добавляют командой doppler secrets set SECRET_NAME="value" --project PROJECT --config CONFIG. Для локальной разработки можно привязать каталог командой doppler setup, после чего запускать doppler run без параметров проекта и конфигурации. Скилл советует не выводить секрет целиком и ограничивать его область действия одной командой через doppler run.

Для работы нужны Doppler CLI и доступ к проекту Doppler. Команда CLI не поддерживает --note, поэтому заметку к секрету добавляют через панель Doppler. GitHub-токены — исключение: скилл запрещает передавать GH_TOKEN и GITHUB_TOKEN из Doppler в каталог.

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

  • проверить формат токена перед сохранением
  • добавить секрет в проект и конфигурацию Doppler
  • убедиться, что секрет извлекается и передаётся через doppler run
  • проверить API-аутентификацию с сохранённым токеном
  • сверить секрет между конфигурациями dev, stg и prd

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

  • Проверь формат этого токена и добавь его в Doppler для проекта private-config, конфигурация prd.
  • Убедись, что PYPI_TOKEN извлекается из Doppler и передаётся через doppler run.
  • Проверь аутентификацию API с секретом PYPI_TOKEN и адресом https://upload.pypi.org/legacy/.

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

1Через Skills CLI (Vercel)

npx skills add terrylica/cc-skills --skill doppler-secret-validation -a claude-code

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

~/.claude/skills/doppler-secret-validation/SKILL.md

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

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

Вопросы о doppler-secret-validation

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

Выполните npx skills add terrylica/cc-skills --skill doppler-secret-validation -a claude-code. Файл скилла находится по пути ~/.claude/skills/doppler-secret-validation/SKILL.md.

Что делает doppler-secret-validation?

Скилл помогает сохранить секрет в Doppler, проверить его хранение и извлечение, а также протестировать API-аутентификацию.

Что нужно для проверки секрета?

Нужны Doppler CLI и доступ к проекту и конфигурации, где хранится секрет. Для API-проверки используется scripts/test_api_auth.py, который адаптируют под конкретный API.

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

SKILL.md · MIT
---
name: doppler-secret-validation
description: Validate and test Doppler secrets. TRIGGERS - add to Doppler, store secret, validate token, test credentials.
allowed-tools: Read, Bash
---

# Doppler Secret Validation

> **Self-Evolving Skill**: This skill improves through use. If instructions are wrong, parameters drifted, or a workaround was needed — fix this file immediately, don't defer. Only update for real, reproducible issues.

## Overview

Workflow for securely adding, validating, and testing API tokens and credentials in Doppler secrets management.

## When to Use This Skill

Use this skill when:

- User provides API tokens or credentials (PyPI, GitHub, AWS, etc.)
- User mentions "add to Doppler", "store secret", "validate token"
- User wants to test authentication before production use
- User needs to verify secret storage and retrieval

## Workflow

### Step 1: Test Token Format (Before Adding to Doppler)

Before storing in Doppler, validate token format:

```bash
# Check token format, length, prefix
python3 -c "token = 'TOKEN_VALUE'; print(f'Prefix: {token[:20]}...'); print(f'Length: {len(token)}')"
```

**Common token formats**:

- PyPI: `pypi-...` (179 chars)
- GitHub: `ghp_...` (40+ chars)
- AWS: 20-char access key + 40-char secret

### Step 2: Add Secret to Doppler

```bash
doppler secrets set SECRET_NAME="value" --project PROJECT --config CONFIG
```

**Example**:

```bash
doppler secrets set PYPI_TOKEN="pypi-AgEI..." \
  --project private-config --config prd
```

**Important**: CLI doesn't support `--note`. Add notes via dashboard:

1. <https://dashboard.doppler.com>
2. Navigate: PROJECT → CONFIG → SECRET_NAME
3. Edit → Add descriptive note

### Step 3: Validate Storage

Use the bundled validation script:

```bash
/usr/bin/env bash << 'VALIDATE_EOF'
ROOT="$(cc-plugin-root devops-tools)"
cd "$ROOT/skills/doppler-secret-validation"
uv run scripts/validate_secret.py \
  --project PROJECT \
  --config CONFIG \
  --secret SECRET_NAME
VALIDATE_EOF
```

This validates:

1. Secret exists in Doppler
2. Secret retrieval works
3. Environment injection works via `doppler run`

**Example**:

```bash
uv run scripts/validate_secret.py \
  --project private-config \
  --config prd \
  --secret PYPI_TOKEN
```

### Step 4: Test API Authentication

Use the bundled auth test script (adapt test_api_authentication() for specific API):

```bash
/usr/bin/env bash << 'CONFIG_EOF'
ROOT="$(cc-plugin-root devops-tools)"
doppler run --project PROJECT --config CONFIG -- \
  "$ROOT/skills/doppler-secret-validation/scripts/test_api_auth.py" \
    --secret SECRET_NAME \
    --api-url API_ENDPOINT
CONFIG_EOF
```

**Example (PyPI)**:

```bash
doppler run --project private-config --config prd -- \
  uv run scripts/test_api_auth.py \
    --secret PYPI_TOKEN \
    --api-url https://upload.pypi.org/legacy/
```

### Step 5: Document Usage

After validation, document the usage pattern for the user:

```bash
/usr/bin/env bash << 'CONFIG_EOF_2'
# Pattern 1: Doppler run (recommended for CI/scripts)
doppler run --project PROJECT --config CONFIG -- COMMAND

# Pattern 2: Manual export (for troubleshooting)
export SECRET_NAME=$(doppler secrets get SECRET_NAME \
  --project PROJECT --config CONFIG --plain)
CONFIG_EOF_2
```

### Step 5b: Directory-Scoped Doppler Config (Local Development)

For per-directory credentials, bind the directory to a Doppler project/config once with `doppler setup`; every later `doppler run` in that directory picks it up without `--project`/`--config`:

```bash
cd ~/project && doppler setup --project myproject --config prd --no-interactive
doppler run -- COMMAND
```

**GitHub tokens are the exception**: do not inject `GH_TOKEN`/`GITHUB_TOKEN` from Doppler into a directory (ADR 2026-06-21). GitHub multi-account auth is driven by the repo's `origin` host-alias, and a token resolves fresh per-repo via `~/.claude/tools/bin/gh-token-for-repo`.

## Common Patterns

### Multiple Configs (dev, stg, prd)

Add secret to multiple environments:

```bash
# Production
doppler secrets set TOKEN="prod-value" --project foo --config prd

# Development
doppler secrets set TOKEN="dev-value" --project foo --config dev
```

### Verify Secret Across Configs

```bash
/usr/bin/env bash << 'CONFIG_EOF_3'
for config in dev stg prd; do
  echo "=== $config ==="
  doppler secrets get TOKEN --project foo --config $config --plain | head -c 20
  echo "..."
done
CONFIG_EOF_3
```

## Security Guidelines

1. **Never log full secrets**: Use `${SECRET:0:20}...` masking
2. **Prefer doppler run**: Scopes secrets to single command
3. **Use --plain only for piping**: Human-readable view masks secrets
4. **Separate configs per environment**: dev/stg/prd isolation

## Bundled Resources

- **scripts/validate_secret.py** - Complete validation suite (existence, retrieval, injection)
- **scripts/test_api_auth.py** - Template for API authentication testing
- **references/doppler-patterns.md** - Common CLI patterns and examples

## Reference

- Doppler docs: <https://docs.doppler.com/docs>
- CLI install: `brew install dopplerhq/cli/doppler`
- See [doppler-patterns.md](./references/doppler-patterns.md) for comprehensive patterns

---

## Troubleshooting

| Issue                       | Cause                          | Solution                                                                                    |
| --------------------------- | ------------------------------ | ------------------------------------------------------------------------------------------- |
| Secret not found            | Wrong project/config specified | Verify with `doppler secrets ls --project X --config`                                       |
| Auth test fails with 401    | Token expired or invalid       | Regenerate token, re-add to Doppler                                                         |
| doppler run hangs           | CLI waiting for input          | Add `--no-interactive` flag                                                                 |
| Token prefix mismatch       | Wrong token type used          | Check expected format (pypi-, ghp-, AKIA, etc.)                                             |
| Validation script not found | Wrong directory context        | Use `cc-plugin-root devops-tools` to find the plugin root, then `cd` to the skill directory |
| Secret retrieval empty      | Secret name typo               | List secrets: `doppler secrets ls --project X`                                              |
| Multiple configs confusion  | Secrets differ across envs     | Use explicit --config flag for each command                                                 |

## Post-Execution Reflection

After this skill completes, reflect before closing the task:

0. **Locate yourself.** — Find this SKILL.md's canonical path before editing.
1. **What failed?** — Fix the instruction that caused it.
2. **What worked better than expected?** — Promote to recommended practice.
3. **What drifted?** — Fix any script, reference, or dependency that no longer matches reality.
4. **Log it.** — Evolution-log entry with trigger, fix, and evidence.

Do NOT defer. The next invocation inherits whatever you leave behind.

© terrylica · MIT · terrylica/cc-skills

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

Все скиллы по теме «DevOps и инфраструктура» →
doppler-wasp-drone Legion Code Inc. Субагент doppler-wasp-drone для настройки Doppler, синхронизации секретов с Vercel, ротации ключей и интеграции с GitHub Actions. Помогает заменить .env на централизованное хранилище и проводить ревью доступов. CX Codex ★ 96звёзд репо secure-secret-drop moeadham Скилл secure-secret-drop для Claude Code, Codex, Cursor и других платформ создаёт временный публичный URL через Cloudflare Quick Tunnel, чтобы передать пароль или API-ключ агенту без указания их в чате. CX Codex +1 6 800установок infisical-secret-syncs Infisical Скилл infisical-secret-syncs для Claude Code помогает настроить отправку секретов из Infisical во внешние сервисы. Настраивает синхронизацию с AWS, GitHub, Vercel и другими направлениями. CX Codex +1 1 000установок encore-secret encoredev Скилл encore-secret помогает хранить API-ключи и другие секреты в Encore.ts. Он подсказывает, как объявлять, читать и задавать значения по окружениям. CX Codex +1 477установок infisical-secret-rotation Infisical Скилл infisical-secret-rotation помогает настроить регулярную смену существующих паролей и ключей в Infisical с записью новых значений в хранилище. CX Codex +1 255установок alibabacloud-kms-secret-manage aliyun Скилл alibabacloud-kms-secret-manage помогает управлять секретами в Alibaba Cloud KMS через Aliyun CLI: создание, чтение версий, обновление и безопасное удаление. CX Codex +1 225установок

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

Весь набор →
gmail-access Скилл gmail-access для Claude Code подключает Gmail через CLI: читает и ищет письма, выгружает результаты и создаёт черновики. Даёт доступ к переписке в ходе работы над проектом. CX Codex +1 137установок skill-architecture Скилл skill-architecture помогает создавать и менять скиллы, разбираться в YAML и проверять структуру файлов. Внутри — шаблоны задач и рекомендации по устройству скиллов. CX Codex +1 137установок slash-command-factory Скилл slash-command-factory задаёт 5–7 вопросов и создаёт файлы слэш-команд для Claude Code с проверенным синтаксисом YAML и правами на подкоманды. CX Codex +1 136установок backtesting-py-oracle Скилл backtesting-py-oracle настраивает backtesting.py для сверки торговых сигналов с расчётами в ClickHouse SQL. Помогает устранить расхождения в сделках при тестировании паттернов на рендж-барах. CX Codex +1 135установок link-validation Скилл link-validation проверяет ссылки в markdown-файлах проекта офлайн через lychee: относительные пути, корневые пути и якоря. Пригодится перед коммитом документации. CX Codex +1 135установок session-recovery Скилл session-recovery диагностирует и восстанавливает потерянные сессии Claude Code, если команда claude -r не находит историю диалогов или файлы пишутся не туда. CX Codex +1 135установок session-chronicle Скилл session-chronicle для Claude Code связывает находки, решения и изменения в коде с сессиями и их UUID. Ищет происхождение решений и готовит записи о сессиях. CX Codex +1 135установок notion-sdk Скилл notion-sdk для Claude Code и Codex, работает с Notion через официальный Python SDK. Создаёт страницы и базы данных, запрашивает информацию, добавляет блоки контента — всё программно, без ручного ввода. CX Codex +1 133установок

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

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