skill-curator

Files (1)

• SKILL.md

SKILL.md (first lines)

# Skill 收录评估器

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

## 工作流程

### 1. 规范化候选地址

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

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

### 2. 获取仓库事实

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

```bash
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 | 更新、维护者、许可证、测试 |

按风险扣 0–30 分。默认解释区间：

- `75–100`：建议收录
- `60–74`：谨慎收录，需要补充边界或证据
- `<60`：暂不收录

不要因 Star 低而自动拒绝，也不要因 Star 高而跳过资产核验。

## 输出格式

```markdown
## 候选资源核验报告

### 结论
- 建议：收录 / 谨慎收录 / 暂不收录 / 更新现有条目
- 推荐分类：分类名
- 总分：XX/100

From laolaoshiren/claude-code-skills-zh, MIT.

More from laolaoshiren/claude-code-skills-zh