# Repo Scout

> Scan and understand an ESP-IDF project structure, identifying components, dependencies, and architecture patterns.

- **Type:** Skill
- **Install:** `agentstack add skill-agodianel-esp32-claude-workbench-repo-scout`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [agodianel](https://agentstack.voostack.com/s/agodianel)
- **Installs:** 0
- **Category:** [Agent Skills](https://agentstack.voostack.com/c/agent-skills)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [agodianel](https://github.com/agodianel)
- **Source:** https://github.com/agodianel/esp32-claude-workbench/tree/main/.claude/skills/repo_scout

## Install

```sh
agentstack add skill-agodianel-esp32-claude-workbench-repo-scout
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# Repo Scout

Scan an ESP-IDF project to understand its structure, components, and patterns before making changes.

## When to Use

- Starting work on an unfamiliar project.
- Before writing an implementation contract.
- When you need to understand dependencies between components.

## Steps

### 1. Identify Project Type

Determine the build system:
- Check for `CMakeLists.txt` at root → ESP-IDF CMake project
- Check for `platformio.ini` → PlatformIO project
- Check for `Makefile` with `PROJECT_NAME` → Legacy ESP-IDF Make project

### 2. Map the Component Structure

```
find . -name "CMakeLists.txt" -not -path "./build/*" | head -20
find . -name "component.mk" -not -path "./build/*" | head -20
```

For each component directory, note:
- Component name
- Public headers (in `include/`)
- Dependencies (from `CMakeLists.txt` `REQUIRES` and `PRIV_REQUIRES`)
- Whether it has tests (check for `test/` subdirectory)

### 3. Identify Hardware Configuration

Look for:
- `sdkconfig.defaults` — default Kconfig settings
- `sdkconfig` — current build configuration
- Pin definitions — search for `GPIO_NUM_`, `#define.*PIN`, `#define.*GPIO`
- Peripheral usage — search for `i2c_`, `spi_`, `uart_`, `ledc_`, `adc_`, `wifi_`, `ble_`

### 4. Map Task Architecture

Search for FreeRTOS task creation:
```
grep -rn "xTaskCreate\|xTaskCreatePinnedToCore" --include="*.c" --include="*.h"
```

Document:
- Task names
- Stack sizes
- Priorities
- Core affinity (if pinned)

### 5. Identify External Dependencies

Check:
- `idf_component.yml` — ESP Component Registry dependencies
- `managed_components/` — downloaded components
- Git submodules — `.gitmodules`
- Direct source vendoring — `third_party/` or `lib/`

### 6. Generate Scout Report

Produce a summary with:
- **Project type**: ESP-IDF version, build system
- **Components**: list with brief purpose
- **Hardware dependencies**: pins, peripherals, communication protocols
- **Task map**: FreeRTOS tasks with parameters
- **External dependencies**: libraries and components
- **Test coverage**: which components have tests
- **Risks**: anything unusual or potentially problematic

## Output Format

Write the scout report to the active mission file or print it in a structured markdown block.

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [agodianel](https://github.com/agodianel)
- **Source:** [agodianel/esp32-claude-workbench](https://github.com/agodianel/esp32-claude-workbench)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-agodianel-esp32-claude-workbench-repo-scout
- Seller: https://agentstack.voostack.com/s/agodianel
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.