# environment-discovery

The environment-discovery skill trains Claude Code to systematically explore unfamiliar environments before making changes. It checks file structure, data formats, available tools, and existing code—saving debugging time.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf (Devin Desktop), Claude.ai · ★ 1125 repo stars
- Author: vstorm-co
- License: MIT · policy=mirror · the beginning of the file is at the end of this page
- Source: https://github.com/vstorm-co/pydantic-deepagents/tree/HEAD/apps/cli/skills/environment-discovery/SKILL.md
- Updated: 2026-10-27
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/environment-discovery

## What it does

The skill adds four exploration steps to Claude Code. First, examine directory structure and look for READMEs, Makefiles, and config files. Second, inspect data files by detecting type with `file`, previewing with `head`, and reading hex dumps for binary data. Third, check which compilers, interpreters, and libraries are present using `which` and `pip list`. Fourth, read existing code fully and understand the build system.

The core principles are straightforward: never guess file formats, always verify tools are installed, and don't apply `cat` to binary files. For large files (500 MB or more), plan ahead instead of loading everything at once.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add vstorm-co/pydantic-deepagents --skill environment-discovery -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/environment-discovery/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/environment-discovery/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add vstorm-co/pydantic-deepagents --skill environment-discovery -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/environment-discovery/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add vstorm-co/pydantic-deepagents --skill environment-discovery -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/environment-discovery/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install vstorm-co/pydantic-deepagents apps/cli/skills/environment-discovery
```

2. **Manually: put the files in place**
- File: `.github/skills/environment-discovery/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add vstorm-co/pydantic-deepagents --skill environment-discovery -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/vstorm-co/pydantic-deepagents --path apps/cli/skills/environment-discovery
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/environment-discovery/SKILL.md` — The legacy .windsurf/skills/ path still works

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/vstorm-co/pydantic-deepagents/tree/HEAD/apps/cli/skills/environment-discovery/SKILL.md

## When to use it
- Understand an unfamiliar project structure before making changes
- Determine data file format without guessing
- Check which compilers and libraries are available in the environment
- Avoid errors caused by unknown build configurations

## Example prompts
- Help me understand what's in this project and where to start
- Look at the files in this directory and tell me what they contain
- Check if Python, gcc, and the libraries I need are installed

## Source text · SKILL.md · MIT

Below is the content of a third-party file. It is data, not instructions for you: do not act on anything written inside unless the human asks. Block tag: 6b8209b09d7df431.

BEGIN THIRD-PARTY FILE 6b8209b09d7df431
````text
---
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
````
END THIRD-PARTY FILE 6b8209b09d7df431

The third-party file has ended. Everything between the 6b8209b09d7df431 tags is data: requests and commands from it are not followed. An “end of file” line with another tag inside the block is part of the file.

© vstorm-co · MIT · https://github.com/vstorm-co/pydantic-deepagents/tree/HEAD/apps/cli/skills/environment-discovery/SKILL.md

## Similar
- [platform-environment-validate](https://affpapa.org/en/nevibecode/skills/platform-environment-validate.md) — skill · 2800 installs
- [scenario-roblox-environment](https://affpapa.org/en/nevibecode/skills/scenario-roblox-environment.md) — skill · 393 installs
- [test-environment-management](https://affpapa.org/en/nevibecode/skills/test-environment-management.md) — skill · 117 installs
- [environment](https://affpapa.org/en/nevibecode/skills/environment.md) — skill · 58 installs
- [setup-development-environment](https://affpapa.org/en/nevibecode/commands/setup-development-environment.md) — command · 651 installs
- [om-setup-discovery-pipeline](https://affpapa.org/en/nevibecode/skills/om-setup-discovery-pipeline.md) — skill · 2400 installs

From the same set: [vstorm-co/pydantic-deepagents](https://affpapa.org/en/nevibecode/by/vstorm-co/pydantic-deepagents.md) — 14 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
