# Scout Ext

> [Investigation] Use external agentic tools to scout given directories

- Skill: `majiayu000/scout-ext` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds add majiayu000/scout-ext`
- Raw SKILL.md: https://api.skillmd.com/api/skills/majiayu000/scout-ext/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: majiayu000 (https://skillmd.com/u/majiayu000)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/majiayu000/scout-ext

---


> **[IMPORTANT]** Use `TaskCreate` to break ALL work into small tasks BEFORE starting — including tasks for each file read. This prevents context loss from long files. For simple tasks, AI MUST ask user whether to skip.

**Prerequisites:** **MUST READ** `.claude/skills/shared/evidence-based-reasoning-protocol.md` before executing.

## Quick Summary

**Goal:** Use external agentic tools (Gemini, OpenCode) to quickly locate relevant files across the codebase.

**Workflow:**

1. **Scope** — Define search area and file patterns
2. **Search** — Use external tools for broad file discovery
3. **Report** — Return list of relevant files with context

**Key Rules:**

- Use for broad file discovery across large codebases
- Complements `/scout` with external tool capabilities
- Report file paths with brief context for each match

**Be skeptical. Apply critical thinking, sequential thinking. Every claim needs traced proof, confidence percentages (Idea should be more than 80%).**

## Purpose

Utilize external agentic tools to scout given directories or explore the codebase for files needed to complete the task using a fast, token efficient agent.

## Variables

USER_PROMPT: $1
SCALE: $2 (defaults to 3)
RELEVANT_FILE_OUTPUT_DIR: Use `Report:` from `## Naming` section

## Workflow:

- Write a prompt for 'SCALE' number of agents to the `Task` tool that will immediately call the `Bash` tool to run these commands to kick off your agents to conduct the search:
    - `gemini -p "[prompt]" --model gemini-2.5-flash-preview-09-2025` (if count <= 3)
    - `opencode run "[prompt]" --model opencode/grok-code` (if count > 3 and count < 6)
    - if count >= 6, spawn `Explore` subagents to search the codebase in parallel

**Why use external agentic tools?**

- External agentic tools are faster and more efficient when using LLMs with large context windows (1M+ tokens).

**How to prompt the agents:**

- If `gemini` or `opencode` is not available, ask the user if they want to install it:
    - If **yes**, install it (if there are permission issues, instruct the user to install it manually, including authentication steps)
    - If **no**, use the default `Explore` subagents.
- IMPORTANT: Kick these agents off in parallel using the `Task` tool, analyze and divide folders for each agent to scout intelligently and quickly.
- IMPORTANT: These agents are calling OTHER agentic coding tools to search the codebase. DO NOT call any search tools yourself.
- IMPORTANT: That means with the `Task` tool, you'll immediately call the Bash tool to run the respective agentic coding tool (gemini, opencode, claude, etc.)
- IMPORTANT: Instruct the agents to quickly search the codebase for files needed to complete the task. This isn't about a full blown search, just a quick search to find the files needed to complete the task.
- Instruct the subagent to use a timeout of 3 minutes for each agent's bash call. Skip any agents that don't return within the timeout, don't restart them.
- **IMPORTANT:** Sacrifice grammar for the sake of concision when writing reports.
- **IMPORTANT:** In reports, list any unresolved questions at the end, if any.

---

**IMPORTANT Task Planning Notes (MUST FOLLOW)**

- Always plan and break work into many small todo tasks
- Always add a final review todo task to verify work quality and identify fixes/enhancements