gh-tenequm-claude-plugins-gh-cli/skills/skill/references/discovery.md

Discovering Trending Content

Complete guide to finding popular repositories, code patterns, and active projects on GitHub.

Find Trending Repositories

By popularity

# Most starred repositories (all time)
gh search repos --sort stars --order desc --limit 20

# Most forked repos
gh search repos --sort forks --order desc

# Most watched repos
gh search repos --sort help-wanted-issues --order desc

By language

# Trending repos in specific language
gh search repos --language=rust --sort stars --order desc
gh search repos --language=typescript --sort stars --order desc
gh search repos --language=python --sort stars --order desc

By recency

# Recently popular (created in last month, sorted by stars)
gh search repos "created:>2024-10-01" --sort stars --order desc

# Created this year
gh search repos "created:>2024-01-01" --sort stars --order desc

# Recently updated popular repos
gh search repos "stars:>100 pushed:>2024-10-01" --sort updated --order desc

By topic

# Trending in specific topic
gh search repos "topic:machine-learning" --sort stars --order desc
gh search repos "topic:blockchain" --sort stars --order desc
gh search repos "topic:react" --sort stars --order desc

# Multiple topics (AND)
gh search repos "topic:blockchain topic:typescript" --sort stars --order desc

By activity

# Most active repos (by recent updates)
gh search repos --sort updated --order desc

# Active repos (many recent commits)
gh search repos "pushed:>2024-10-01" --sort stars

# Repos with many open issues (active community)
gh search repos "good-first-issues:>5" --sort stars --order desc

Advanced Discovery Queries

Unique projects

# Repos with many stars but few forks (unique ideas)
gh search repos "stars:>1000 forks:<100"

# High star-to-fork ratio (original content)
gh search repos "stars:>500 forks:<50"

By file presence

# Find repos by file presence (e.g., has Dockerfile)
gh search code "filename:Dockerfile" --sort indexed

# Has specific config files
gh search code "filename:vite.config.ts" --sort indexed
gh search code "filename:wxt.config.ts" --sort indexed

By description keywords

# Combined filters: Popular Solana repos updated recently
gh search repos "solana in:name,description stars:>100" --sort updated --order desc

# Specific keywords in description
gh search repos "machine learning in:description stars:>1000"

By size and license

# Small but popular repos (easy to learn from)
gh search repos "stars:>1000 size:<1000" --language=typescript

# Specific license
gh search repos "license:mit stars:>500" --language=rust

By organization

# Popular repos from specific org
gh search repos "org:vercel stars:>100"
gh search repos "org:anthropics"

Discover Popular Code Patterns

Find implementations

# Find popular implementations
gh search code "function useWallet" --language=typescript --sort indexed
gh search code "async fn main" --language=rust

# Specific patterns
gh search code "createContext" --language=typescript --sort indexed
gh search code "impl Display for" --language=rust

By popularity

# Most starred code in specific language
gh search code "authentication" --language=typescript --sort stars

# Find code in popular repos only
gh search code "implementation" "stars:>1000"
gh search code "middleware" "stars:>500" --language=typescript

By organization

# Search specific organization's popular code
gh search code "authentication" --owner=anthropics
gh search code "config" --owner=vercel

By recency

# Find recent code examples
gh search code "React hooks" "created:>2024-01-01"
gh search code "Solana program" "created:>2024-06-01" --language=rust

Combining Filters

Examples of powerful combinations

# Popular TypeScript repos updated this month
gh search repos "language:typescript stars:>500 pushed:>2024-10-01" --sort updated

# New promising projects (recent, growing fast)
gh search repos "created:>2024-06-01 stars:>100" --sort stars --order desc

# Active open-source with good first issues
gh search repos "good-first-issues:>3 stars:>100 pushed:>2024-10-01"

# Well-maintained projects (recent activity + documentation)
gh search repos "stars:>1000 pushed:>2024-10-01" --language=typescript | grep -i "readme"

Qualifiers Reference

Date qualifiers

• created:>YYYY-MM-DD - Created after date
• created:<YYYY-MM-DD - Created before date
• pushed:>YYYY-MM-DD - Updated after date
• pushed:<YYYY-MM-DD - Updated before date

Numeric qualifiers

• stars:>N - More than N stars
• stars:N..M - Between N and M stars
• forks:>N - More than N forks
• size:<N - Smaller than N KB

Boolean qualifiers

• is:public - Public repos
• is:private - Private repos (requires auth)
• archived:false - Not archived
• archived:true - Archived repos

Location qualifiers

• in:name - Search in repo name
• in:description - Search in description
• in:readme - Search in README
• in:name,description - Search in both

Tips for Discovery

Start broad, then filter

# 1. Find all Solana repos
gh search repos "solana"

# 2. Filter by popularity
gh search repos "solana stars:>100"

# 3. Filter by recency
gh search repos "solana stars:>100 pushed:>2024-10-01"

# 4. Add language
gh search repos "solana stars:>100 pushed:>2024-10-01" --language=rust

Use topics for precision

Topics are more precise than text search:

# Better: Use topic
gh search repos "topic:web3" --sort stars

# Less precise: Text search
gh search repos "web3" --sort stars

Check activity indicators

High stars but old updates = abandoned:

# Good: Popular AND recently updated
gh search repos "stars:>1000 pushed:>2024-10-01"

# Risk: Popular but potentially stale
gh search repos "stars:>1000"

Look for hidden gems

Sometimes the best code isn't the most popular:

# Well-maintained but not famous
gh search repos "stars:10..100 pushed:>2024-10-01" --language=rust

# Recent projects gaining traction
gh search repos "created:>2024-09-01 stars:>10" --sort stars

Output formatting

Get specific fields

# Just repo names
gh search repos "topic:react" --json name --jq '.[].name'

# Name and star count
gh search repos "topic:react" --limit 5 --json name,stargazersCount --jq '.[] | "\(.name): \(.stargazersCount) stars"'

# Full URLs
gh search repos "topic:rust" --json url --jq '.[].url'

Limit results

# Top 10 only
gh search repos "language:typescript" --sort stars --limit 10

# Top 50
gh search repos "topic:machine-learning" --limit 50

Common Discovery Workflows

"Find similar repos to X"

# 1. Check topics of repo X
gh repo view OWNER/REPO --json repositoryTopics

# 2. Search by those topics
gh search repos "topic:web3 topic:solana" --sort stars --order desc

"What's trending in [language] this month?"

gh search repos "language:rust created:>2024-10-01" --sort stars --order desc --limit 20

"Find actively maintained [topic] projects"

gh search repos "topic:blockchain pushed:>2024-10-01 stars:>50" --sort updated --order desc

"Discover new tools for [task]"

# Example: PDF processing tools
gh search repos "pdf in:name,description language:python stars:>50" --sort stars