Scout

COG Scout Skill

Purpose

Lightweight URL/tool triage that sits between "ignore" and /url-dump. Evaluates whether a URL or tool is worth saving or skipping — checking existing vault coverage, assessing relevance to the user's profile and interests, and recommending a clear next action.

When to Invoke

• User wants to evaluate a URL or tool before committing to a full save
• User says "scout this", "evaluate this", "should I save this?", "is this relevant?"
• User shares one or more URLs and wants a quick relevance assessment
• User mentions a tool/service name and wants to know if it's worth investigating

Agent Mode Awareness

Check agent_mode in 00-inbox/MY-PROFILE.md frontmatter:

• If agent_mode: team — delegate vault scanning and web fetching to parallel sub-agents (one for vault search, one for content fetch/analysis). Combine results for recommendation.
• If agent_mode: solo (default) — handle all scanning and analysis directly in the conversation. No delegation.

Pre-Flight Check

Before executing, check for user profile:

1. Look for 00-inbox/MY-PROFILE.md and 00-inbox/MY-INTERESTS.md in the vault
2. If NOT found:

   Welcome to COG! Scout works best with a profile for relevance matching.
   
   Would you like to run /onboarding first, or should I evaluate with general criteria?

3. If found:
   • Read MY-PROFILE.md for active projects and role
   • Read MY-INTERESTS.md for topic areas
   • Read 00-inbox/MY-INTEGRATIONS.md for active integrations (check if web-fetch and web-search are available)

Boundary with /url-dump

Scout evaluates ("should I save this?"). URL-dump saves ("save this now").

• Scout checks existing coverage, assesses relevance, and recommends an action
• If the recommendation is Save, scout hands off to /url-dump with pre-filled category
• Users who already know they want to save should use /url-dump directly

Process Flow

1. Accept Input

Accept one or more of:

• URL(s): Direct links to evaluate
• Tool/service name(s): Will search for the tool first
• Mixed: Combination of URLs and names

Prompt (if no input provided):

What URL(s) or tool(s) would you like me to evaluate?
(You can paste URLs, tool names, or a mix)

Batch mode: Multiple URLs/names in one invocation are processed together with a summary table at the end.

2. Vault Coverage Check

For each URL or tool name, search the entire vault for existing coverage.

Search strategy:

• Extract domain from URL (e.g., github.com/owner/repo → search for repo name)
• Search for tool/service name across the whole vault (grep for domain, repo name, tool name)
• Match against URL strings in frontmatter (url: fields) and inline links

If found:

🔍 Existing coverage found for [name]:
- [file path] — saved [date], category: [category]
- [file path] — mentioned in [context]

Want me to check if an update is needed, or skip this one?

3. Content Fetch & Analysis

If URL provided and web-fetch is active:

• Fetch the URL content using WebFetch
• Extract: title, description, content type, author, date

If tool name provided (no URL):

• Use WebSearch to find the tool's primary page
• Fetch and analyze the top result

Content type detection:

• Tool/Service: Software, SaaS, API, library, framework
• Article/Blog: Long-form content, tutorial, opinion piece
• Repository: GitHub/GitLab repo (extract stars, last commit, language)
• Research: Paper, study, academic content
• News: Industry news, announcement
• Reference: Documentation, spec, standard