version: "1.0.1" name: code-search role: library description: Searches GitHub for existing implementations, libraries, or patterns. Use when finding code examples or prior art on a topic during a research session. alwaysApply: false category: research tags:

• github
• code
• search

estimated_tokens: 200 model_hint: standard

Code Search

When To Use

• Finding existing implementations or libraries on GitHub
• Part of a /tome:research session or standalone search

When NOT To Use

• Searching local codebase (use Grep or Explore agent)
• Academic literature (use /tome:papers)

Search GitHub for implementations of a given topic.

Usage

Invoked as part of /tome:research or standalone.

Workflow

1. Build search queries using

tome.channels.github.build_github_search_queries()

1. Execute queries via WebSearch
2. Parse results via parse_github_result()
3. Optionally use GitHub API via

build_github_api_search() for richer metadata

1. Rank via rank_github_findings()
2. Return Finding objects

Exit Criteria

• [ ] At least one GitHub search query built and executed via

WebSearch for the requested topic

• [ ] Results parsed into Finding objects containing repo metadata

(name, URL, stars) and a relevance score

• [ ] Findings returned from rank_github_findings() sorted by

relevance score descending

• [ ] If no results are found for the query, this is reported

explicitly rather than returning an empty list silently