Cursor技能安装、调用与同步排查
文章用一个完整示例讲解如何放置 SKILL.md、重启 Cursor 后通过斜杠菜单调用,并列出个人、项目和兼容目录。个人技能同步到 Cloud Agents 需要放在 ~/.cursor/skills 并开启对应设置。
AI 深度解读
装了 Cursor skill,Agent 里却找不到,或者同一个技能出现两次,作者把原因指向了加载目录:Cursor 会读取多个位置,安装器又可能向多个目录写入。先弄清文件放在哪里,再谈怎么调用,能少走不少弯路。
原文还用 Snow Globe 演示了一套带脚本、示例和素材的工作流:从品牌配置生成网页首屏,再检查、截图和录制视频。它想说明,skill 的价值不只是一段提示词,还可以是能重复执行的交付流程。不过,文中的安装入口和 Cloud Agent 路径需要分开理解。
装了却找不到,先查目录和加载时机
一个 skill 就是一个包含 SKILL.md 的文件夹,还能附带 scripts/、template/。按作者的描述,Cursor 读取 ~/.agents/skills、~/.cursor/skills,也兼容项目和用户主目录里的 .claude/skills、.codex/skills。
这解释了重复显示:如果同时安装了 Claude Code,文中所述安装器默认会向 ~/.agents/skills 和 ~/.claude/skills 各写一份,Cursor 又会读取两边。作者建议删除一份,或者安装时使用 --shared。
找不到则先重启。原文给出的顺序是:安装、重启 Cursor、到侧栏 Customize → Skills 检查,再在 Agent chat 输入 / 搜索。通过斜杠选择会应用到当前一条消息;Agent 也可以根据相关性自动加载技能,不必每次手动调用。
云端另有条件:作者称,只有 ~/.cursor/skills 能通过设置中的 Sync Skills for Cloud Agents 同步,~/.agents/skills 留在本机。项目交付则建议从仓库根目录使用 --project 安装,并提交生成的文件夹。这是两种分发方式,不能只看到本地列表里有技能,就认定 Cloud Agent 也有。
没终端时,原文提供了安装提示词和 ZIP 解压两条路;其中免费技能安装不需要账号,登录下载 ZIP 是另一种入口。
哪些内容该写成 skill,哪些留给 rule
长期偏好适合 rule,多步骤操作适合 skill。
原文把 rule 定义为短指令,保存在 .cursor/rules/ 的 .mdc 文件里,可以始终加入对话,也可以按匹配条件加入。比如固定代码风格,就是持续生效的约束。
Skill 则按需加载,项目路径可以是 .agents/skills/ 或 .cursor/skills/,调用形式包括 /skill-name、@skill-name,也可以由 Agent 判断是否相关。它适合描述有输入、有步骤、有检查结果的流程,脚本和模板也能一起携带。
对前端团队,这个区别很实用。要求组件遵守命名规范,通常一条 rule 就够;要求生成页面、检查多个宽度、导出截图,则更适合打包成 skill。后者把操作方法和执行工具放在一起,减少每次重新交代步骤的成本。
Snow Globe 怎样把首屏制作变成流水线
Snow Globe 的技能名是 snow-globe-hero,属于作者提供的 38 个 MIT 许可免费技能之一。它生成一个浏览器光线追踪首屏:玻璃雪景球放在石台上,标题刻进石台表面,与球体共享光照,页面同时保留真正的 h1。
场景有低日照冬日咖啡馆和月光天文台两套,每隔 14 s 摇动一次,雪片或闪粉运动后沉降,首尾帧衔接。
原文给出的直接安装命令如下:
npx skills add lookbkdev/lookbk-skills --skill snow-globe-hero
注意 --skill snow-globe-hero 指定了要安装的技能。原文还列出插件市场入口:先执行 /plugin marketplace add lookbkdev/lookbk-skills,再执行 /plugin install snow-globe-hero@lookbk-skills。
环境要求包括 Node.js 18 或更新版本;检查和录制需要 Chrome、Chromium 或 Edge,找不到时设置 CHROME_PATH;视频需要 ffmpeg,或设置 FFMPEG_PATH。打开页面还要联网加载字体。因此,原文所谓「无需安装其他东西」,只能结合具体操作理解。
品牌内容统一写入 hero.json。可以复制 examples/alder/hero.json 或 examples/pell-ridge/hero.json,替换名称、logo 或字母标志、两行标题、导语、一个 CTA、最多四个链接和一个栏位链接。颜色也有约束:铭牌文字对比度为 7:1,石材刻字至少 3:1。
随后执行这组构建与检查命令:
node <skill>/scripts/build.mjs hero.json out
node <skill>/scripts/check.mjs out/index.html
node <skill>/scripts/record.mjs out/index.html --still 0 --png out/still.png
node <skill>/scripts/record.mjs out/index.html --still 0 --size 390x844 --scale 2 --png out/phone.png
node <skill>/scripts/record.mjs out/index.html --seconds 14 --size 1920x1080 --fps 30 --poster 0
其中 <skill> 要替换成技能目录,最后一行按完整 14 s 周期录制 1080p MP4,才能保持循环闭合。检查脚本会在四个宽度下执行页面检查和首屏规则检查。
静态截图宜选沉降阶段,默认是 0–2.2 s、12.7–14 s;运动区间由 shakeAt 到 cycle - 3.5 + shakeAt 决定,页面通过 window.__snowGlobeHolds 暴露静止区间。
部署时上传 index.html 和 assets/,或嵌入 embed.html 并复制素材。没有 WebGL 时,页面会用预渲染静帧加真实标题降级。刻字对比度低于 3:1 会阻止构建,暗色场景可调整 lipLight;玻璃后方过于平坦时可保留默认太阳光或提高 sunStrength。
我的判断
我认可它把 skill 做成「配置、脚本、检查、产物」的方向。步骤明确后,Agent 不必每次临时组织流程,维护者也有机会定位是哪一步出了问题。
但原文没有给出成功率、耗时或性能对照。它说房间和光线追踪对象按尺寸绘制后缓存,每帧只合成运动部分,这能解释优化思路,不能证明普通设备都能流畅运行。四个宽度的检查究竟覆盖什么,原文也没展开。
安装说明还有一处疑问:作者称 Cursor 不能直接从仓库导入 skill、必须先打包插件,后面又给出 npx skills add 的仓库安装命令。两者可能涉及不同入口,但原文没有讲清,不能把它们当成同一个限制。
相比已有 Node 脚本,skill 多了一层让 Agent 发现并遵循流程的说明;确定性的操作仍由脚本承担。至于「这个能显示,其他技能也都能显示」,最多只能验证部分目录和加载链路。文末的 200+ 技能目录也属于推广信息。文章注明经 AI 辅助起草并对照 SKILL.md 检查,不等于提供了独立实测报告。
能拿来做什么
- 安装后先检查实际落盘目录,再重启并核对
Customize → Skills;出现重复项时,检查兼容目录里是否存在副本。 - 把持续生效的编码偏好放进 rule,把页面生成、响应式检查、截图导出等步骤整理成 skill,并让 Node 脚本承担可重复执行的部分。
- 借鉴
hero.json的方式,把品牌文案、颜色和链接集中成明确输入,再交给构建与检查脚本处理。 - 准备交给 Cloud Agent 的技能,提前确认使用个人目录同步还是项目提交,并核对浏览器、字体和 ffmpeg 等运行依赖。