github-stars-searcher

name	github-stars-searcher
description	Search through your GitHub Stars collection using semantic understanding. Use when user wants to: (1) Find a previously starred repository, (2) Search for repos by functionality or use case, (3) Browse their starred repositories with natural language queries like "authentication library" or "image processing tool". Requires github-stars-collector to be run first to build the database.

Search your GitHub Stars collection using semantic understanding.

Workflow

1. Check if data exists at .claude/skills/data/stars/
2. If not found, prompt user to run github-stars-collector first
3. Scan all meta.json files to build a repo index
4. Parse user's natural language query to understand intent
5. Match repositories across multiple dimensions:
   • Repository name and description
   • Topics and language
   • README content (read README.md for promising candidates)
6. For top candidates, read README.md for deeper semantic matching
7. Return top 5-10 most relevant repositories with matching reasons

Search Strategy

Phase 1 - Metadata scan (fast): Read all meta.json files. Filter by description, topics, language, and name relevance.

Phase 2 - README deep dive (accurate): For the top 20-30 candidates from Phase 1, read their README.md files and do precise semantic matching against the user's query.

Data Source

Data is generated by github-stars-collector and stored in .claude/skills/data/stars/.

Directory structure:

stars/{owner}/{repo}/
├── meta.json     # {"full_name", "description", "language", "stars", "url", "topics"}
└── README.md     # Truncated README content

First-Time Usage

If the data directory doesn't exist, guide user to run:

/github-stars-collector

Output Format

For each matching repository, return:

• Repository name with link
• Brief description
• Why it matches the query
• Key information (language, stars)

Example:

**owner/repo-name** - [Python | ⭐ 1.2k]
Description: Authentication library for web apps
Matched because: You're looking for authentication tools, and this library handles OAuth and JWT tokens.
Link: https://github.com/owner/repo-name