environment-discovery — скилл для Claude Code
Скилл учит агента систематически исследовать незнакомое окружение перед тем, как начинать работу. Проверяет структуру файлов, форматы данных, установленные инструменты и существующий код — это экономит время на отладку.
MIT ★ 1 125 обновлён 2026-10-27
npx skills add vstorm-co/pydantic-deepagents --skill environment-discovery -a claude-codeЧто делает environment-discovery
Скилл добавляет в Claude Code четыре шага разведки. На первом агент смотрит на структуру директории и ищет README, Makefile, конфиги. На втором инспектирует файлы данных: определяет тип через file, просматривает начало через head, для бинарных файлов читает в hex. На третьем проверяет, какие компиляторы, интерпретаторы и библиотеки установлены — вызывает which, смотрит pip list. На четвёртом читает существующий код полностью и изучает систему сборки.
В основе лежат простые принципы: никогда не гадать о формате файла, всегда проверять наличие инструментов, к бинарным файлам не применять cat. Для больших файлов (500 MB и больше) нужна заранее продуманная стратегия, а не попытка загрузить в память сразу.
Какие задачи решает
- Понять структуру незнакомого проекта перед первым изменением
- Определить формат файла данных без угадывания
- Проверить, какие компиляторы и библиотеки есть в окружении
- Избежать ошибок из-за неизвестной конфигурации сборки
Примеры запросов агенту
- Помоги мне разобраться, что здесь в проекте, где начать
- Посмотри, какие файлы лежат в этой директории и что в них
- Проверь, установлены ли Python, gcc и нужные мне библиотеки
Как установить environment-discovery
1Через Skills CLI (Vercel)
npx skills add vstorm-co/pydantic-deepagents --skill environment-discovery -a claude-code2Вручную: положить файлы
~/.claude/skills/environment-discovery/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/environment-discovery/
1Через Skills CLI (Vercel)
npx skills add vstorm-co/pydantic-deepagents --skill environment-discovery -a codex2Вручную: положить файлы
.agents/skills/environment-discovery/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add vstorm-co/pydantic-deepagents --skill environment-discovery -a cursor2Вручную: положить файлы
.cursor/skills/environment-discovery/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install vstorm-co/pydantic-deepagents apps/cli/skills/environment-discovery2Вручную: положить файлы
.github/skills/environment-discovery/SKILL.md1Через Skills CLI (Vercel)
npx skills add vstorm-co/pydantic-deepagents --skill environment-discovery -a gemini-cli2Командой платформы
gemini skills install https://github.com/vstorm-co/pydantic-deepagents --path apps/cli/skills/environment-discoveryВручную: положить файлы
.devin/skills/environment-discovery/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Claude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы об environment-discovery
Как установить environment-discovery в Claude Code?
Выполни npx skills add vstorm-co/pydantic-deepagents --skill environment-discovery -a claude-code, а затем отредактируй ~/.claude/skills/environment-discovery/SKILL.md.
Что делает environment-discovery?
Скилл учит агента перед началом работы систематически исследовать окружение: смотреть структуру файлов, проверять форматы данных, искать установленные инструменты и понимать существующий код. Это помогает избежать ошибок и предположений.
Когда использовать этот скилл?
Когда входишь в незнакомый проект или окружение. Скилл особенно полезен, если нужно работать с неизвестными форматами данных, бинарными файлами или проверять доступность определённых инструментов.
Исходный текст
SKILL.md · MIT
--- name: environment-discovery description: "Systematic exploration of unknown environments before starting work" tags: [exploration, setup, benchmark] version: "1.0.0" --- # Environment Discovery When dropped into an unfamiliar environment, ALWAYS explore before acting. ## Step 1: Understand the workspace ``` ls -la /app/ # or the working directory find . -type f | head -50 ``` - What files exist? What are their sizes? - Are there READMEs, Makefiles, config files? - What languages/frameworks are involved? ## Step 2: Inspect data files Before writing any code that reads data, understand the format: - `file <filename>` — detect file type (binary, text, encoding) - `head -20 <file>` — first lines of text files - `xxd <file> | head -20` — hex dump for binary files - `wc -l <file>` — line count for text files - `stat <file>` — exact file size in bytes - `python3 -c "import struct; ..."` — parse binary headers ## Step 3: Check available tools ``` which python3 gcc g++ make cmake node npm cargo rustc java go pip list 2>/dev/null | head -20 ``` - What compilers/interpreters are installed? - What libraries are available? - What package managers can you use? ## Step 4: Read existing code If there are existing source files: - Read them FULLY before modifying - Understand the build system (Makefile, CMakeLists.txt, pyproject.toml) - Check for existing tests ## Key Principles - NEVER assume file formats — always inspect first - NEVER assume tools are installed — always check - A 500MB file is NOT a "small file" — plan for it - Binary files need byte-level inspection, not `cat` - Spend 30 seconds exploring to save 5 minutes debugging
© vstorm-co · MIT · vstorm-co/pydantic-deepagents