skill-curator

Skill 收录评估器

对候选资源进行证据驱动的核验。不要只根据仓库简介、搜索摘要或 Star 做决定。

工作流程

1. 规范化候选地址

• 接受 GitHub 仓库、仓库子目录、PR、Issue 或用户提供的项目名。
• 从 tree/、blob/ 等子路径提取 owner/repo，同时保留指向独立 Skill 的原始子路径。
• 在当前精选列表中搜索仓库名、规范化 URL 和旧名称，判断是新增、重复还是已有条目更新。
• 遇到仓库重命名或转移时，使用最终规范地址，避免继续收录重定向 URL。

rg -n "owner/repo|项目名" README.md

2. 获取仓库事实

优先使用已认证的 GitHub CLI 获取只读信息：

gh repo view owner/repo \
  --json nameWithOwner,description,stargazerCount,forkCount,isArchived,isPrivate,createdAt,pushedAt,licenseInfo,url

gh api repos/owner/repo/contents \
  --jq '.[] | [.type,.name,.path] | @tsv'

gh api repos/owner/repo/contents/README.md \
  -H 'Accept: application/vnd.github.raw+json'

若 gh 不可用，可使用公开网页或其他只读方式核验，但必须说明哪些事实未能确认。

3. 核验真实资产和安装路径

至少确认一项可复用资产真实存在：

• SKILL.md 或 skills/
• .claude-plugin/plugin.json、marketplace 或 plugin 安装命令
• agents/、commands/、hooks 或可迁移的 AGENTS.md
• MCP Server、CLI、SDK 或明确的 Agent workflow
• 针对 Claude Code、Codex、Cursor、Gemini CLI、OpenClaw 等工具的安装说明

继续检查：

• README 是否说明前置条件、安装、配置和使用方式。
• 示例命令是否指向真实包名或路径。
• 仓库是否为空、仅有概念文案或只有营销页面。
• 子目录 Skill 是否可以独立安装；不能独立安装时优先收录仓库级地址。

4. 评估中文用户价值

从实际场景判断价值，而不是只看功能数量：

• 是否解决代码审查、测试、安全、文档、性能、DevOps、内容创作、办公自动化或知识管理等高频需求。
• 是否支持中文内容、国内平台、Windows 环境或中文团队常见工作流。
• 英文项目是否有足够清晰的安装路径，让中文用户无需二次研究即可使用。
• 与已收录项目相比，是否有新的场景、官方来源或明显更完整的实现。

建议分类只能从项目现有分类中选择：

• 明星技能
• 平台运营 / 自媒体 / 办公流量
• 开发效率
• 内容创作
• 学术科研
• AI Agent
• 金融 / 商业
• 中文专属

5. 检查风险和硬性淘汰条件

以下情况直接建议不收录：

• 404、私有、空仓库、明显模板或已归档且没有替代地址。
• 与 Agent Skills、Plugin、MCP 或 AI 编程工作流没有直接关系。
• 看不到实际资产、安装方式或可验证能力。
• 涉及盗号、恶意攻击、绕过付费、违法采集或明显侵权。
• 项目描述与仓库内容明显不符。

以下情况不一定淘汰，但必须显式提示：

• 强依赖商业 API、订阅、云端浏览器或第三方账号。
• 会自动发布内容、发送消息、操作交易或修改外部平台状态。
• 涉及爬虫、登录态、Cookie、Token、浏览器自动化或账号风控。
• 许可证不明确，或限制商业使用、再分发和修改。
• 刚创建、低 Star、长期未维护，或只由单个未经验证的服务支撑。

6. 评分并给出结论

使用 100 分制辅助判断，证据和硬性条件优先于总分：

维度	分值	判断重点
与 Agent 生态直接相关	25	明确支持的工具和工作流
可安装性	20	安装命令、前置条件、可复现性
真实资产	20	Skill、Plugin、Agent、MCP、CLI 等
文档完整度	15	README、示例、配置和边界
中文用户价值	10	高频场景、中文或国内生态适配
活跃度与可信度	10	更新、维护者、许可证、测试