vc-scout

Searches codebases with shell tools and parallel agents to locate relevant files.

Updated Apr 9, 2026
One-click install
npx skills add https://github.com/HyuseCS/project-c --skill vc-scout-hyusecs
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: vc-scout
Source: https://github.com/HyuseCS/project-c/tree/main/.claude/skills/vc-scout
Command: npx skills add https://github.com/HyuseCS/project-c --skill vc-scout-hyusecs

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Locating the right files in a large or unfamiliar codebase is slow and token-expensive. This Skill performs fast, scoped codebase scouting so you can find relevant files, understand project structure, and gather task context without reading everything. ## Core Features & Use Cases - Internal Scouting: Uses shell search (rg, glob, grep) with optional parallel research agents that divide directories for broad coverage. - External Scouting: Delegates searches to Gemini or OpenCode CLI tools with large context windows when the search space is wide. - Structured Reports: Aggregates findings into a concise report listing relevant files with descriptions plus unresolved questions. - Use Case: Before modifying authentication logic spread across multiple modules, run a scout to map all auth-related files, endpoints, tests, and configuration in one pass. ## Quick Start Ask the assistant to scout the codebase for all files related to the feature you are about to work on.

Frequently Asked Questions about vc-scout

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I find files related to a feature in a large codebase?

Run a scout that parses your prompt for search targets, then applies Grep and Glob patterns across directories. For broad searches, it splits the codebase into segments and assigns parallel agents to each scope, aggregating results into one report.

When should I use external CLI tools like Gemini for code search?

Use external scouting when the search scale is small to medium (SCALE 3-5) and you want large context windows of 1M+ tokens. Gemini handles SCALE up to 3, OpenCode covers SCALE 4-5, and SCALE 6 or higher falls back to internal shell scouting.

What happens if Gemini or OpenCode CLI is not installed?

The skill checks tool availability with which gemini and which opencode before use. If missing, it asks whether to install them or falls back to internal shell scouting using rg, glob, and targeted file reads.

How are large files read without exceeding context limits?

Files are chunked at roughly 500 lines per chunk using wc -l for line counts and sed for range reads. Files under 500 lines are read whole, while larger files split into ceil(lines/500) chunks processed in parallel or sequentially.

What are the limitations of parallel agent scouting?

Each agent has a 3-minute timeout and under 200K tokens of context, so timed-out agents are skipped rather than restarted. Gaps from timeouts are logged in the report's unresolved questions section.