Type	Examples	Description
Rankings	`热门仓库` `Top 10`	Current rankings by stars
Detail	`xxx/xxx 介绍`	Repository README summary
Topic	`python 话题排行榜`	Custom topic search

Workflow

- [ ] Step 1: Parse query type
- [ ] Step 2: Fetch data from GitHub
- [ ] Step 3: Format and display results

Step 1: Parse Query Type

User Input	Query Type	Action
`热门仓库`	rankings	Show top N repos
`Top 10 项目`	rankings	Show top N repos
`xxx/xxx 介绍`	detail	Get README summary
`python 话题`	rankings	Search python topic

Step 2: Fetch Data

Fetch Rankings

cd skills/github-topics
python src/github_fetcher.py

Requirements:

pip install requests

Fetch README (Optional)

python src/readme_fetcher.py

Step 3: Format Results

Rankings Output

# GitHub Trending - python

| # | Repository | Stars | Language |
|---|------------|-------|----------|
| 1 | donnemartin/system-design-primer | 334K | Python |
| 2 | vinta/awesome-python | 281K | Python |
| 3 | project-based-learning | 257K | - |

Detail Output

# anthropics/claude-code

**Stars**: 15.2K
**Language**: TypeScript
**URL**: https://github.com/anthropics/claude-code

## README Summary
Official Claude Code CLI for AI-powered software development. Claude Code is Anthropic's official CLI tool...

Configuration

Variable	Description	Default
`GH_TOKEN`	GitHub Personal Access Token (optional, for higher rate limits)	-
`TOPIC`	GitHub topic to track	`claude-code`

Note: GH_TOKEN is optional but recommended:

With token: 5,000 requests/hour
Without token: 60 requests/hour

Create token at: https://github.com/settings/tokens

GitHub API Notes

Limit Type	Rate
Authenticated	5,000 requests/hour
Unauthenticated	60 requests/hour

Recommendation: Use GH_TOKEN for higher rate limits.

Troubleshooting

Issue	Solution
Rate limit	Set `GH_TOKEN` env var
Network timeout	Check internet connection
Empty results	Check topic name exists

CLI Reference

# Fetch rankings (default topic: claude-code)
python skills/github-topics/src/github_fetcher.py

# Fetch README
python skills/github-topics/src/readme_fetcher.py

github-topics

GitHub Topics Trending

Quick Start

Query Types