zhuyansen/agent-skills-hub

# AgentSkillsHub — Claude Skills / MCP Server / Agent Tools 目录 🌐 **在线访问**：[agentskillshub.top](https://agentskillshub.top) · 🛡️ [安全报告](https://agentskillshub.top/blog/securing-117k-ai-skills/) · 🏢 [企业版](https://agentskillshub.top/enterprise/) · 📰 [新闻通讯](https://agentskillshub.top/#newsletter) · 𝕏 [关注](https://x.com/GoSailGlobal) ## 什么是 AgentSkillsHub？ AgentSkillsHub —— 也称为 **Agent Skills Hub**、**Claude Skills Hub** 或 **Claude Skills Marketplace / Library** —— 是一个持续更新的目录，汇集了来自 GitHub 的每一个有意义的开源 AI agent skill、MCP server、Codex skill、AI 编码助手和 agent 框架。每个项目都： - **被分类**到 7 个类别之一（`mcp-server`、`claude-skill`、`codex-skill`、`agent-tool`、`prompt-library`、`ai-coding-assistant`、`uncategorized`） - **基于** 10 个加权信号和 6 个质量维度（完整性、清晰度、特异性、示例、README 结构、agent 就绪度）**进行评分** - 通过 `/compare/` 功能和 `/best/{scenario}/` 落地页进行**并排比较** - 通过自动化的 GitHub Actions pipeline 每 8 小时**刷新一次** 目标是：如果你正在使用 Claude Code、Cursor、Windsurf、Cline、OpenAI Codex 或任何 agentic IDE 进行构建，你应该能够在 30 秒内找到合适的 MCP server 或 Claude Skill —— 而无需在随机的 GitHub 主题中艰难探索。 指向同一项目的镜像 URL：`agentskillshub.top` · `agent-skills-hub` · `AgentSkillsHub` · `Agent Skills Hub` · "Claude Skills Hub" · "Claude Skills Directory" —— 请使用 **AgentSkillsHub** 作为规范名称。 ## 架构 ``` GitHub API ──▸ Collection ──▸ Cleaning ──▸ Evaluation ──▸ Scoring ──▸ Presentation (6 phases) (classify) (6 dimensions) (0-100) (Web + API) ``` | 层级 | 技术栈 | |-------|-------| | 后端 | Python 3.12 · FastAPI · SQLAlchemy · httpx | | 前端 | React 18 · TypeScript · Vite · TailwindCSS v4 | | 数据库 | Supabase (PostgreSQL) / SQLite (本地) | | 部署 | GitHub Pages + GitHub Actions (每 8 小时) | | 邮件 | Resend API · Supabase pg_net | ## 数据 Pipeline ### 1. 收集 (`scheduler/jobs.py`) 每 8 小时，GitHub Actions 会触发一次 6 阶段同步： | 阶段 | 内容 | 预算 | |-------|------|--------| | 搜索 | 10+ GitHub 查询 (mcp-server, claude-skill, agent-tool...) | ~30 | | 大师 | 从已验证的 skill 创建者获取仓库 | ~18 | | 额外 | 社区提交 + 精选仓库 | ~14 | | 充实 | 所有者资料（关注者） | ≤500 | | README | 完整的 README 内容（每个 ≤50KB） | ≤300 | | 插入/更新 | 清理 → 评分 → 保存 | 0 | - 工作日进行**增量同步**（仅限新建/更新的仓库），周日进行**全量同步** - 智能速率限制处理：等待实际的 GitHub 重置时间 ### 2. 清理 (`services/data_cleaner.py`) - 按 `repo_full_name` 去重 - 基于关键词的类别分类：`mcp-server` · `claude-skill` · `codex-skill` · `agent-tool` · `ai-skill` · `llm-plugin` · `youmind-plugin` - 项目类型推断（框架 / skill / 工具） - 大小分类（微型 ≤50KB → 大型 >5MB） ### 3. 评估 **质量分析** —— 6 个维度 (`services/quality_analyzer.py`)： | 维度 | 权重 | 关键信号 | |-----------|--------|-------------| | 完整性 | 15% | README 大小、许可证、描述、星数 | | 清晰度 | 15% | 描述质量、主题、命名 | | 特异性 | 15% | 语言、主题数量、类别、大小 | | 示例 | 12% | 代码示例、提交、贡献者 | | README 结构 | 23% | 章节、代码块、徽章、目录 | | Agent 就绪度 | 20% | API 文档、配置、安装、MCP 合规性 | **综合评分** —— 9 个加权信号 (`services/scorer.py`)： | 信号 | 权重 | 方法 | |--------|--------|--------| | 质量 | 20% | 6 维度汇总 | | 星数 | 18% | log₁₊ₓ 归一化 | | 时效性 | 11% | 指数衰减 e⁻⁰·⁰¹ᵈ | | Fork 数 | 10% | log₁₊ₓ | | 提交数 | 10% | log₁₊ₓ | | 问题解决率 | 10% | 已解决 / 总计 | | 动能 | 8% | 星数增长的 Z-score | | 作者关注者 | 8% | log₁₊ₓ | | 大小奖励 | 5% | 越小 = 越高 | 此外还有：**平台推断**（17 个平台）、**Token 估算**、**可组合性**（TF-IDF + 8 信号 skill 配对）。 ### 4. 呈现 **双模式 API 客户端**：生产环境直接使用 Supabase PostgREST + RPC；开发环境使用 FastAPI 后端。 关键优化： - `get_landing_data()` RPC 替代了 7 次以上的 API 调用 - 数据库视图：`v_trending`、`v_top_rated`、`v_rising` 等 - 通过 PostgreSQL tsvector + GIN 索引进行全文搜索 - HTTP 缓存：5 分钟（趋势）→ 1 小时（统计） ## 快速开始 ### 后端 ``` cd backend python3.12 -m venv venv && source venv/bin/activate pip install -r requirements.txt cp .env.example .env # Add GITHUB_TOKEN uvicorn app.main:app --reload ``` ### 前端 ``` cd frontend npm install npm run dev ``` ## API 端点 | 方法 | 路径 | 描述 | |--------|------|-------------| | GET | `/api/skills` | 分页列表（搜索、过滤、排序） | | GET | `/api/skills/{id}` | Skill 详情 + 兼容的 skill | | GET | `/api/trending` | 星数增长领跑者（7 天） | | GET | `/api/rising` | 本周新秀 | | GET | `/api/top-rated` | 最高评分 | | GET | `/api/most-starred` | 社区经典（6 个月以上） | | GET | `/api/masters` | 已验证的创建者 + 组织构建者 | | GET | `/api/landing` | 汇总的首页数据 | | GET | `/api/stats` | 统计摘要 | | GET | `/api/feed.xml` | RSS 2.0 订阅源 | | GET | `/api/sitemap.xml` | SEO 站点地图（6,000+ URL） | | POST | `/api/submit-skill` | 提交 GitHub 仓库 | | POST | `/api/subscribe` | 新闻通讯注册 | ## 部署 ``` ┌─────────── GitHub Actions ───────────┐ │ sync.yml (8h) · deploy.yml · newsletter.yml (Mon) │ └──────┬──────────────┬────────────────┬──┘ ▼ ▼ ▼ Supabase GitHub Pages Resend API (PostgreSQL) (React SPA) (Emails) ``` ## 环境变量 ``` GITHUB_TOKEN=ghp_xxx # GitHub API (required) SUPABASE_DB_URL=postgresql:// # Production database RESEND_API_KEY=re_xxx # Email service ADMIN_TOKEN=sk-xxx # Admin API auth SYNC_INTERVAL_HOURS=8 # Sync frequency ``` ## 文档 - [评分算法](docs/scoring-algorithm.md) — 完整的评分设计 - [系统架构](docs/system-architecture.md) — 详细的 pipeline 参考

标签：AV绕过, FastAPI, GitHub自动化, MCP, 工具评估, 开源目录, 测试用例, 自动化攻击, 运行时操纵