核心用法
clawdhub-find-skills 是一个技能发现与安装助手，专为用户表达「如何做某事」「寻找某功能的技能」等需求设计。它通过 reskill（开源 Git 基础包管理器）与 Rush 社区注册表 (rush.zhenguanyu.com) 交互，实现技能的搜索、展示与安装。
标准流程（Search → Present → Ask → Install）：
1. 解析 CLI 与注册表：优先检测全局安装的 reskill，否则回退至 npx reskill@latest；注册表支持 --registry、环境变量 RESKILL_REGISTRY 及 skills.json 配置，默认指向 Rush 公共注册表。
2. 渐进式搜索策略：采用多轮检索提升命中率——自然语言查询 → 连字符形式 → 最相关单关键词 → 同义词替换。搜索使用 reskill find "<query>" --json，返回结构化结果后由 Agent 根据描述字段人工过滤，仅展示最相关的 2-3 个技能。
3. 智能目标代理检测：按优先级解析安装目标——用户显式指定 → skills.json 中 defaults.targetAgents → 自动识别 .cursor/, .claude/, .codex/ 等 Agent 目录 → 询问用户。安装命令形如 reskill install <name> -y -a <agents> --registry <url>。
4. 安装与反馈：用户确认后执行安装，随后简述新能力并提示就绪。
内置快捷推荐：针对「创建/发布技能」等高频意图，直接推荐 @kanyun/rush-reskill-usage，跳过搜索步骤。
显著优点
- 检索策略系统化：四级渐进搜索 + Agent 端描述过滤，有效解决注册表模糊匹配能力有限的问题，显著提升冷门技能发现率。
- 零配置开箱即用：默认连接成熟的 Rush 社区注册表，同时开放多层级覆盖机制（CLI 参数、环境变量、项目配置），兼顾便捷与灵活。
- 多 Agent 生态兼容：原生支持 Cursor、Claude Code、Codex、Windsurf、GitHub Copilot、OpenCode 等主流代理，自动目录检测减少用户认知负担。
- 安全与透明并重：坚持「先展示后安装」原则，明确告知注册表来源与安装目标；依赖全局 CLI 或 npx 执行，不预下载远程代码。
- 完善的兜底机制：搜索无果时提供直接协助，并引导用户创建自定义技能，形成「发现-使用-贡献」的闭环。
潜在缺点与局限性
- 注册表中心化风险：默认依赖单一公共注册表（rush.zhenguanyu.com），若服务不可用或网络受限，需用户手动切换至镜像或私有注册表。
- 搜索质量受限于元数据：技能发现效果高度依赖发布者的关键词与描述填写质量，命名不规范的技能可能被遗漏。
- 渐进搜索的延迟成本：极端场景下需执行 3-4 轮 CLI 调用，虽提升召回但增加响应时间；Agent 端描述过滤亦消耗 token。
- Agent 检测的边界情况：部分用户可能使用非标准目录结构或新兴 Agent，自动检测失败时需人工介入。
- 功能聚焦单一：本技能仅负责「发现与安装」，不涵盖技能运行时管理、版本冲突解决或依赖树可视化等高级包管理功能。
适合人群
- AI 代理重度用户：日常在 Cursor、Claude Code 等环境中工作，希望快速扩展代理能力，不愿手动查阅文档的开发者。
- 团队技能治理者：需要为团队统一配置技能集、维护私有注册表并标准化安装流程的技术负责人。
- 技能生态贡献者：计划开发并发布自定义技能到社区，需了解发现机制与最佳实践的进阶用户。
- 跨平台协作者：频繁切换不同 AI 工具，希望一套技能配置多环境复用的全栈工程师。
常规风险
- 供应链安全：reskill 作为包管理器，其安装的技能以 Markdown 形式存在，实际执行代码需经 Agent 解析，存在恶意指令注入风险（建议结合 S+/S 级安全扫描）。
- 注册表投毒：公共注册表若缺乏审核机制，恶意技能可能被上传；用户应优先安装高可信度发布者（如
@kanyun命名空间）的技能。 - 权限过度授权：
reskill install默认需访问文件系统写入 Agent 目录，配合-y自动确认，建议在 CI/CD 或敏感环境禁用自动安装。 - 版本锁定缺失：当前流程未强调
skills.json版本锁定的重要性，团队环境可能因隐式更新导致行为漂移。 - 网络与隐私：搜索请求发送至第三方注册表，敏感关键词可能泄露用户技术栈信息，敏感场景应切换至私有注册表。