功能描述

Search and analyze trending GitHub repositories by topics, star count, and creation date. Supports filtering by multiple tags, minimum stars, and time range....

使用说明 (SKILL.md)

GitHub Projects Explorer

Name: GitHub Projects Explorer
Author: manifoldor

Discover and analyze trending open-source projects on GitHub, with support for multi-dimensional search and filtering.

Features

🏷️ Multi-Tag Filtering - Support for one or more project topics/tags
⭐ Star Count Filtering - Filter by a minimum number of stars
📅 Time Range - Filter projects created within the last N days
🔤 Programming Language - Filter by specific programming language
📊 Smart Sorting - Sort by Stars, Forks, or Updated Time

Prerequisites

Optional: Configure GitHub Token

The GitHub API has rate limits (60 requests/hour unauthenticated, 5000 requests/hour authenticated).

# Get a Token: https://github.com/settings/tokens
export GITHUB_TOKEN="your_github_token"

To add it permanently to ~/.zshrc:

echo 'export GITHUB_TOKEN="your-token"' >> ~/.zshrc
source ~/.zshrc

Usage

Basic Search

Search by Topic:

python3 scripts/github_projects.py --topic python

Multiple Topics (AND relation):

python3 scripts/github_projects.py --topic python --topic machine-learning

Filter by Star Count

# Find Python projects with Stars > 1000
python3 scripts/github_projects.py --topic python --stars 1000

# Find AI projects with Stars > 10000
python3 scripts/github_projects.py --topic ai --stars 10000

Filter by Time (Last N Days)

# Python projects created in the last 30 days
python3 scripts/github_projects.py --topic python --days 30

# High-star AI projects created in the last 7 days
python3 scripts/github_projects.py --topic ai --stars 100 --days 7

Filter by Programming Language

# Rust projects
python3 scripts/github_projects.py --lang rust --stars 1000

# Go projects
python3 scripts/github_projects.py --lang go --stars 500 --days 30

# TypeScript projects
python3 scripts/github_projects.py --lang typescript --topic react --stars 500

Comprehensive Examples

# AI Projects: Last 30 days, Python, Stars > 500
python3 scripts/github_projects.py \
  --topic ai --topic python \
  --stars 500 \
  --days 30

# Rust Tools: High stars, Last 90 days
python3 scripts/github_projects.py \
  --topic rust \
  --stars 5000 \
  --days 90 \
  --limit 50

# Frontend Frameworks: JavaScript, Stars > 1000
python3 scripts/github_projects.py \
  --topic frontend \
  --lang javascript \
  --stars 1000 \
  --sort updated

Output Format

Example Output:

🔥 Found 30 trending projects:

1. 🌟 facebook/react
   📝 A declarative, efficient, and flexible JavaScript library...
   🔗 https://github.com/facebook/react
   📊 Stars: 220,000 | Forks: 45,000 | Language: JavaScript
   🏷️  Tags: react, frontend, javascript
   📅 Created: 2013-05-24 | Updated: 2024-02-03

2. ⭐ microsoft/vscode
   📝 Visual Studio Code
   🔗 https://github.com/microsoft/vscode
   📊 Stars: 150,000 | Forks: 30,000 | Language: TypeScript
   ...

Command Arguments

Argument	Short	Description	Example
`--topic`	`-t`	Project topic/tag (can be used multiple times)	`-t python -t ai`
`--stars`	`-s`	Minimum number of stars	`--stars 1000`
`--days`	`-d`	Created within the last N days	`--days 30`
`--lang`	`-l`	Programming language	`--lang rust`
`--limit`	-	Number of results to return (default: 30)	`--limit 50`
`--sort`	-	Sorting method	`--sort stars`

Sorting Options

stars - By star count (default, descending)
forks - By fork count
updated - By recent update time
created - By creation time

Recommended Trending Tags

Domain	Recommended Tags
AI/ML	`ai`, `machine-learning`, `deep-learning`, `nlp`, `computer-vision`
Frontend	`frontend`, `react`, `vue`, `angular`, `javascript`, `typescript`
Backend	`backend`, `api`, `microservices`, `nodejs`, `python`
Mobile Dev	`mobile`, `ios`, `android`, `flutter`, `react-native`
DevOps	`devops`, `docker`, `kubernetes`, `ci-cd`, `terraform`
Data	`database`, `big-data`, `analytics`, `sql`, `nosql`
Security	`security`, `cybersecurity`, `penetration-testing`
Tools	`cli`, `tools`, `productivity`, `automation`

FAQ

Error: API rate limit exceeded → Set GITHUB_TOKEN to increase limits:

export GITHUB_TOKEN="your-token"

No results returned → Try loosening your search criteria:

Lower the --stars threshold
Increase the --days count
Reduce the number of --topic tags

Inaccurate search results → Use more specific tags:

Use machine-learning instead of ml
Use natural-language-processing instead of nlp

Use Cases

Scenario 1: Track Emerging Tech

# Trending AI projects from the last 30 days
python3 scripts/github_projects.py --topic ai --stars 100 --days 30 --limit 50

Scenario 2: Learn from Top Projects

# High-star Python projects
python3 scripts/github_projects.py --topic python --stars 10000 --limit 20

Scenario 3: Discover New Tools

# Developer tools from the last 7 days
python3 scripts/github_projects.py --topic developer-tools --topic cli --days 7 --stars 50

Scenario 4: Tech Research

# Compare web frameworks across different languages
python3 scripts/github_projects.py --topic web-framework --lang rust --stars 1000
python3 scripts/github_projects.py --topic web-framework --lang go --stars 1000

References

GitHub Search API: references/github_api.md
Official GitHub Docs: https://docs.github.com/en/rest/search

安全使用建议

This skill appears coherent and implements only GitHub search functionality. Before running: (1) review the included Python script (it uses only the Python stdlib and calls api.github.com); (2) prefer exporting GITHUB_TOKEN in a secure session (export GITHUB_TOKEN=...) rather than echoing it into shell rc files if you want to avoid storing secrets in plaintext configs; (3) create a token with minimal privileges (searching public repos does not require repo scopes) and avoid pasting tokens into logs or screenshots. If you need stronger isolation, run the script in a disposable environment (container/VM).

功能分析

Type: OpenClaw Skill Name: explorer Version: 1.0.6 The 'explorer' skill is a legitimate tool for searching and analyzing GitHub repositories via the official GitHub Search API. The Python script (scripts/github_projects.py) uses standard libraries to perform authenticated or unauthenticated API requests and contains no evidence of data exfiltration, malicious execution, or obfuscation. While the documentation (SKILL.md) suggests adding a GITHUB_TOKEN to shell configuration files for rate-limiting purposes, this is a transparent user instruction rather than an automated or hidden malicious action.

能力评估

✓ Purpose & Capability

Name/description (discover GitHub repos) align with the included Python script and reference doc. All required functionality (topic, stars, days, lang, sort) is implemented and justified.

ℹ Instruction Scope

SKILL.md and the script are narrowly scoped to building and issuing GitHub search requests. The only actionable system instruction suggested is optionally exporting GITHUB_TOKEN (including an example that appends it to ~/.zshrc) — standard but worth noting because it writes a secret to a shell rc file if followed verbatim.

✓ Install Mechanism

No install spec; this is instruction-only with a small Python script that uses the standard library (urllib). Nothing is downloaded or written by the skill itself during installation.

✓ Credentials

No required env vars are declared; the only optional environment variable used is GITHUB_TOKEN, which is appropriate and expected for increasing GitHub API rate limits. No other credentials or unrelated environment access is requested.

✓ Persistence & Privilege

Skill does not request always:true, does not modify other skills or system-wide settings, and runs as a one-off script. The only persistence hinted in docs is an optional user action (adding GITHUB_TOKEN to ~/.zshrc).

版本历史

v1.0.6

- All user documentation updated to English for broader accessibility. - Feature descriptions, command usage, parameters, and examples have been revised for clarity. - The FAQ, use case scenarios, and recommended tags sections are now in English. - No new features or code changes; documentation update only.

v1.0.5

- Initial release of GitHub Projects Explorer (version 1.0.0). - Search and filter trending open-source projects on GitHub by topic, star count, creation date, programming language, and tags. - Supports multiple tag filters, star and date ranges, and smart sorting by stars, forks, update date, or creation date. - Optional GitHub token support for higher API rate limits. - Provides clear usage instructions, example commands, and suggestions for common scenarios and troubleshooting.

v1.0.0

- Initial release of "explorer": A skill to search and analyze trending GitHub repositories by topics, stars, and creation date. - Supports filtering by multiple tags, minimum star count, and custom time ranges (recent N days). - Additional filters for programming language and intelligent sorting (stars/forks/update/creation date). - Optional use of GitHub personal token for higher API rate limits. - Includes detailed usage instructions and example search commands for various scenarios. - Provides parameter summary, popular tag recommendations, troubleshooting tips, and practical use cases.

元数据

Slug explorer

版本 1.0.6

许可证 MIT-0

累计安装 6

当前安装数 6

历史版本数 3

常见问题