Agent skill

Vc Scout

by withkynam in withkynam/vibecode-pro-max-kit

Fast codebase scouting using shell search and optional parallel research agents.

MITAuto-check passedAgent Workflows

Install Vc Scout

skills CLI
$ npx skills add withkynam/vibecode-pro-max-kit --skill vc-scout -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install withkynam/vibecode-pro-max-kit vc-scout --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/withkynam/vibecode-pro-max-kit.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.claude/skills/vc-scout .claude/skills/vc-scout && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
vc-scout
GitHub stars
1.1k
Token cost
~960 tokens
SKILL.md length
403 words
Files
4 (incl. references)
Skills in repo
32
Repo updated
First seen
Licence
MIT

At a glance

Fast codebase scouting using shell search and optional parallel research agents.

  • Works in 5 steps: Analyze Task → Divide and Conquer → Register Scout Tasks → …
  • Task context gathering
  • SKILL.md covers Arguments, When to Use, Quick Start and Configuration, plus 3 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Vc Scout is an agent skill from withkynam/vibecode-pro-max-kit. Fast codebase scouting using shell search and optional parallel research agents. Use for file discovery, task context gathering, and quick scoped searches across directories.

Its SKILL.md is about 960 tokens, which your agent loads only when the skill is triggered. The skill folder holds 4 other files, including reference files (for example `references/external-scouting.md`, `references/internal-scouting.md` and `references/task-management-scouting.md`).

It sits in Agent Workflows, covering Deep research. The repository describes itself as: Your AI forgets. This remembers. Spec-driven coding harness for vibecoders, product owners, CEOs and real builders — self-improving context memory, 15 agents, 33 skills working…. The licence is MIT.

When your agent uses it

  • Task context gathering
  • Quick scoped searches across directories

Example prompts

  • “/vc-scout”

Workflow steps

5 steps, taken from the step headings in SKILL.md.

  1. Analyze Task
  2. Divide and Conquer
  3. Register Scout Tasks
  4. Spawn Parallel Agents
  5. Collect Results

What it can do on your machine

Read from SKILL.md and the folder at commit 3bcb2f9. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md (its code samples are markdown).

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Vc Scout loads about 960 tokens when it runs, and up to ~3.7k if it reads all its reference files. Until then it costs about 46 tokens; SKILL.md has 403 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~46
When it runs · the whole SKILL.md, loaded when a task matches
~960
With references · SKILL.md plus every file in references/, read only if the agent opens them
~3.7k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from withkynam/vibecode-pro-max-kit at commit 3bcb2f9, republished under its MIT licence (© withkynam). 403 words, ~960 tokens.

Download SKILL.mdSave it as .claude/skills/vc-scout/SKILL.md (or your agent's skills folder). This skill also uses 3 other files; get the full folder from GitHub.
name
vc-scout
description
Fast codebase scouting using shell search and optional parallel research agents. Use for file discovery, task context gathering, and quick scoped searches across directories.
argument-hint
[search-target] [ext]
trigger_keywords
find files, where is, search codebase
layer
helper
metadata.author
claudekit
metadata.version
1.0.0

Scout

Output style: Follow process/development-protocols/communication-standards.md — answer-first, plain language, no unexplained jargon, TL;DR on long responses.

Fast, token-efficient codebase scouting using parallel agents to find files needed for tasks.

Arguments

  • Default: Scout using local shell search plus optional parallel research-agent delegation (./references/internal-scouting.md)
  • ext: Scout using external Gemini/OpenCode CLI tools in parallel (./references/external-scouting.md)

When to Use

  • Beginning work on feature spanning multiple directories
  • User mentions needing to "find", "locate", or "search for" files
  • Starting debugging session requiring file relationships understanding
  • User asks about project structure or where functionality lives
  • Before changes that might affect multiple codebase parts

Quick Start

  1. Analyze user prompt to identify search targets
  2. Use a wide range of Grep and Glob patterns to find relevant files and estimate scale of the codebase
  3. Use local shell search first, then optionally spawn parallel research-agent workers with divided directories when the search space is large
  4. Collect results into concise report

Configuration

Read from .claude/.vc.json (falls back to legacy .claude/.ck.json if present):

  • gemini.model - Gemini model (default: gemini-3-flash-preview)

Workflow

1. Analyze Task
  • Parse user prompt for search targets
  • Identify key directories, patterns, file types, lines of code
  • Determine optimal SCALE value of subagents to spawn
2. Divide and Conquer
  • Split codebase into logical segments per agent
  • Assign each agent specific directories or patterns
  • Ensure no overlap, maximize coverage
3. Register Scout Tasks
  • Parallel task registration and external orchestration patterns are optional, not required for normal scouting in this repo
  • See references/task-management-scouting.md only when you are intentionally coordinating a larger parallel scout workflow
Show full SKILL.md (151 more words)Show less
4. Spawn Parallel Agents

Load appropriate reference based on decision tree:

  • Internal (Default): references/internal-scouting.md (shell search plus optional research-agent parallelism)
  • External: references/external-scouting.md (Gemini/OpenCode)

Notes:

  • TaskUpdate each task to in_progress before spawning its agent (skip if Task tools unavailable)
  • Prompt detailed instructions for each subagent with exact directories or files it should read
  • Remember that each subagent has less than 200K tokens of context window
  • Amount of subagents to-be-spawned depends on the current system resources available and amount of files to be scanned
  • Each subagent must return a detailed summary report to a main agent
5. Collect Results
  • Timeout: 3 minutes per agent (skip non-responders)
  • TaskUpdate completed tasks; log timed-out agents in report (skip if Task tools unavailable)
  • Aggregate findings into single report
  • List unresolved questions at end

Report Format

markdown
# Scout Report

## Relevant Files
- `path/to/file.ts` - Brief description
- ...

## Unresolved Questions
- Any gaps in findings

References

  • references/internal-scouting.md - Using shell search and optional parallel research-agent work
  • references/external-scouting.md - Using Gemini/OpenCode CLI
  • references/task-management-scouting.md - Optional task-registration patterns for larger scout coordination

© withkynam, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 3 other files (references) in .claude/skills/vc-scout of withkynam/vibecode-pro-max-kit.

  • SKILL.md
  • references/external-scouting.md
  • references/internal-scouting.md
  • references/task-management-scouting.md

Open the folder on GitHubat commit 3bcb2f9

Compare with similar skills

Vc Scout next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Vc Scout compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Vc Scout this skillwithkynam/vibecode-pro-max-kit1.1k—~960Automated safety check: PassMIT
Business Brainstormcoreyhaines31/makerskills848—~1.7kAutomated safety check: PassMIT
Synthesisyologdev/yoyo-evolve1.9k—~3.1kAutomated safety check: PassMIT
Prediction Report WriterNVIDIA-AI-Blueprints/deep-researcher-agent883—~2.5kAutomated safety check: PassApache-2.0
Nuwa Thinking-Style Skill Builderalchaincyf/nuwa-skill34k—~4.6kAutomated safety check: PassMIT
Web ResearchJuncai22/spring-ai-agent-learning1233 repos~1.1kAutomated safety check: PassApache-2.0

Similar skills

  • Business Brainstorm

    coreyhaines31/makerskills

    When you want to pressure-test a potential new business, product, or side project against the serial-founder filter.

    848 GitHub stars~1.7k tokensUpdated 1 mo ago
    Agent WorkflowsAuto-check passed
  • Synthesis

    yologdev/yoyo-evolve

    Multi-source research synthesis — aggregate and compare 3+ sources or any source 5KB using sub-agent dispatch and SharedState

    1.9k GitHub stars~3.1k tokensUpdated today
    Agent WorkflowsAuto-check passed
  • Prediction Report Writer

    NVIDIA-AI-Blueprints/deep-researcher-agent

    A skill your agent uses when the final answer strategy calls for a prediction, forecast, probability estimate, price target, expected value, threshold outcome, scenario outlook, or prediction-style…

    883 GitHub stars~2.5k tokensUpdated 2 days ago
    Agent WorkflowsAuto-check passed
  • Researches a person or theme and distills how they think into a runnable persona skill with mental models, decision rules and a characteristic voice.

    34k GitHub stars~4.6k tokensUpdated 1 mo ago
    Agent WorkflowsAuto-check passed
  • Web Research

    Juncai22/spring-ai-agent-learning

    A skill your agent uses for requests related to web research; it provides a structured approach to conducting comprehensive web research

    123 GitHub starsUsed in 3 repos~1.1k tokens
    Research & ScienceAuto-check passed
  • Deepdive

    Socialpranker/deepdive

    Meta-research под вопрос или решение: веб-поиск, источники, Q&A отчёт с цитатами по файлам для повторного использования.

    371 GitHub stars~5.2k tokensUpdated 4 days ago
    Research & ScienceAuto-check passed

More from withkynam/vibecode-pro-max-kit

All 32 skills in this repo
  • Library Documentation Seeker

    withkynam/vibecode-pro-max-kit

    Looks up library and framework documentation through Context7 first, with bundled Node scripts as a fallback that fetch and analyze llms.txt files.

    1.1k GitHub starsUsed in 2 repos~1k tokens
    Auto-check: notes
  • Vc Sequential Thinking

    withkynam/vibecode-pro-max-kit

    Apply step-by-step analysis for complex problems with revision capability.

    1.1k GitHub starsUsed in 2 repos~854 tokens
    Auto-check passed
  • Agent Browser Automation

    withkynam/vibecode-pro-max-kit

    Drives a browser through the agent-browser CLI, using compact snapshots with element refs to keep context small in long sessions, plus video recording and cloud browsers.

    1.1k GitHub stars~2.6k tokensUpdated 3 mo ago
    Auto-check passed
  • Context Routing Audit

    withkynam/vibecode-pro-max-kit

    Audits a project's context routing, skill discoverability and skill wiring by running a chain of validator scripts and fixing whatever they report.

    1.1k GitHub stars~1.2k tokensUpdated 3 mo ago
    Auto-check passed
  • Active Plan Audit

    withkynam/vibecode-pro-max-kit

    Reviews a codebase's active plan files for staleness and completion, then archives only the ones confirmed done or obsolete against the real code.

    1.1k GitHub stars~757 tokensUpdated 3 mo ago
    Auto-check passed
  • Systematic Debugging and Investigation

    withkynam/vibecode-pro-max-kit

    Forces root-cause investigation before any fix, combining a four-phase debugging method with log, CI and performance investigation techniques and a rule against unverified completion claims.

    1.1k GitHub stars~1.5k tokensUpdated 3 mo ago
    Auto-check passed

Questions about Vc Scout

What does Vc Scout do?

Fast codebase scouting using shell search and optional parallel research agents. Vc Scout is an agent skill from withkynam/vibecode-pro-max-kit. Fast codebase scouting using shell search and optional parallel research agents.

When should I use Vc Scout?

Vc Scout fits situations like: task context gathering; quick scoped searches across directories.

How do I install Vc Scout in Claude Code?

Run `npx skills add withkynam/vibecode-pro-max-kit --skill vc-scout -a claude-code`. Or copy the skill folder (.claude/skills/vc-scout in withkynam/vibecode-pro-max-kit) into .claude/skills/vc-scout in your project. Claude Code loads it when a task matches its description.

How do I install Vc Scout in Codex?

Run `npx skills add withkynam/vibecode-pro-max-kit --skill vc-scout -a codex`. Or copy the skill folder (.claude/skills/vc-scout in withkynam/vibecode-pro-max-kit) into .agents/skills/vc-scout in your project. Codex loads it when a task matches its description.

Can I use Vc Scout in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add withkynam/vibecode-pro-max-kit --skill vc-scout -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/vc-scout, .gemini/skills/vc-scout, .github/skills/vc-scout and .opencode/skills/vc-scout in your project.

What does Vc Scout need to run?

SKILL.md names no scripts, command-line tools or credentials: Vc Scout is instructions for the agent only.

Does Vc Scout access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Vc Scout safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Vc Scout use?

Vc Scout is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Vc Scout use?

About 960 tokens (SKILL.md is roughly 3.8k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 2.7k tokens, read only when the agent opens those files.

What are the alternatives to Vc Scout?

Skills that share tags, products or a category with Vc Scout: Business Brainstorm (coreyhaines31/makerskills, 848 stars), Synthesis (yologdev/yoyo-evolve, 1.9k stars), Prediction Report Writer (NVIDIA-AI-Blueprints/deep-researcher-agent, 883 stars) and Nuwa Thinking-Style Skill Builder (alchaincyf/nuwa-skill, 34k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Vc Scout?

withkynam (a GitHub user) maintains it in withkynam/vibecode-pro-max-kit, which has 1,145 GitHub stars. The repository holds 32 skills in this directory. The repository was last updated on June 21, 2026.

Source: withkynam/vibecode-pro-max-kit on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.