---
captured_at: 2026-04-23T14:43Z
source: agent 深度调研（WebFetch 官方站 + GitHub 源码 + Vercel changelog + Snyk blog + community forum）
captured_by: general-purpose agent
---

# skills.sh 深度调研 — 2026-04-23

## ⚠️ 产品真实性核实（先把幻觉风险排掉）

| URL | 状态 | 证据 |
|---|---|---|
| https://skills.sh | ✓ 真实 | 返回 "The Agent Skills Directory"，head 有 Skills / Official / Audits / Docs 四 tab，leaderboard 显示 "91,043 total skills" |
| https://skills.sh/docs | ✓ 真实 | 文档页，提 `npx skills add vercel-labs/agent-skills` + "anonymous telemetry data collected from the skills CLI" |
| https://skills.sh/audits | ✓ 真实 | 公开审计页，逐个 skill 列 Gen / Socket / Snyk 三家扫描结果 |
| https://github.com/vercel-labs/skills | ✓ 真实 | 15.7k stars，TypeScript，MIT，最新 release v1.5.1 (2026-04-17) |
| https://github.com/vercel-labs/agent-skills | ✓ 真实 | Vercel 官方 skill 合集仓 |
| https://agentskills.io | ✓ 真实 | 独立于 Vercel 的开放 spec 站（skills-ref validator + 规范 + best practices） |
| https://vercel.com/docs/agent-resources/skills | ✓ 真实 | Vercel 官方文档 |
| https://vercel.com/changelog/introducing-skills-the-open-agent-skills-ecosystem | ✓ 真实 | 发布 changelog |
| https://vercel.com/changelog/automated-security-audits-now-available-for-skills-sh | ✓ 真实 | 2026-02-17 安全审计 GA |
| https://skills.sh/acong-tech-skills/xiangqin | ✗ 404 | xiangqin skill 目前 **未出现**在 skills.sh 目录 |
| https://skills.sh/acong-tech-skills | ✗ 404 | owner 页也不存在 |

**结论**：skills.sh 是 Vercel 在 2026-01-20 发布的真实产品。前置研究里所有 skills.sh URL 都真实存在，没有幻觉。但老板说的"两个分发渠道"里的"skills.sh 还是 open cloud cloud hub"语音识别确实有歧义——**skills.sh 和 ClawHub（clawhub.ai / OpenClaw 生态）是两个独立产品**：

- **skills.sh** = Vercel 的开放注册表（本文主角）
- **ClawHub** = OpenClaw 系的独立注册表（有中国镜像 clawcn.net）
- xiangqin 的 release.yml 同时跑 `sync-skills-sh`（推到 `acong-tech-skills/xiangqin` GitHub 仓）+ `publish-clawhub`（调 `clawhub publish`）两个分发 job

`acong-tech-skills/xiangqin` 是 skills.sh 的分发源 repo（公开，只有 SKILL.md + README.md，2026-04-22 创建）。但 **skills.sh 目前未索引到它**——后面会详述发现机制为什么它没进目录。

---

## 引用的 source URL（校验过的官方源）

- ✓ [skills.sh 主页](https://skills.sh)
- ✓ [skills.sh 文档](https://skills.sh/docs)
- ✓ [skills.sh 审计页](https://skills.sh/audits)
- ✓ [vercel-labs/skills CLI 仓](https://github.com/vercel-labs/skills)（README 479 行 + src/ TypeScript 源码直读）
- ✓ [vercel-labs/agent-skills 合集仓](https://github.com/vercel-labs/agent-skills)
- ✓ [Vercel 官方 skills 文档](https://vercel.com/docs/agent-resources/skills)
- ✓ [Vercel KB: Creating, Installing, Sharing Skills](https://vercel.com/kb/guide/agent-skills-creating-installing-and-sharing-reusable-agent-context)
- ✓ [Vercel changelog - Introducing Skills](https://vercel.com/changelog/introducing-skills-the-open-agent-skills-ecosystem)（2026-01-20 发布）
- ✓ [Vercel changelog - Automated Security Audits](https://vercel.com/changelog/automated-security-audits-now-available-for-skills-sh)（2026-02-17）
- ✓ [agentskills.io/specification](https://agentskills.io/specification)（format 正式规范）
- ✓ [Snyk blog - Securing Agent Skill Ecosystem](https://snyk.io/blog/snyk-vercel-securing-agent-skill-ecosystem/)
- ✓ [InfoQ 报道](https://www.infoq.com/news/2026/02/vercel-agent-skills/)
- ⚠️ [Vercel community - 申请下架](https://community.vercel.com/t/removing-a-skill-from-the-skills-sh-list/35562)（只有 Vercel 员工"告诉我哪个"式的人工回复，无政策文档）
- ⚠️ [Vercel community - 已删 skill 还在显示 + 新 skill 搜不到](https://community.vercel.com/t/why-is-a-deleted-skill-still-listed-on-skills-sh-and-new-ones-not-showing-in-search/38998)（无官方回复）

---

## 1. 分发方式（Distribution）

### 装 skill 的唯一入口：`npx skills` CLI

- **单命令**：`npx skills add <owner/repo>`（示例：`npx skills add vercel-labs/agent-skills`）
- 源码：https://github.com/vercel-labs/skills ，MIT，TypeScript，15.7k stars
- 当前版本 v1.5.1（2026-04-17）；发版节奏 1-2 周一个 patch（近 5 个 tag 覆盖 2026-03-31 → 2026-04-17）
- `npx skills` 适配 **44+ agent runtime**（Claude Code / Cursor / Codex / OpenCode / Gemini / Kiro / OpenClaw …），每家装到各自目录（e.g. Claude Code → `.claude/skills/` 或 `~/.claude/skills/`）

### 支持的 source URL 形态（`src/source-parser.ts`）

1. `owner/repo`（GitHub shorthand）
2. `https://github.com/owner/repo`
3. `https://github.com/owner/repo/tree/<branch>`（提取 branch 作 ref）
4. `https://github.com/owner/repo/tree/<branch>/<skill-path>`（子目录定位）
5. `github:owner/repo`
6. `https://gitlab.com/...`、`gitlab:owner/repo`（GitLab 原生支持）
7. `git@github.com:owner/repo.git`（SSH）
8. 任意 git URL
9. **本地路径** `./my-skill`（不需要远端仓）
10. **Fragment 语法支持版本锁定**：`owner/repo#v1.2.3` 或 `owner/repo#branch` — fragment 部分在 `source-parser.ts` 里被识别为 git ref
11. **Fragment + skill filter**：`owner/repo#v1.2.3@skill-name`

### 版本/Git Tag 关系 — 这里有坑

- 默认行为：`git clone --depth 1`，**不指定 ref**，拉 GitHub 默认分支（main / master）的 HEAD —— **git tag 默认被忽略**
- 要装指定 tag 必须显式写：`npx skills add owner/repo#v1.0.0`
- `git.ts` 里 timeout 60s，`GIT_LFS_SKIP_SMUDGE=1` 跳 LFS
- 升级：`npx skills update <skill>` 按 skill lock 里记的 ref 拉同一分支最新 HEAD
- lock 文件 `$XDG_STATE_HOME/skills/.skill-lock.json`（schema v3），每条 skill 记：`source` / `sourceType` / `sourceUrl` / `ref`（branch 或 tag）/ `skillPath` / `skillFolderHash`（GitHub tree SHA，用于检测文件夹变更）/ `installedAt` / `updatedAt`
- 对 xiangqin 的含义：release.yml 打的 `vX.Y.Z` git tag **不是用户默认装的东西**。用户 `npx skills add acong-tech-skills/xiangqin` 拿到的是 main HEAD。要让用户锁版本，得让用户写 `npx skills add acong-tech-skills/xiangqin#v0.x.y`——这件事官方文档**压根没讲**，绝大多数用户不会这么写

### Fork / 私有仓支持

- **Fork**：完全支持，fork 出来改了照常 `npx skills add <your-fork-owner>/<repo>` 即可
- **私有仓**：CLI 走 `simple-git` clone，SSH URL 走用户本机 SSH 配置；HTTPS 私有需本机已配好 credential helper；CLI 自身**没有 token/认证机制**。所以私有仓装得了，但不会出现在 skills.sh 目录里（telemetry 里虽然会上报 source，但目录页不公开私有仓）

### Install telemetry（排名的唯一信号源）

源码 `src/telemetry.ts` 读出的细节：

- **Endpoint**：`https://add-skill.vercel.sh/t`（POST，fire-and-forget）
- **上报事件**：5 种 —— `install` / `remove` / `update` / `find` / `experimental_sync`
- **每个事件公共字段**：CLI version、is_ci flag
- **install 事件字段**：`source`（e.g. `acong-tech-skills/xiangqin`）/ `skills`（skill 名列表）/ `agents`（装到哪些 agent）/ `sourceType`（github/gitlab/local）/ `global`（-g flag）/ `skillFiles`
- **find 事件**：`query` / `resultCount` / `interactive`
- **关键**：**没有 machine id / session id / repo id / user id**——纯 anonymous，每次独立
- CI 环境自动关；`DISABLE_TELEMETRY=1` / `DO_NOT_TRACK` 可手动关
- **这就是 leaderboard 的唯一输入**。排名不看 stars、不看 issues、不看 commit 活跃度，只看未关闭 telemetry 的用户装了多少次

### 安装范围 & 模式

| Scope | Flag | 路径（Claude Code） |
|---|---|---|
| Project | 默认 | `.claude/skills/` |
| Global | `-g` | `~/.claude/skills/` |

- 安装方式：**symlink**（默认，推荐）vs `--copy`（独立副本）。symlink 法指向一个 canonical copy，多 agent 共用同一份文件
- 跨 agent 通用格式：SKILL.md 格式统一；agent-specific 的 `context: fork` / hooks 只 Claude Code 支持

---

## 2. 格式要求（Format）

### 必要文件 —— 就 1 个

**唯一必须的文件：`SKILL.md`**（spec: https://agentskills.io/specification）

```
skill-name/
├── SKILL.md          # 必须
├── scripts/          # 可选，可执行脚本
├── references/       # 可选，额外文档
├── assets/           # 可选，模板/图片/数据
└── ...               # 任意其他文件
```

- 目录名必须等于 frontmatter 的 `name`
- **README.md 可有可无**（CLI 不读 README，只认 SKILL.md；但 skills.sh skill 详情页渲染 README — 后面会讲）

### SKILL.md Frontmatter 字段（spec v1）

| 字段 | 必填 | 约束 |
|---|---|---|
| `name` | ✓ | 1-64 字符，**只能** `a-z` 小写 + `0-9` + `-`，不能 `-` 开头/结尾，不能连续 `--`，必须等于父目录名 |
| `description` | ✓ | 1-1024 字符，非空，应"描述做什么 + 什么时候用"，含关键词辅助 agent 路由 |
| `license` | ✗ | license 名或指向 bundled license 文件 |
| `compatibility` | ✗ | 1-500 字符，列环境要求（intended product / 系统依赖 / 网络访问等） |
| `metadata` | ✗ | 任意 string→string map，spec 建议用 unique key 避冲突，常见装 `version` / `author` |
| `allowed-tools` | ✗ | 实验特性，空格分隔的预授权工具列表 e.g. `Bash(git:*) Read` |

vercel-labs/skills README 里还提到一个 **非 spec 的扩展**：`metadata.internal: true` —— 默认隐藏，只在 `INSTALL_INTERNAL_SKILLS=1` 时才被 list/install。适合 WIP skill。

### body 建议结构（非强制）

spec 推荐：step-by-step 指令 / 输入输出示例 / edge cases。**正文 < 500 行 / < 5000 tokens** — 超过要拆到 `references/` 子文件，否则 agent 激活时一次性全读 context 炸。

### Progressive Disclosure 三档（spec 核心概念）

1. **Metadata**（~100 token）：name + description，所有 skill 启动时都加载
2. **Instructions**（<5000 token）：SKILL.md 正文，skill 被激活时加载
3. **Resources**（按需）：scripts/ references/ assets/ 下的文件，agent 明确引用时才读

### Package（多 skill 仓）

- **skill** = 一个含 SKILL.md 的文件夹
- **skill package** = 一个含 ≥1 个 skill 的 git repo
- 多 skill 仓的发现路径（`src/skills.ts` 硬编码搜索）：根目录（如果根有 SKILL.md）、`skills/`、`skills/.curated/`、`skills/.experimental/`、`skills/.system/`、以及 38 种 agent-specific 目录（`.claude/skills/` / `.cursor/skills/` / 等）
- 如果都没命中，**fallback 递归搜索全仓**
- 也读 Claude Code 的 `.claude-plugin/marketplace.json` 和 `.claude-plugin/plugin.json` 里 `skills` 字段

### 被 skills.sh 扫描 / 收录的条件

这是文档**没明确公开**的暗规则，只能从行为推断：

- **仓是 public** —— 私有仓 telemetry 也上报，但目录不公开（见社区帖 38998）
- **CLI 装过至少 1 次** —— 因为 skills.sh leaderboard 的唯一输入是 telemetry。没人装过 → 不出现
- **没有官方 "提交 / submit" 入口**。官方原文："To share your own skills, you simply put them in a git repo and share it. When people install it via `npx skills add`, it can show up on skills.sh automatically via install telemetry, with no registry submission flow required."
- **特定 topic 或文件**：无要求。CLI 不看仓 topic、license、stars
- 经验证据：xiangqin 已推到 `acong-tech-skills/xiangqin`（public、SKILL.md 合规、README 齐全），但 https://skills.sh/acong-tech-skills/xiangqin 返回 404 —— 说明还**没人用 `npx skills add` 装过**（或 telemetry 还没 flush 到目录）

---

## 3. 安全检测（Security）—— 比想象中严

### 2026-02-17 上线的自动化审计（非 GitHub Advanced Security 联动）

source: https://vercel.com/changelog/automated-security-audits-now-available-for-skills-sh 、https://snyk.io/blog/snyk-vercel-securing-agent-skill-ecosystem/

**跟 GitHub Advanced Security 无关**。Vercel 自己 pipeline + 三家独立 SaaS 合作伙伴扫：

| 扫描方 | 覆盖 | 产出 |
|---|---|---|
| **Gen Agent Trust Hub** | 通用 agent skill 威胁（Gen Digital / Norton LifeLock 系） | Safe / 非 Safe（配 alert 数） |
| **Socket** | 跨生态静态分析 + LLM 噪声抑制，号称 95% precision / 98% recall / 97% F1 | alert 数（0-N） |
| **Snyk** | 8 类安全策略：恶意代码、prompt injection、可疑下载 URL、凭证暴露、第三方内容、间接 prompt injection 等 | Low / Medium / High / Critical 风险等级 |

### 扫描触发时机

Snyk 明确："every time a new agent skill is installed using the npx skills installer, Vercel's infrastructure calls out to Snyk's high-throughput API **before it ever reaches a developer's machine**" —— **install-time 扫描**，不是 publish-time。

这意味着：

- 你推代码到 GitHub → 啥事没发生
- 第一次有人 `npx skills add <你的>` → Vercel 的接收端 endpoint 同步调 Snyk API → 结果写回 skills.sh 详情页 + audits 页
- 所以 `acong-tech-skills/xiangqin` 现在审计页上还没条目（没人装过）

### 标识与处置

- skills.sh 详情页挂 **"Security Verified" 徽章**
- "Skills flagged as malicious are **automatically hidden** from the leaderboard and search results"
- 直连 URL 仍可访问，但**装前弹警告**
- skills CLI v1.4.0+ 在 `add` 时把 audit result + risk level 直接显示给用户，用户可选不装

### 防垃圾机制

- 没有速率限制 / registration gate / 账号龄要求（不同于 ClawHub 的 "GitHub 账号 ≥1 周"）
- 纯靠**装机触发 + 三家审计**去过滤垃圾；没装机的垃圾仓干脆不被收录，收录的扫描一次标红
- 官方免责声明（/docs 页）："We cannot guarantee the quality or security of every skill listed on skills.sh. We encourage you to review skills before installing."

### 安全报告

- 报告安全问题：https://security.vercel.com（Vercel VRP 通道）
- GitHub 侧 `acong-tech-skills/xiangqin` 当前所有 `security_and_analysis` 字段（secret scanning / dependabot）都 disabled —— 对分发影响 0（skills.sh 不看这些），但作为 good practice 可以开

---

## 4. 搜索机制（Search）

### 技术底座（从 `src/find.ts` 源码读出）

- `npx skills find <query>` → HTTP GET `https://skills.sh/api/search?q=<url-encoded>&limit=10`
- **关键词搜索，不是向量**。服务端细节不公开，但客户端只做 URL 编码 + 发查询，无 embedding 参与
- 返回结果按 `installs` 降序排序（客户端 `.sort((a, b) => (b.installs || 0) - (a.installs || 0))`）
- interactive 模式 = fzf 式实时搜索（打字 debounce 后触发 API）
- non-interactive 模式 = 单次查询输出

### 索引字段（推断）

官方没公开。合理推断：`SKILL.md` 的 `name` + `description` 是硬拉字段（因为 leaderboard 入库必然带这俩）。README 是否被索引、是否有 field boost、是否走 full-text fuzzy —— **无文档可查**。

### 排序因子

文档：**"leaderboard ranks skills based on anonymous telemetry data collected from the skills CLI"**

- 主排名：**install 计数**（来自 `src/telemetry.ts` 的 install 事件）
- leaderboard 三档：
  - **All Time**（累计装机，91,043 total skills）
  - **Trending**（24h 装机）
  - **Hot**（近期热度，具体窗口未公开）
- 唯一信号就是装机；**stars / issues / 时间衰减 / 质量分都不参与**

### 中文支持程度

- `encodeURIComponent` 对中文 UTF-8 合法 —— 客户端侧可以发中文 query 不崩
- **服务端中文分词能力：文档零披露**，leaderboard Top 273 目测全英文，没有中文 skill 样本可参考
- xiangqin 的 description 已是中文，入库后是否被关键词搜索命中"相亲"取决于服务端是否对 CJK 分词（默认 Postgres-like ts_vector 不分词，会整段当一个 token）
- 实验思路：skill 收录后搜 "相亲"、"xiangqin"、"matchmaker" 分别测命中，才能判断中文 index 能力

### 陷阱：新 skill / 改名 skill 索引滞后

community 帖 38998 明确提到：

- 仓 rename 后 **不会自动重新索引**
- 某些现役 skill "are not discoverable via search on skills.sh"（报告者原话）
- Vercel 员工未回复

含义：xiangqin 即便有人装了之后被收录，一旦改了 slug / rename 仓，老条目可能留尸体 + 新条目搜不到。

---

## 5. 审核机制（Moderation）

### 发布流程：零审核

- **没有 submit 入口 / approval queue / 人工 review 门槛**
- 发布步骤就俩：(1) push 到公开 git 仓；(2) 有人 `npx skills add` → 自动进目录
- Vercel 官方说法（/docs）："We do our best to maintain a safe ecosystem, but we cannot guarantee the quality or security of every skill"
- 跟 ClawHub 的 "发布即上线 + VirusTotal 扫 + 社区举报 + moderator 操作" 相比，**skills.sh 更轻、更被动**

### 自动 vs 人审

- **主力自动**：install-time 三家审计（Gen / Socket / Snyk），malicious 自动隐藏 + 装前警告
- **人审只在下架场景**：见 community 帖 35562，用户要下架自己的 skill，得在 Vercel community 发帖 @ 工作人员（Andrew Qu），由工作人员手动从目录删
- **无公开下架政策文档 / 无申诉流程文档 / 无政策红线清单**

### 政策红线

- Vercel 没发过 content policy 文档具体针对 skills.sh
- 走通用 Vercel TOS + security.vercel.com 报恶意
- 对比 ClawHub 的 `/about` 页明确列了 6 类硬禁（安全绕过 / 欺诈 / 隐私侵犯 / 非同意仿冒 / 性内容 / 混淆执行）—— skills.sh **无此颗粒度政策**

### 下架 & 申诉

| 问题 | 现状 | 证据 |
|---|---|---|
| 如何下架自己的 skill | 在 community 发帖 + @ Vercel staff | [帖子 35562](https://community.vercel.com/t/removing-a-skill-from-the-skills-sh-list/35562) |
| 已删仓的 skill 是否自动清 | **不会**，人工联系才清 | [帖子 38998](https://community.vercel.com/t/why-is-a-deleted-skill-still-listed-on-skills-sh-and-new-ones-not-showing-in-search/38998) |
| 申诉下架（malicious 误标） | 无文档化流程 | —— |
| 第三方举报 | security.vercel.com 通道 | /docs 页 |

---

## 对 xiangqin 的结论更新（基于深度事实）

### 关于"两渠道"说法的校正

老板说的"两个分发渠道"**确实是两个真实存在的独立产品**：
- **skills.sh**（Vercel 系，本文深调）
- **ClawHub**（OpenClaw 系，前一份 report 已覆盖）

release.yml 已正确实现了双推（`sync-skills-sh` + `publish-clawhub`），机制上没错。

### 新发现的操作隐患（可落地改 workflow）

1. **skills.sh 目前未收录 xiangqin** — `acong-tech-skills/xiangqin` 仓推了，但 https://skills.sh/acong-tech-skills/xiangqin 404。因为 skills.sh 的索引信号是"有人用 `npx skills add` 装过"，push 完不等于入库。**缺一步冷启动**：`npx skills add acong-tech-skills/xiangqin` 自己装一次 + 关闭 CI telemetry 屏蔽 bug 跑几次，才能出现在目录

2. **git tag 默认失效** — release.yml 打 `v*.*.*` tag 是对的，但用户 `npx skills add acong-tech-skills/xiangqin` 拿到的是 main HEAD，**不是 tagged 版本**。要么（a）把 SKILL.md 只在 tag 前验证过的稳定点同步到 main（当前做法）—— 等同于 main = latest stable；要么（b）README 里教用户写 `#v0.x.y`（绝大多数用户不会写）；结论：main 必须始终代表"最新稳定"，不能 push WIP，否则破坏用户体验

3. **Install-time Snyk/Socket/Gen 扫描会看 SKILL.md 正文** — prompt injection / 可疑 URL / 凭证这类即使在"说明文档"里都被扫。中文内容会被扫吗文档没说；如果扫描器只认英文 prompt injection 模式，中文反而可能"误伤 less"，但**万一标红 → 自动从 leaderboard 隐藏 + 装前警告**，跟 ClawHub 出现过的 ClawHavoc / VirusTotal Benign 踩坑是同一类风险。**首次被扫前先自审一遍 SKILL.md，去掉任何看起来像 credential template 的占位符**

4. **中文搜索可能废** — leaderboard Top 273 全英文，"相亲" 是不是能被 skills.sh 的 keyword search 命中不确定。**验证方法**：等 xiangqin 入库后（冷启动装一次触发），分别搜 `相亲` / `xiangqin` / `matchmaker`，看命中。不命中 → 在 description 里加英文关键词冗余（"xiangqin (Chinese matchmaking)..."）

5. **下架 / 改名 是人工服务** — 如果未来 xiangqin 改 slug 或想从 skills.sh 撤下，要去 https://community.vercel.com 发帖 @ Vercel staff。**规划时把这一条写进 runbook**

6. **README 的身份要区分** — spec 只要求 SKILL.md；skills.sh 详情页会渲染 repo 的 README.md（对用户可见），而 CLI 装进本地只复制 skill folder。xiangqin release.yml 里 `cp SKILL-REPO-README.md /tmp/skill/README.md` 是对的 —— 这个 README 是**给 skills.sh 目录访客看的**，不是给 agent 看的，定位和 CLAUDE-facing SKILL.md 不同，要分开写

### skills.sh vs ClawHub 新一轮对比（补充/修正之前的结论）

| 维度 | skills.sh | ClawHub | 对 xiangqin 的含义 |
|---|---|---|---|
| 搜索 | **关键词 + install 排序**（非向量） | **向量 embedding + stars + downloads** | ClawHub 对中文语义友好仍成立；skills.sh 则必须在 description 里撒英文关键词冗余 |
| 审核 | install-time 三家扫（Gen/Socket/Snyk） | 发布时 VT + OpenClaw + 社区举报 | 两边都可能误标；xiangqin 自审 SKILL.md 很重要 |
| 下架 | 人工发 community 帖 | moderator 后台可 delete / ban | skills.sh 流程更原始，问题一旦起来响应更慢 |
| 发现冷启动 | **必须 CLI 装过才入库** | publish 即上线 | skills.sh 需要手动触发冷启动装机 |
| 版本 | tag **默认被忽略**，main HEAD | CLI `publish --version X.Y.Z` 语义版本 | skills.sh 那边要么放弃版本概念让 main=latest，要么 README 显式教 `#v` fragment |
| 中文 | 未验证，leaderboard 全英 | 已验证中文 displayName "相亲" 正常 | 中文用户池仍应主推 ClawHub |
| 官方定位 | Vercel 背书，全球开发者 | 独立生态 + 中国镜像 | 目标用户不同，skills.sh 做 SEO / 国际曝光资产 |

### 仍然支持之前"ClawHub 主推、skills.sh 零维护挂着"的结论

这次深调**没有推翻**前一份研究的战略结论，反而**补强了**：

- skills.sh 的 leaderboard 纯装机排序 + 无向量 + 无中文分词证据 → 中文 C 端 skill 确实在英文开发者池里出不了头
- 但 skills.sh 是 Vercel 背书的全球开发者入口，**仅作 SEO / 信任背书资产**有价值，release.yml 推着没错
- 真正要打的是：**主推 ClawHub，skills.sh 挂一个凭条，英文 description 冗余两句放大被关键词命中的概率**

### 下一步可落地的 3 件小事

1. 手动 `npx skills add acong-tech-skills/xiangqin` 自装一次，冷启动 telemetry，24-48h 后看 https://skills.sh/acong-tech-skills/xiangqin 是否出现
2. SKILL.md description 里在中文首句后面加一行英文摘要（像 "xiangqin — Chinese matchmaking / compatibility assistant skill"），提高 skills.sh 关键词命中概率
3. 在 SKILL-REPO-README.md 里写一句 "Pin to a version: `npx skills add acong-tech-skills/xiangqin#v0.x.y`"，救那少数几个懂 git fragment 的用户
