核心用法
skills-search 是一款命令行工具,允许开发者直接在终端内搜索、发现和安装来自 skills.sh 注册表的 Agent 技能。它通过调用官方 skills.sh API,返回按安装量排序的技能列表,并提供一键复制安装命令的便捷功能。
主要功能场景
1. 关键词搜索:通过技能名称或描述模糊匹配,如 skills-search "postgres" 或 skills-search "web design"
2. 热门榜单:skills-search --popular 展示全平台最热门的技能,支持 --limit 限制返回数量
3. 安装引导:--show-install 标志直接在搜索结果中附带 npx skills add <source> 安装命令
显著优点
- 零切换成本:完全在 CLI 内完成搜索→发现→安装的闭环,无需浏览器跳转
- 生态整合:深度集成 Clawdbot 工作流,支持
clawdhub install专属安装通道 - 社区驱动:skills.sh 自动索引 GitHub 上的
SKILL.md文件,技能库随社区贡献持续扩张 - 数据透明:返回安装量、来源仓库等关键元数据,辅助决策
局限性与风险
- 依赖 Node.js:运行环境必须预装
node,对非 JS 生态用户存在门槛 - TUI 交互脆弱性:
skillsCLI 的安装流程依赖交互式终端菜单,若 TUI 界面更新或用户环境不支持交互(如 CI/CD),可能导致自动化中断 - API 单点依赖:所有数据来自
skills.sh/api/skills,若服务不可用则完全失效 - 权限边界模糊:
clawdhub publish与skills add涉及文件系统写入(~/.clawdbot/workspace/.agents/skills/),若权限配置不当可能引发安全问题
适合人群
- 频繁使用 Clawdbot 或 skills.sh 生态的开发者
- 希望在终端内快速原型、迭代 Agent 能力的工程师
- 需要批量管理多项目技能依赖的 DevOps/平台团队
安全建议
- 定期校验
~/.clawdbot/workspace/.agents/skills/目录的写入权限 - 在 CI/CD 场景中优先测试
--show-install的输出稳定性,避免 TUI 依赖 - 关注 skills.sh API 的可用性 SLA,关键业务建议缓存热门技能列表