# environment-setup

Разбирает конфигурацию приложения по полочкам: какие переменные держать в .env, что коммитить, как проверять обязательные значения и где граница с секретами.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 353 установки · ★ 50
- Автор: akillness
- Лицензия: не указана · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/akillness/jeo-skills/tree/HEAD/.agent-skills/environment-setup/SKILL.md
- Обновлён: 2026-10-24
- HTML: https://affpapa.org/nevibecode/skills/environment-setup

## Что делает

Скилл берётся за прикладную конфигурацию, а не за воспроизводимость всей машины. На входе он классифицирует задачу: структура env-файлов, валидация, передача секретов, разделение публичных и приватных значений, разъезд конфигов между local, staging, CI и production либо правила конкретного фреймворка. Дальше выбирается ровно один режим работы под эту задачу.

Результат — «Environment Config Brief»: рекомендованный режим, текущая картина конфигов, предлагаемая раскладка файлов, примеры проверок в bash и список мест, где легко ошибиться. Внутри скилла есть справочники `references/env-patterns.md` и `references/scope-boundaries.md` — их стоит открыть на нестандартных случаях. Разрешённые инструменты: Bash, Read, Write, Edit, Glob, Grep.

Границы жёсткие. Если настоящая проблема — тулчейны, Docker Compose, devcontainer или онбординг, скилл отправляет к `system-environment-setup`; за деплоем и CI-секретами — к `deployment-automation`, за архитектурой безопасности — к `security-best-practices`. Ждать от него инструкции по Docker не стоит: это не его работа.

## Требования
- Работает с: Docker

## Установка

### Claude Code (родная платформа)

1. **Через Skills CLI (Vercel)**
```bash
npx skills add akillness/jeo-skills --skill environment-setup -a claude-code
```

2. **Вручную: положить файлы**
- Файл: `~/.claude/skills/environment-setup/SKILL.md` — Папка скилла целиком; для одного проекта — .claude/skills/environment-setup/

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add akillness/jeo-skills --skill environment-setup -a codex
```

2. **Вручную: положить файлы**
- Файл: `.agents/skills/environment-setup/SKILL.md` — Для всех проектов — ~/.agents/skills/

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add akillness/jeo-skills --skill environment-setup -a cursor
```

2. **Вручную: положить файлы**
- Файл: `.cursor/skills/environment-setup/SKILL.md` — Cursor читает и .agents/skills/, и .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install akillness/jeo-skills environment-setup
```

2. **Вручную: положить файлы**
- Файл: `.github/skills/environment-setup/SKILL.md`

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add akillness/jeo-skills --skill environment-setup -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/akillness/jeo-skills --path .agent-skills/environment-setup
```

### Windsurf (Devin Desktop)

**Вручную: положить файлы**
- Файл: `.devin/skills/environment-setup/SKILL.md` — Старый путь .windsurf/skills/ тоже читается

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add akillness/jeo-skills --skill environment-setup -a opencode
```

### Claude.ai

**Claude.ai**
- Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/akillness/jeo-skills/tree/HEAD/.agent-skills/environment-setup/SKILL.md

## Когда брать
- разложить `.env.example` и `.env.local` так, чтобы новый разработчик не угадывал значения
- проверить обязательные переменные окружения до старта приложения
- отделить публичные переменные от серверных, чтобы клиентские значения не утекли в бандл
- свести к одному источнику правды шаблоны, переменные CI и документацию
- зафиксировать, откуда берётся каждый секрет: локальный файл, хранилище, CI или облако

## Примеры запросов агенту
- Помоги разложить `.env.example` и `.env.local`, чтобы новым разработчикам не приходилось угадывать значения
- Добавь типизированную проверку обязательных переменных окружения на старте приложения
- У нас конфиги local, staging и CI разошлись — найди расхождения и оставь один источник правды

## Похожие
- [wizard](https://affpapa.org/nevibecode/skills/wizard.md) — скилл · 553369 установок
- [hyperframes-cli](https://affpapa.org/nevibecode/skills/heygen-com-hyperframes-cli.md) — скилл · 1300000 установок
- [setup-pre-commit](https://affpapa.org/nevibecode/skills/setup-pre-commit.md) — скилл · 489289 установок
- [using-git-worktrees](https://affpapa.org/nevibecode/skills/using-git-worktrees.md) — скилл · 217153 установки
- [finishing-a-development-branch](https://affpapa.org/nevibecode/skills/finishing-a-development-branch.md) — скилл · 214439 установок
- [orca-cli](https://affpapa.org/nevibecode/skills/orca-cli.md) — скилл · 353600 установок

Из того же набора: [akillness/jeo-skills](https://affpapa.org/nevibecode/by/akillness/jeo-skills.md) — 29 карточек

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md