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

pl-env — скилл для Claude Code: проверка среды и установка

Скилл pl-env для Claude Code проверяет окружение проекта и помогает разбирать блокеры перед запуском тестов или работы с VM. Скилл подключает только основной pl по своей таблице маршрутизации.

Apache-2.0 ★ 869 обновлён 2026-11-16

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

Что делает pl-env

Скилл проверяет доступность сервисов и ресурсов, состояние зависимостей, рабочей области и учётных данных. Основной pl вызывает его при сомнениях в окружении, запросе на перезапуск, вопросах о VM или перед оценочным и end-to-end запуском. Напрямую скилл не вызывают.

Для проверок используются скрипты general-env-doctor.sh и docker-env-doctor.sh. Первый ищет секрет по имени, проверяет хосты из реестра и состояние окружения; второй управляет проверкой и перезапуском Docker-сервиса. Для доступа нужны shell и чтение-запись файлов. Реестр хостов задаётся через SNO_ROSTER_FILE, оболочка секретов — через SNO_SECRETS_CMD, адрес модели — через OPENAI_BASE_URL; эти настройки необязательны. Без реестра проверка сообщает, что он не настроен, и не подтверждает доступность VM.

Перед перезапуском Docker-сервиса скрипт проверяет основания и блокирует действие, если занята работа другой сессии. Прямое завершение процессов через pkill или kill -9 запрещено по умолчанию. Записи о решениях по Docker попадают в ai-doc/ACTIVE/PL/docker-env-doctor-verdicts.jsonl.

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

  • проверить, доступен ли сервис или хост
  • найти секрет в текущей оболочке и настроенном источнике
  • проверить VM перед запуском сценария
  • оценить, безопасно ли перезапускать Docker-сервис

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

  • Основной pl, проверь, почему сервис недоступен, и запусти проверку окружения.
  • Основной pl, выясни, доступна ли VM перед запуском сценария.
  • Основной pl, проверь, можно ли перезапустить этот Docker-сервис.

Как установить pl-env

1Через Skills CLI (Vercel)

npx skills add sno-ai/sno-station-skills --skill pl-env -a claude-code

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

~/.claude/skills/pl-env/SKILL.md

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

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

Вопросы о pl-env

Как установить pl-env в Claude Code?

Выполни npx skills add sno-ai/sno-station-skills --skill pl-env -a claude-code. Файл скилла устанавливается по пути ~/.claude/skills/pl-env/SKILL.md.

Что делает pl-env?

Скилл проверяет окружение, учётные данные, хосты и Docker-сервисы. Его вызывает основной pl по таблице маршрутизации; напрямую он не запускается.

Что нужно для работы pl-env?

Обязательны shell и чтение-запись файлов. Реестр хостов, оболочка секретов и адрес модели задаются через SNO_ROSTER_FILE, SNO_SECRETS_CMD и OPENAI_BASE_URL и не обязательны.

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

SKILL.md · Apache-2.0
---
name: pl-env
description: "PL role sub-skill — environment doctoring. Loaded ONLY by the pl core via its routing table; NEVER auto-load from context, never invoke directly."
requires:
  programs: []
  harness:
    - {slot: 4.shell, need: required}
    - {slot: 4.file-read-write, need: required}
---

# PL · Env — environment self-service

Scripts named below run as `bash "${PL_SKILL_DIR}/scripts/<name>.sh" ...`, where `PL_SKILL_DIR` is the
absolute path of the `pl` skill directory; set it in the same Bash call.

Sub-skill of the PL role. The pl core skill invokes this EXPLICITLY on any
environment doubt: a "not available / missing / down" claim, a restart wish, a
VM/host question, or before opening an evaluation or end-to-end run. Canonical scripts:
the pl skill's `scripts/`. Read the host/VM registry from `${SNO_ROSTER_FILE:-}`;
when unset, report "no roster configured" and continue. The TSV columns are
name, address, kind, purpose, and check; no machine inventory ships with the skill.
Use the repo's documented service-address source when one exists.
Read `${SNO_SECRETS_CMD:-}` for an optional secrets wrapper: one executable path
that accepts a command and its arguments, injects secrets, and preserves its exit status.
When unset, report "no secrets wrapper configured" and continue.
Read `${OPENAI_BASE_URL:-}` for model connectivity; when unset, report
"using the harness's own endpoint" and continue.
**Known environment traps**: read the project's lessons file (`ai-doc/LESSONS.md`) when it exists;
propose additions by card.

## Environment self-service

The environment doctor is software-flavoured: each check below applies when the project uses that
tool (Docker, uv/bun, git, a GPU, a VM roster); a check for a tool the project does not use is
reported as not applicable, never as a failure.

Environment, resource, and startup blockers are yours (and every executor's) to
fix, not to wait on — parking on an environment blocker without attempted
self-service is a protocol violation. Most external stalls are environment-class,
and a large share of those are FALSE blockages built on stale premises. Hence:

1. **Fresh evidence or it didn't happen**: any BLOCKED-on-environment verdict
   must attach the on-the-spot command + output (health probe, `docker ps`,
   `ls`, configured secrets-wrapper check). A remembered/recorded "not available" is invalid.
2. **Self-serve the fix — `general-env-doctor.sh` is the standard tool**:
   run `bash "${PL_SKILL_DIR}/scripts/general-env-doctor.sh"` (optionally `--fix`) before ever declaring an environment blocker.
   Classes: secrets / creds (auto-repair through the configured wrapper) /
   connectivity / deps (uv/bun sync, CLI tools) / workspace (stale locks,
   scratch directory, disk) / drift (documented ports versus Docker listeners).
   `bash "${PL_SKILL_DIR}/scripts/general-env-doctor.sh" secret <NAME>` answers "the key is missing" claims —
   it checks this shell and the configured secrets wrapper
   without printing values; every name, including API-key names, takes the same lookup.
   An unset wrapper is an unavailable check, not a missing key.
   Query the supplied roster with `bash "${PL_SKILL_DIR}/scripts/general-env-doctor.sh" host [<name>]`.
   Before dispatching a VM-dependent journey, run `bash "${PL_SKILL_DIR}/scripts/general-env-doctor.sh" vm`.
   A missing roster reports "no roster configured" and proves no VM reachable;
   obtain the run's host configuration before dispatching. A failed VM probe
   means do not dispatch onto it.
3. **Restart of a RUNNING service is script-gated** (when the project uses Docker): run
   `bash "${PL_SKILL_DIR}/scripts/docker-env-doctor.sh" <service>` (deterministic).
   `START`/`RESTART_OK` → run `bash "${PL_SKILL_DIR}/scripts/docker-env-doctor.sh" <service> --execute`
   (Docker Compose by default, or the executable named by `ENV_DOCTOR_REBUILD_CMD`; two more optional settings, `ENV_DOCTOR_COUNTER_REQUIRED_RE` (services that must pass a work-counter probe) and `ENV_DOCTOR_QUEUES` (Redis queues that must be empty), are described in the script header); `NO_GROUNDS` → investigate logs instead;
   `BLOCKED_BUSY` → another session's work is in flight: do not restart,
   report with the script's evidence; `INDETERMINATE` → a safety signal could not be verified: take no
   action and report which signal is missing. By default, direct process kills (`pkill`,
   `kill -9`) are forbidden. Verdicts auto-append to
   `ai-doc/ACTIVE/PL/docker-env-doctor-verdicts.jsonl` (audit trail).
4. **Escalate only five things** ("the owner" means whoever owns the work, often the user): restart denied by the busy check; shared
   prod-data mutations; money; interactive auth (gcloud/gh login — state the
   exact command the owner must run); a resource verified absent that needs
   provisioning. Escalations are precise, never a generic "environment stuck".
   Money beyond the ceiling or an existing grant, and any irreversible action that leaves the
   machine, go straight to the owner: the PL sends that card to `SNO_OWNER_ADDR` (the owner's own
   Reach address, exported before the PL starts) with the COS that supervises this lane (the
   Chief of Staff agent; see the pl core's Terms) on Cc, and that COS may not approve, hold or
   edit it (bands and lists: the live decision-rights file,
   `~/.config/sno/decision-rights.md` when present, otherwise the shipped `references/decision-rights.md` in the pl skill).
   **A credential is never one of the five.** "I cannot find the key" and "I am
   locked out" are not escalations at any layer; check the available credential
   sources first. Interactive auth stays legal only
   because a browser genuinely needs a human at it, and only with the exact
   command written out; it is not a place to file a key you did not find.

## Keys — the one class that is never an escalation

Two rules outrank everything else in this file: **never lock yourself out, never
lose the key**. The encrypted-store rule below applies when the project stores encrypted
user data. The operational half is here because this is where an agent lands the moment a
key fails.

- **`bash "${PL_SKILL_DIR}/scripts/general-env-doctor.sh" secret <NAME>`** — the `secret` lookup in item 2. Run it
  before the thought "the key is missing" is allowed to become a sentence in a
  card. If the configured sources miss, inspect the repository's documented
  credential source before declaring the key absent.
- **A failure to open an encrypted store is a defect, not a finding.** Never write it into a
  document as a known limitation, never trade it away, never weaken encryption on
  user data to get past it. Build the rescue road, and prove it by really making
  the keyring unusable and really opening an encrypted store — a simulated
  failure proves nothing, and a restore procedure nobody has run does not exist.

## Pre-run environment self-check

Before opening any evaluation or end-to-end run, check the host you will run it on ONCE: probe
the run's real dependencies up front and declare any degradation BEFORE the run starts. A
failing probe means choose the host NOW from the available ones; do not discover the
degradation mid-run, where it costs rounds on a degraded attempt before the host question is
even asked.

© sno-ai · Apache-2.0 · sno-ai/sno-station-skills

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

Каталог скиллов SKILL.md →
env-and-assets-bootstrap lllllllama Скилл env-and-assets-bootstrap готовит окружение и пути к чекпоинтам с датасетами до первого запуска чужого репозитория по README. CX Codex +1 502 200установок convex-env convex Скилл convex-env для Claude Code, Codex, Cursor и других AI-редакторов помогает безопасно хранить и использовать переменные окружения в Convex-приложениях. CX Codex +1 44 000установок orca-per-workspace-env stablyai Скилл orca-per-workspace-env для Claude Code настраивает и проверяет рецепт окружения Orca для отдельного рабочего пространства. Он включается при работе с environmentRecipes в orca.yaml и ошибками orca vm recipe doctor. CX Codex +1 12 600установок om-prepare-test-env open-mercato Скилл om-prepare-test-env разворачивает локальное окружение для интеграционных тестов и браузерного QA. Определяет стек проекта, создаёт скрипты запуска и сохраняет дескриптор среды. CX Codex +1 3 900установок managing-astro-local-env astronomer Скилл managing-astro-local-env управляет локальным окружением Airflow через Astro CLI в Docker и standalone-режимах. Помогает запускать сервисы, читать логи и слать запросы к Airflow API прямо из диалога с агентом. CX Codex +1 1 800установок wp-env WordPress Скилл wp-env для Claude Code настраивает и запускает локальную среду WordPress через Docker. Он включается и при отладке уже существующей конфигурации .wp-env.json. CX Codex +1 1 200установок

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

Весь набор →
pl Координирует одну рабочую линию проекта и назначенных ей агентов. Активируется по команде /pl, $pl или просьбе взять роль Project Lead. CX Codex +1 ★ 869звёзд репо pl-watch Скилл pl-watch для Claude Code помогает PL следить за исполнителями, которые уже выполняют задачи. Его подключает основной скилл PL при новых карточках, остановках и других событиях работы. CX Codex +1 ★ 869звёзд репо pl-dispatch Скилл pl-dispatch для Claude Code помогает Project Lead открыть рабочий маршрут и составить план его запуска. Его подключает скилл pl по таблице маршрутизации, когда нужно распределить работу или решить, что запускать дальше. CX Codex +1 ★ 869звёзд репо pl-audit Скилл pl-audit для Claude Code проверяет отчёты исполнителей и закрытие задач. Его подключает скилл pl через свою таблицу маршрутизации, когда приходит отчёт или сигнал закрытия. CX Codex +1 ★ 869звёзд репо pl-analyze Скилл pl-analyze для Claude Code разбирает инциденты и оценивает рабочие процессы. Запускается по запросу на ретроспективу или поиск первопричины, а также через маршрутизацию PL. CX Codex +1 ★ 869звёзд репо cos Координирует владельца проекта и руководителей отдельных проектов. Активируется по команде /cos, $cos или прямой просьбе взять роль Chief of Staff. CX Codex +1 ★ 869звёзд репо cos-watch Скилл cos-watch для Claude Code следит за активными PL: проверяет их состояние, пробуждения и ход задач. Его загружает только ядро COS через таблицу маршрутизации, когда работа уже идёт. CX Codex +1 ★ 869звёзд репо cos-review Скилл cos-review для Claude Code проверяет решения, закрытия и оценки после объявленной ночной смены. Его загружает COS core через таблицу маршрутизации, когда владелец возвращается или закрывается пакет задач. CX Codex +1 ★ 869звёзд репо

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

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