# Scout

> Run a local web research agent and mission-driven intelligence scanner that searches multiple sources and writes markdown briefs. Best for trend monitoring, opportunity scouting, builder discovery, and technical signal scanning.

- Skill: `lout33/scout` (Agent Skill, multi-file: 10 files)
- Install (CLI): `npx skillmds@latest add lout33/scout`
- Raw SKILL.md: https://api.skillmd.com/api/skills/lout33/scout/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Product & Planning
- Author: lout33 (https://skillmd.com/u/lout33)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/lout33/scout

---


# Scout

Mission-driven local web research agent backed by the files in this directory.

## What it does

- plans a scan from a mission
- calls source adapters to gather signal
- follows promising leads
- writes a markdown brief to `inbox/`

Best for:

- technical trend monitoring
- open-source discovery
- opportunity scouting
- builder and ecosystem research

## Working adapters

- Hacker News
- GitHub
- Jina Reader

## Setup

```bash
pip install -r requirements.txt
cp .env.example .env
```

Then configure one of:

- Codex auth: `codex login --device-auth`
- `ANTHROPIC_API_KEY`

Optional:

- `JINA_API_KEY`
- `GITHUB_TOKEN`

## Direct commands

```bash
python agent.py --mission "Find 3 interesting technical signals from today" --tokens 5000
./quick.sh --mission "Find 2 interesting GitHub repos from this week"
./scout.sh --tokens 20000 --mission "Find open-source agent tooling worth tracking"
./daily.sh --tokens 10000
```

## Recommended smoke test

```bash
python agent.py --mission "Use hn_front, github_trending, and jina_read to find 2 interesting technical signals from today and write a brief." --tokens 2500
```

If the setup works, Scout writes a markdown brief to `inbox/`.