（5736期）skill-search-optimizer – 技能搜索排名优化指南

技能搜索排名优化指南 ClawdHub官方文档型技能，教授开发者通过语义搜索优化提升技能发现率，掌握描述撰写与关键词策略。 使用说明 核心用法 Skill Search Optimizer 是一款纯文档型技能，专注于帮助开发者优化其在 ClawdHub/MoltHub 平台上的技能搜索可见性。该技能系统性地讲解了 ClawdHub 采用的向量语义搜索机制（基于 OpenAI embedding 和 Convex 向量索引），并提供可操作的优化方法论。 核心使用场景包括：当已发布技能在相关搜索中无法被找到时；撰写技能描述以最大化可发现性时；理解 ClawdHub 搜索索引与排名机制时；与竞品进行可见性对比分析时；以及改进现有技能的搜索表现时。 显著优点 该技能的最大价值在于揭示了 ClawdHub 搜索系统的底层架构——向量语义搜索而非传统关键词匹配。这意味着开发者需要理解"意义比精确关键词更重要"的优化逻辑，同时掌握如何在描述中兼顾两者。技能提供了三种经过验证的描述公式（工具导向型、模式/参考型、工作流/流程型），并给出了 80-200 字符的"甜蜜点"长度建议。 另一个突出优势是提供了完整的测试矩阵和迭代优化流程，包括手动测试命令（npx molthub@latest search）、竞品分析方法，以及基于市场分析的竞争定位策略（蓝海/低竞争/高竞争场景的差异化应对）。文档还强调了"问题导向型描述"的重要性，这种描述方式能匹配用户实际搜索行为中的故障排查类查询。 潜在缺点与局限性 作为纯文档型技能，其局限性在于仅提供理论指导和方法论，无法自动执行优化或提供实时搜索排名反馈。开发者需要手动执行所有测试命令并自行分析结果。此外，技能内容高度依赖 ClawdHub 当前的搜索架构，若平台未来调整 embedding 模型或索引策略，部分建议可能失效。 文档中提到的"先发优势"和"永久 slug 所有权"机制暗示了平台早期生态的不成熟性，随着注册表规模扩大，当前有效的优化策略可能面临更激烈的竞争环境。技能也未提供 A/B 测试或多变量测试的统计方法，优化效果难以量化验证。 适合的目标群体 主要面向三类用户：一是已在 ClawdHub 发布技能但发现率不佳的开发者；二是准备发布新技能、希望从第一天就建立搜索优势的内容创作者；三是需要理解语义搜索优化原理的技术写作者和产品经理。特别适合那些愿意投入时间进行迭代优化、具备基础 CLI 操作能力的用户。 对于期望"一键优化"或缺乏耐心进行多轮测试调整的开发者，该技能的价值将大打折扣。同样，仅发布单一技能、不计划持续维护的用户也难以充分利用其中的竞争定位策略。 使用风险 性能风险方面，技能本身无代码执行，不存在运行时性能问题。依赖风险在于文档中示例命令依赖 npx molthub@latest 的可用性，若 CLI 工具版本更新导致命令变更，部分示例可能失效。策略风险是过度优化可能导致描述冗长或关键词堆砌，反而降低用户体验。生态风险是 ClawdHub 平台规则变化可能使当前优化建议过时，建议关注官方更新并定期重新评估搜索表现。 原始说明 Optimize agent skills for discoverability on ClawdHub/MoltHub. Use when improving search ranking, writing descriptions for semantic search, understanding how the registry indexes skills, testing search visibility, or analyzing why a skill isn't being found.