code-search
Searches GitHub for existing implementations, libraries, or patterns. Use when finding code examples or prior art on a topic during a research session.
SKILL.mdplugins/tome/skills/code-search/SKILL.md
GitHubCode Search
When To Use
- Finding existing implementations or libraries on GitHub
- Part of a
/tome:researchsession or standalone search
When NOT To Use
- Searching local codebase (use Grep or Explore agent)
- Academic literature (use
Skill(tome:papers))
Search GitHub for implementations of a given topic.
Usage
Invoked as part of /tome:research or standalone.
Workflow
- Build search queries using
tome.channels.github.build_github_search_queries() - Execute queries via WebSearch
- Parse results via
parse_github_result() - Optionally use GitHub API via
build_github_api_search()for richer metadata - Rank via
rank_github_findings() - 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