Github Topics

Fetches GitHub topic trending repositories. Use when asking about GitHub trending repos or open source projects.

Security Scan

The skill's code and instructions match its description (fetching GitHub topic repos and README summaries); nothing in the files requests unrelated credentials, installs, or external endpoints beyond GitHub/RawGitHub, though there are small non-security inconsistencies in comments/metadata.

Purpose & Capability

Name/description (GitHub topics/trending repos) align with the included Python modules (github_fetcher.py and readme_fetcher.py). The code uses the GitHub Search and Repos APIs and raw.githubusercontent.com to fetch READMEs, which is expected for this purpose. The only oddity: src/__init__.py docstring references an unrelated 'AI Daily / smol.ai' project, which looks like leftover copy-paste but does not affect runtime behavior.

Instruction Scope

SKILL.md runtime steps are limited to fetching data from GitHub and rendering results. It suggests running the included Python scripts and optionally setting GH_TOKEN/TOPIC environment variables. One minor mismatch: SKILL.md shows 'cd skills/github-topics' which may not match where skill files are actually installed; this is an operational/documentation issue rather than a security problem.

Install Mechanism

No install spec; this is an instruction-only skill with bundled Python source. It only requires the 'requests' package per README. No downloads from arbitrary URLs or archive extraction were found.

Credentials

The code optionally reads GH_TOKEN and TOPIC from environment variables (both documented in SKILL.md). GH_TOKEN is optional and used only for higher GitHub API rate limits; no other secrets or unrelated credentials are requested. Registry metadata did not list required env vars, but that is consistent with GH_TOKEN being optional.

Persistence & Privilege

The skill does not request always:true and does not modify other skills or system-wide settings. It does network I/O to GitHub (expected) and writes no persistent configuration or credentials of its own.

Assessment

This skill appears to do what it says: query GitHub search and fetch README content. Before installing, consider: (1) GH_TOKEN is optional — if you supply one, create a token with the minimal scopes needed (read-only/public access) rather than a broad personal token. (2) The package contains only Python scripts that make outbound requests to api.github.com and raw.githubusercontent.com; this network activity is expected. (3) There's a minor documentation/metadata inconsistency (src/__init__.py mentions an unrelated project), which looks like leftover text but is not malicious. If you need stricter assurance, run the scripts in an isolated environment (container) or review/modify the code locally before use.

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

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