Back to skills
extension
Category: Development & EngineeringNo API key required

context-finder

Auto-spawn context-finder agent for search tasks. Use when user says "find", "search", "where is", "look for", "trace", "what file", "which commit", "grep", "locate". Triggers search in git history, files, issues, retrospectives.

personAuthor: jakexiaohubgithub

Context Finder Skill

Auto-trigger search when user needs to find something

Proactive Triggers

MUST Spawn context-finder Agent When:

  • User says: "find", "search", "where is", "look for"
  • User says: "what file", "which commit", "locate"
  • User asks: "did we work on X", "when did we", "where did"
  • User needs to trace: code, history, issues, docs

How to Invoke

Spawn the context-finder agent:

Task tool:
  subagent_type: context-finder
  model: haiku
  prompt: |
    Search for [USER'S QUERY] in:
    1. Git history: git log --all --oneline --grep="[QUERY]"
    2. Files: find/grep for [QUERY]
    3. GitHub issues: gh issue list --search "[QUERY]"
    4. Retrospectives: grep in ψ/memory/retrospectives/

    Return: compact list of matches with paths/commits

What context-finder Searches

| Source | Command | Finds | |--------|---------|-------| | Git history | git log --grep | Commits mentioning topic | | Files | find, grep | Current files | | Issues | gh issue list | Planning, discussions | | Retrospectives | grep ψ/memory/ | Past session context |

When NOT to Use

  • User already knows the exact file path
  • Simple questions about current code (just read it)
  • User explicitly says "don't search"

Quick Patterns

| User Says | Action | |-----------|--------| | "find the auth code" | Spawn agent → search "auth" | | "where did we put X" | Spawn agent → search files + git | | "when did we work on Y" | Spawn agent → search retrospectives | | "trace Z" | Spawn agent → comprehensive search |