$9.99/月,访问全部 Premium Skills,随时取消。查看方案

跑通你的第一个 Agent Skill

这篇 Claude Skills 入门教程带你装一个免费 Skill,在 Claude Code、Codex 或 Cursor 里跑起来,再确认结果真的对。第一次留出十分钟,以后装新 Skill,一分钟左右就够。

适合
第一次使用 Skill 的人
适用于
Claude Code、Codex、Cursor
用时
约 10 分钟

先说结论

装上了不等于完事。Agent 能列出这个 Skill,你开口时会用上它,最后交出它承诺的东西,这才算跑通。

开始前要准备什么?

一个 Agent

Claude Code、Codex 或 Cursor

Node.js 22+

只有 Skillry CLI 需要,支持 macOS 和 Windows

一个 Skillry 账号

免费 Skill 也要登录

三个 Agent 有一个就够了。用你手边已经在用的那个,下面的步骤在三者之间差别很小。

第一个 Skill 选哪个?

挑一个一分钟内就能看出好坏的。图片类 Skill 最合适,做得对不对,一眼就知道。下面三个都免费:

Notion Style OG Image

图片。为发布或帖子做一张 16:9 的 Notion 风格分享图。

Claude Style Illustration

图片。把一个想法画成一张杂志风插画。

Scrapbook Resume Site

网页。根据你的资料生成一个单页简历网站。

安装前先打开 Skill 页面,在“关于这个 Skill”里看清要求。Notion Style OG Image 需要 Node.js 20 和一个 FAL API key,每出一张图都是一次 FAL 付费生成。Claude Style Illustration 需要 Node.js 20 和 Python,你愿意的话,它也可以调用付费的 FAL 生图。

Requirements panel on a Skill page, listing You bring, Dependencies, Outside costs and Last tested
每个 Skill 页面都写明了你需要提供什么、依赖项、外部成本,以及最近在哪些 Agent 里实测过。

把 Skill 装上

  1. 1

    在 Skillry 上打开这个 Skill,点复制安装提示词。弹窗里可以复制给 Agent 用的提示词,也可以切到命令行安装拿一条命令。

  2. 2

    在终端里运行对应 Agent 的命令。Claude Code 要加 --agent claude-code,Codex 和 Cursor 不用。还没登录的话,CLI 会打开浏览器让你登录。

    Claude Code
    npx --yes skillry-cli@latest install bs-notion-style-og --agent claude-code
  3. 3

    看输出的最后一行,上面写着版本号,以及 Skill 装进了哪个目录。

    正常的话你会看到: Installed bs-notion-style-og <version> to ~/.claude/skills/bs-notion-style-og

Skillry Skill page for Notion Style OG Image with the Copy install prompt and Download ZIP buttons
在 Skill 页面上,点“复制安装提示词”会打开安装弹窗;点“下载 ZIP”能拿到整个文件夹,自己手动安装。

不想碰终端,也可以把安装提示词直接粘贴给 Agent。这条路和 ZIP 安装都写在安装 Skills里。

Skill 怎么用:先跑两遍

第一遍点名调用,第二遍用平常说话的方式提要求。第一遍只考验 Skill 本身,出了问题你知道该查哪儿;第二遍看它的描述跟你平时的说法对不对得上。

Claude CodeCodexCursor
点名调用/bs-notion-style-og$bs-notion-style-og/bs-notion-style-og
平常说法“给我们的发布帖做一张 OG 图”同上同上

Claude Code 和 Codex 在当前会话里就能认出新装的 Skill。Cursor 只在启动时查找 Skills,看不到的话,新开一个对话或者重新加载窗口。

怎么确认它真的生效了?

看产出,别只看安装成功的提示。如果 Skill 加载了,结果却跟 Agent 平时随手做的差不多,那它其实没起作用。

做到这几点才算完成

  • Agent 说它用了这个 Skill,或者你能看出它在按 Skill 的步骤走。
  • 结果带着这个 Skill 的风格或格式,不是一份泛泛的回答。
  • 它承诺的文件出现在了你的项目目录里。

列表里找不到

文件夹放错了地方。对照一下 Skill 存放位置。

列表里有,但平常说法叫不动它

有些 Skill 就是这样。点名调用,或者看看触发机制。

开始跑了,又停下来

缺了它依赖的东西。先看 Skill 页面,再看故障排查。

跑通一个之后,下一个大约一分钟就能装好。日常怎么用,接着看如何使用 Skills。

常见问题

使用 Agent Skills 需要会写代码吗?

不需要。安装提示词会帮你装好,运行时输入 Skill 的名字,再说清你要什么就行。

第一个 Skill 选什么好?

选一个免费、结果一眼能看出好坏的,比如 Notion Style OG Image。它需要一个 FAL API key,每张图都会消耗 FAL 的付费额度。

Skillry CLI 支持 Linux 吗?

暂时不支持。它把登录信息存在 macOS 钥匙串或 Windows 凭据管理器里。在 Linux 上,请用安装提示词或下载 ZIP。

参考来源

这篇对你有帮助吗?