Skills Trending Daily

自动追踪 skills.sh 技能排行榜，AI 智能分析，每日趋势报告邮件

目录

• 项目简介
• 功能特性
• 系统架构
• 快速开始
• 配置说明
• 使用方法
• GitHub Actions
• 数据模型
• 开发指南
• 常见问题

项目简介

Skills Trending Daily 是一个自动化技能趋势追踪系统。它每天从 skills.sh/trending 获取最新的技能排行榜，使用 Claude AI 对热门技能进行智能分析和分类，计算排名变化趋势，并通过 Resend 发送专业的 HTML 邮件报告。

为什么需要这个项目？

1. 开发者视角 - 快速了解哪些技能值得学习
2. 趋势洞察 - 捕捉新兴技术框架和工具的崛起
3. 智能总结 - AI 帮你理解每个技能解决什么问题
4. 自动化 - 无需手动查看网站，每天自动推送

功能特性

核心功能

邮件报告内容

Skills Trending Daily - 2026-01-24
├── Top 20 Leaderboard（含 AI 总结）
│   ├── 技能名称（可点击跳转）、排名、安装量
│   ├── AI 一句话摘要
│   ├── 详细说明
│   └── 解决的问题标签
├── Rising Skills（上升幅度 Top 5）
├── Declining Skills（下降幅度 Top 5）
├── New & Dropped（新晋/掉榜）
└── Trending Up（安装量暴涨告警）

系统架构

┌─────────────────────────────────────────────────────────────────┐
│                        Skills Trending 系统架构                   │
└─────────────────────────────────────────────────────────────────┘

  ┌──────────────┐      ┌──────────────┐      ┌──────────────┐
  │   GitHub     │      │   Playwright │      │    Claude    │
  │   Actions    │ ──▶ │  Skills      │ ──▶ │  Summarizer │
  │  (Cron Daily)│      │  Fetcher     │      │     AI       │
  └──────────────┘      └──────┬───────┘      └──────┬───────┘
                               │                     │
                               ▼                     │
                        ┌──────────────┐              │
                        │   Detail     │              │
                        │  Fetcher     │              │
                        │  (Top N)     │              │
                        └──────┬───────┘              │
                               │                       │
                               └───────┬───────────────┘
                                       │
                                       ▼
                               ┌──────────────┐
                               │  Database    │
                               │  (SQLite)    │
                               └──────┬───────┘
                                      │
                                      ▼
                               ┌──────────────┐
                               │   Trend      │
                               │  Analyzer    │
                               └──────┬───────┘
                                      │
                                      ▼
                               ┌──────────────┐
                               │   HTML       │
                               │  Reporter    │
                               └──────┬───────┘
                                      │
                                      ▼
                               ┌──────────────┐
                               │   Resend     │
                               │   Sender     │
                               └──────┬───────┘
                                      │
                                      ▼
                               ──────► 您的邮箱

快速开始

环境要求

• Python 3.11+
• Claude API Key（支持智谱代理）
• Resend API Key

安装

# 克隆仓库
git clone https://github.com/geekjourneyx/trending-skills.git
cd trending-skills

# 安装依赖
pip install -r requirements.txt

# 安装 Playwright 浏览器
playwright install chromium

配置

# 复制环境变量模板
cp .env.example .env

# 编辑 .env 文件，填入你的 API Keys
nano .env

运行

# 设置环境变量
export ZHIPU_API_KEY="your_api_key"
export RESEND_API_KEY="your_resend_key"
export EMAIL_TO="[email protected]"

# 运行
python src/main_trending.py

配置说明

环境变量

Resend 配置

1. 注册 Resend
2. 创建 API Key
3. 配置发件人域名（或使用默认的 [email protected]）

使用方法

命令行运行

# 完整流程
python src/main_trending.py

数据库查询

# 查看最新数据日期
sqlite3 data/trends.db "SELECT date FROM skills_daily ORDER BY date DESC LIMIT 1;"

# 查看今日排行榜 Top 10
sqlite3 data/trends.db "SELECT rank, name, installs FROM skills_daily WHERE date = '2026-01-24' ORDER BY rank LIMIT 10;"

# 查看技能详情
sqlite3 data/trends.db "SELECT name, summary, category FROM skills_details WHERE name = 'remotion-best-practices';"

GitHub Actions

自动化部署

1. Fork 本仓库
2. 在 GitHub Settings > Secrets and variables > Actions 中添加：
   • ZHIPU_API_KEY
   • RESEND_API_KEY
   • EMAIL_TO（可选）
3. 启用 Actions

定时执行

默认每天 UTC 02:00（北京时间 10:00）自动运行。

修改时间：编辑 .github/workflows/skills-trending.yml 中的 cron 表达式。

手动触发

在 GitHub Actions 页面点击 "Run workflow" 按钮手动执行。

数据模型

skills_daily - 每日快照

skills_details - 技能详情

skills_history - 历史趋势

开发指南

项目结构

skills-trending/
├── .github/workflows/
│   └── skills-trending.yml    # GitHub Actions 配置
├── src/
│   ├── config.py              # 配置管理
│   ├── database.py            # SQLite 操作
│   ├── skills_fetcher.py      # 榜单抓取（Playwright）
│   ├── detail_fetcher.py      # 详情抓取
│   ├── claude_summarizer.py   # AI 分析
│   ├── trend_analyzer.py      # 趋势计算
│   ├── html_reporter.py       # 邮件生成
│   ├── resend_sender.py       # 邮件发送
│   └── main_trending.py       # 主入口
├── plugins/
│   └── trending-skills/       # Claude Code Skill
├── data/
│   └── trends.db              # 数据库（运行时生成）
├── requirements.txt
├── .env.example
├── CHANGELOG.md
└── README.md

核心模块说明

扩展开发

新增数据源

# 修改 skills_fetcher.py
class SkillsFetcher:
    def __init__(self, timeout: int = 30000):
        self.trending_url = "your_custom_url"

新增分析维度

# 修改 trend_analyzer.py
def calculate_trends(self, today_skills, today, ai_summary_map):
    # 添加新的分析逻辑
    pass

自定义邮件样式

# 修改 html_reporter.py
def _get_header(self, date: str) -> str:
    # 修改样式和布局
    pass

常见问题

邮件没有收到？

1. 检查 Resend API Key 是否正确
2. 确认收件人邮箱地址
3. 查看垃圾邮件箱
4. 检查 GitHub Actions 日志

Playwright 浏览器安装失败？

# 重新安装
playwright install chromium --with-deps

数据库文件在哪里？

默认位置：data/trends.db

如何查看历史数据？

sqlite3 data/trends.db
.tables
SELECT * FROM skills_daily ORDER BY date DESC LIMIT 10;

如何更改运行时间？

编辑 .github/workflows/skills-trending.yml：

schedule:
  - cron: '0 2 * * *'  # UTC 时间，每天 02:00

打赏 Buy Me A Coffee

如果该项目帮助了您，请作者喝杯咖啡吧

WeChat

作者

• 作者: geekjourneyx
• X (Twitter): https://x.com/seekjourney
• 公众号: 极客杰尼

关注公众号，获取更多 AI 编程、AI 工具与 AI 出海建站的实战分享：

License

MIT

致谢

• skills.sh - 技能数据来源
• Anthropic - Claude AI
• Resend - 邮件服务
• Playwright - 浏览器自动化