学习

学习 Agent Skills

简短易懂的指南，从安装第一个 Skill 到修复无法加载的问题——适用于 Claude Code、Codex 或 Cursor。

运行你的第一个 Skill 对比 Agents

无需账户兼容主流 Agents已验证安装包

平台

你在用哪个 Agent？

同一个 SKILL.md 文件夹可跨 Agent 使用——选择你日常使用的运行环境。

Claude Code

项目 Skills 与斜杠命令

Codex

终端原生 $skill-name

Cursor

Rules、Skills 与 Cloud Agents

对比三者

目录、命令与命名规则

从这里开始

新来的？先看这三篇

什么是 Skill？

一组教 Agent 完成某一类工作的说明文件夹——例如制作演示文稿——核心是 SKILL.md。

浏览示例

快速上手

安装一个免费 Skill，在 Agent 中运行，确认它完成了任务，再考虑自定义。

跑通一个 Skill

安装 Skill

把文件夹放到 Claude Code、Codex 或 Cursor 能找到的位置——个人路径与项目路径因 Agent 而异。

查看安装指南

深入了解

更好地使用你的 Skills

如何使用 Skills

给 Skill 提供什么、如何检查它生成的文件，以及如何得到更好的第二稿。

Skills 如何被触发

为什么 Agent 会选中某一个 Skill，以及如何写出更容易被选中的描述。

Skill 文件结构

了解 SKILL.md、scripts/、references/，以及文件夹过深时 Agent 可能跳过它。

Skill 安全

安装前检查脚本，优先使用已验证的包，避免运行不受信任的代码。

故障排查

Skill 不工作？对号入座

不在 /skills 里

放错了目录，或 ZIP 多了一层。该 Agent 的路径必须以 <name>/SKILL.md 结尾。

从不会自动运行

先用名称显式调用，再收紧描述，让 Agent 能识别你的请求。

跑成了别的 Skill

描述重叠或名称重复。把目标 Skill 的第一句话写得更具体。

本地可以，云端不行

个人目录只在本机。提交项目 Skills、同步 Cursor Skills，或在 claude.ai 上启用。

对比

Skills 与 MCP、提示词、规则有何不同

为任务选择合适的抽象——SkillsRadar 帮你发现并组合它们。

Skill

面向特定结果的可复用能力包。

按需加载
可跨 Agent 移植
适合可重复的工作

MCP

将 Agent 连接到工具与数据源的协议。

实时工具访问
由服务器支持
与 Skills 互补

提示词

粘贴到对话里的一次性说明。

上手快
难维护
容易漂移

AGENTS.md / 规则

每次运行开始时加载的简短指引。

始终在上下文中
保持简短
把流程放进 Skills

连接你的工具

一个账户，全部入口

从资料库开始，在终端或 Agent 中继续，需要自定义集成时再用 API。

CLI

无需离开终端即可搜索、检查、安装、更新与扫描 Skills。

适合本地工作流

查看安装指南

MCP

连接 Cursor 或 Claude Desktop，让 Agent 在对话中搜索、推荐并说明如何安装 Skills。

适合在 Agent 内发现

MCP 配置指南

API 与 SDK

把语义搜索与推荐能力接入产品、脚本与自动化。

适合自定义集成

管理 API 密钥

速查

命令速查表

斜杠命令、$ 调用，以及 SkillsRadar CLI 安装。

/skills

在 Claude Code 或 Codex 中列出 Skills

/skill-name …

在 Claude Code 或 Cursor 中运行 Skill

$skill-name …

在 Codex 中运行 Skill

npx @skillsradar/cli@latest install <slug>

默认 → ~/.agents/skills/（Codex、Cursor 等）

npx @skillsradar/cli@latest install <slug> --agent claude-code

安装到 ~/.claude/skills/

npx @skillsradar/cli@latest login

浏览器登录 → 系统钥匙串

skillsradar-mcp

MCP stdio 服务器——Cursor 配置见 /learn/mcp

完整 Agent 对比

位置

Skills 存放在哪里

每个 Agent 读取不同的目录。把 Skill 放到它会查找的位置——或让 SkillsRadar 的 --agent 标志帮你选择。

~/.agents/skills/共享默认（Codex、Cursor、Gemini CLI 等）

~/.claude/skills/Claude Code（需 --agent claude-code）

~/.gemini/config/skills/Antigravity

查看优先级规则

下一步

准备好探索已验证的 Skills 了吗？

浏览资料库、按 Agent 筛选，或打开 Claude Code、Codex、Cursor 的安装指南。

探索 Skills Claude Code 指南