github-topics

# GitHub Topics Trending

Fetch GitHub topic trending repositories and README summaries.

## Quick Start

```
# View rankings
今天 claude-code 话题排行榜
Top 10 GitHub 项目
热门仓库

# View repository details
anthropics/claude-code 介绍
这个仓库是做什么的
```

## Query Types

| 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

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

**Requirements**:
```bash
pip install requests
```

### Fetch README (Optional)

```bash
python src/readme_fetcher.py
```

---

## Step 3: Format Results

### Rankings Output

```markdown
# 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

```markdown
# 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...