---
name: athola/code-search
source: https://app.decimal.ai/s/athola-code-search@2/SKILL.md
source_sha256: 681e4514f79b
---

# 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 `Skill(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()`
2. Execute queries via WebSearch
3. Parse results via `parse_github_result()`
4. Optionally use GitHub API via
   `build_github_api_search()` for richer metadata
5. Rank via `rank_github_findings()`
6. 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