用途
Skill Search Optimizer 用于优化智能体技能（agent skill）在 ClawdHub / MoltHub 注册表中的可发现性。当出现以下情形时使用：已发布的技能没有出现在相关搜索中；需要为技能撰写描述以获得最大可发现性；想理解 ClawdHub 的搜索索引与排序方式；想把自己的技能可见性与竞品对比；或想改善现有技能的搜索表现。
主要能力
理解 ClawdHub 搜索如何工作
ClawdHub 使用基于向量的语义搜索，而非关键词匹配。流程为：用户查询 → OpenAI 嵌入 → 向量相似度搜索（Convex 向量索引）→ 排序结果。由此可得出几点影响：语义比精确关键词更重要（"container debugging" 可以匹配 "Docker troubleshooting"）；但关键词仍有帮助，嵌入模型会对具体术语编码较强信号；描述是首要被索引的字段，内容可能也有贡献但描述占主导；短查询匹配宽泛描述，具体查询匹配具体描述。
被索引的层级为：
- 主要（PRIMARY）：description 字段（frontmatter）
- 次要（SECONDARY）：name/slug 字段
- 第三（TERTIARY）：技能正文（body markdown），可能在嵌入前被摘要或截断
搜索 API 调用方式（内部）：
# POST https://clawdhub.com/api/cli/search
# Body: { "query": "user search terms", "limit": 10 }
# Returns: ranked list of skills with similarity scores
CLI 搜索命令：
npx molthub@latest search "your query"
描述优化
高排名描述的结构模式为：[动作动词] + [具体范围]。Use when [触发场景 1]，[触发场景 2]，[触发场景 3]。Also covers [相关主题]。
资料给出三种描述公式：
- 公式 1（工具导向）：
[动词] with [工具/技术]。Use when [任务 1]，[任务 2]，[任务 3]。Covers [子主题 1]，[子主题 2] 和 [子主题 3]。 - 公式 2（模式/参考）：
[主题] patterns for [范围]。Use when [任务 1]，[任务 2]，[任务 3]。Also covers [相关范围]。 - 公式 3（工作流/流程）：
[流程描述] from [起点] to [终点]。Use when [场景 1]，[场景 2]，[场景 3]。
描述长度建议：
- 过短（< 50 字符）：语义信息不足，嵌入模型缺少匹配面。
- 最佳区间（80–200 字符）：语义内容丰富，有多个匹配角度。
- 过长（> 250 字符）：在搜索结果展示中会被截断，低信号词会稀释嵌入，列表中也更难读。
内容优化
技能正文可能通过两种方式影响搜索：一是注册表可能提取或摘要内容用于展示；二是完整内容可能被单独嵌入或附加到描述。优化策略包括：在标题后的第一段前置重要术语；使用与搜索查询匹配的标题（如 "## Encode and Decode" 优于 "## Section 2"）；在文档中自然重复关键词。
测试搜索可见性
可使用用户会输入的确切查询进行手动测试，包括宽泛查询、具体查询、问题导向查询和同义词查询：
npx molthub@latest search "docker"
npx molthub@latest search "debug docker container"
npx molthub@latest search "cron job not running"
npx molthub@latest search "bastion host"
目标是在具体查询中进入前 3，在宽泛查询中进入前 10。迭代流程为：发布初始版本 → 测试可见性 → 优化描述 → 以版本号递增重新发布（嵌入在发布时更新）→ 重新测试。
竞争定位
可搜索同类技能、安装并阅读竞品描述，比较其覆盖的查询、使用的术语和内容深度。差异化策略包括：更宽的范围、更深的 specificity、问题导向的表述、跨工具覆盖。进入某类目时先做市场分析：0 个结果属蓝海；1–2 个属低竞争；3 个以上属竞争激烈，需要明确差异化。
注册表动态
常见搜索模式包括：工具名、任务描述、问题陈述、对比（如 "jest vs vitest"）、how-to。时机方面：新技能发布即被索引；更新技能在版本递增时重新索引；资料称无已知的新鲜度偏见；注册表较年轻，早期发布者有先发优势；slug 所有权是永久的。
使用方式
进行发布前搜索优化检查，包括描述是否符合 [动作] + [范围] + [Use when] 模式、长度是否在 80–200 字符、是否显式包含主要工具/主题名称、是否包含常见同义词、是否包含故障排查语言、动作动词是否与用户搜索方式一致、标题后第一段是否强化关键词、章节标题是否使用可搜索短语、slug 是否具描述性等。发布后进行验证，检查是否在主要具体查询中进入前 3、宽泛类目查询中进入前 10、是否至少出现在一个同义词查询和一个问题导向查询中。
资料给出的提示（Tips）包括：描述字段对搜索排名的价值超过技能其余全部内容；"Use when..." 短语有很强效果，因为匹配用户自然表述查询的方式；同时包含具体工具名和通用类目；问题导向语言能匹配纯描述性技能会错过的搜索；发布前至少用 5 个不同查询测试；slug 名称也参与搜索匹配；不要为技能实际无法回答的查询做优化；注册表较年轻，先发优势真实存在；优化描述后以版本递增重新发布，嵌入会在每次发布时重新生成。
适用场景
- 为即将发布的技能撰写高可发现性的描述
- 诊断已发布技能为何不出现在相关搜索中
- 与同类竞品比较搜索可见性并寻找差异化切入点
- 建立测试矩阵，迭代改善搜索排名
限制
资料未提供该技能的收费、价格、具体平台可用性等信息。资料中涉及的注册表搜索行为、索引机制、长度建议等均为该技能文档中的陈述，是否适用于其他注册表暂未提供说明。