Skill search results and multi-backend search runners — GitHub, registry, and agent sources with relevance sorting.

SearchResult

Search result from any source.

Fields

Methods

new

pub fn new(name: impl Into<String>, description: impl Into<String>, source: impl Into<String>, registry: impl Into<String>) -> Self

popularity

pub fn popularity(&self) -> u64

The popularity value used for ranking: weekly installs for skills.sh, stars for everything else.

sort_by_popularity

pub fn sort_by_popularity(results: &mut [Self])

Sort results by popularity descending.

sort_by_relevance

pub fn sort_by_relevance(results: &mut [Self], query: &str)

Sort results by relevance to the query, combining text match quality with normalized popularity. Popularity (stars / installs) is normalized per-registry so that different scales (GitHub stars vs skills.sh weekly installs) become comparable.

Trait Implementations

• Debug
• Clone
• Serialize
• Deserialize<'de>

owner_repo_of

pub fn owner_repo_of(source: &str) -> &str

Extract “owner/repo” from a source string. "obra/superpowers/skills/brainstorming" → "obra/superpowers". Returns the full string if it has fewer than two /-separated segments.

skill_dir_name

pub fn skill_dir_name(source: &str) -> &str

Extract the leaf skill directory name from a source path. "obra/superpowers/skills/brainstorming" → "brainstorming". Returns the full source if it has no path beyond owner/repo.

group_by_owner_repo

pub fn group_by_owner_repo(results: &[SearchResult]) -> Vec<(String, Vec<usize>)>

Group results by owner_repo_of, preserving first-occurrence order. Returns (owner_repo, indices_into_results) pairs.

parallel_search

pub fn parallel_search(sources: Vec<Box<dyn >>, query: &str, limit: usize, cache: Option<&SearchCache>, max_age_secs: u64) -> Vec<SearchResult>

Run all search sources in parallel using threads. Merge all results. If a source errors, print a warning and skip it.

When cache is provided, each source checks the cache before making a network call and writes results back on a miss. The “agent” source is never cached because its output is dynamic.

cascade_search

pub fn cascade_search(sources: Vec<Box<dyn >>, query: &str, limit: usize) -> Vec<SearchResult>

Run search sources sequentially. Stop at the first source that returns results. If a source errors, print a warning and continue.