爱折腾の黑猫
Skill 的基本使用
← 文章列表

Skill 的基本使用

未分类# skill# 教程
文章目录

Skill 的基本使用

一、什么是 Skill？

传统 AI 对话主要依赖模型已有知识，以及用户临时提供的要求。遇到重复任务时，用户往往需要反复说明操作步骤、规范和注意事项。

Agent Skill 则是将这些内容整理成模块化的能力包。遇到相关任务时，AI 可以根据 Skill 的触发条件自动调用，用户也可以手动指定调用，从而更规范地完成特定任务。

Skill、MCP 与提示词的区别:

  • MCP：让 Agent 连接外部工具、服务或数据。
  • 提示词：针对单次任务提出临时要求。
  • Skill：沉淀完成某类任务的流程、规范和资源。

1.1 一个 Skill 的基本组成

每个 Skill 通常对应一个文件夹，常见内容如下：

组成作用
SKILL.md核心说明文件，描述 Skill 的用途、执行步骤和注意事项。
参考文档存放更详细的说明，或不同任务分支的处理方法。
脚本执行具体操作，例如处理 Excel、获取系统时间。
其他资源图片、模板等任务所需素材。

二、去哪里找 Skill？

2.1 常用平台

平台网址说明
AnthropicGitHub - anthropics/skillsAnthropic 官方 Skills。
Skills Marketplaceskillsmp.comSkill 数量丰富。
skills.shskills.sh提供热门 Skill 排名。
LobeHubLobeHub Skills开源 Skills 社区。
AgentSkillagentskill.shClaude Code Skills。
Smithery.aiSmithery SkillsSkill 与 MCP 生态平台。
GitHub搜索 Skills 仓库直接搜索 skills 关键词。
ClawHubClawHub Skills出自 OpenClaw，访问速度较慢。
ClawHub 中国镜像站cn.clawhub-mirror.com由火山引擎提供支持的国内镜像站。
Skill4Agentskill4agent.comAgent Skill 聚合平台。
ModelScopeModelScope Skills阿里旗下平台。
SkillHubskillhub.cn腾讯旗下，数据来源于 ClawHub。

2.2 通过 Find Skills 查找

在 Codex 的输入框中输入 /，选择或输入 Find Skills，即可使用该 Skill 协助查找合适的 Skills。

/Find Skills

三、怎么安装 Skill？

3.1 安装位置

天童アリス.png

Codex Skill 的全局安装目录为：

~/.codex/skills/
  • 该目录中的 Skill 对所有项目可用。
  • ~ 表示当前用户的主目录。
  • .system 子目录存放 Codex 自带的系统级 Skill。

一般不同系统的路径

系统常用路径说明
WindowsC:\Users\你的用户名\.codex\skills\也可在资源管理器地址栏输入 %USERPROFILE%\.codex\skills\。
macOS~/.codex/skills/展开后的完整路径为 /Users/你的用户名/.codex/skills/；终端中也可使用 $HOME/.codex/skills/。
若找不到目录，也可以直接询问 Codex：我的 Skill 安装目录在哪里？

如何打开隐藏文件夹？

  • Windows：打开文件资源管理器，依次选择「查看」→「显示」→勾选「隐藏的项目」。也可以直接在地址栏输入 %USERPROFILE%\.codex\skills\ 并按回车。
  • macOS：在 Finder 中按 Command + Shift + .（句点），即可显示或再次隐藏以 . 开头的文件夹。按 Command + Shift + G 后输入 ~/.codex/skills/，可直接前往该目录。

3.2 安装方式

方式一：ZIP 包安装（最通用）

Skill 本质上是一个文件夹。只需将完整的 Skill 文件夹放入安装目录即可。

  1. 下载 Skill 文件，通常为 .zip 压缩包。
  2. 解压，并确认文件夹中包含 SKILL.md。
  3. 将整个 Skill 文件夹复制到 ~/.codex/skills/。
  4. 重新加载 Codex，并确认该 Skill 已被识别。

典型目录结构：

~/.codex/skills/
└── my-skill-name/       # 文件夹名通常就是 Skill 名
    ├── SKILL.md         # 必需：YAML frontmatter + Markdown 正文
    ├── agents/          # 可选：UI 元数据
    ├── scripts/         # 可选：可执行脚本
    ├── references/      # 可选：按需加载的参考文档
    └── assets/          # 可选：模板、素材等资源

方式二：通过对话安装

直接向 Codex 提出安装请求：

帮我安装这个 Skill：{Skill 链接}

例如：

帮我安装这个 Skill：https://github.com/example/example-skill

方式三：通过 CCSwitch 安装

如果同时使用多个 Agent 工具，可以通过 CCSwitch 统一管理和安装 Skills。

3. 3 安装后的验证步骤

注意以下验证要点：

  1. 重新加载 Codex。
  2. 确认 Skill 是否出现在可调用列表中，或尝试向 Codex 指定该 Skill。
  3. 若未识别，优先检查文件夹层级是否正确，以及 SKILL.md 的文件名和位置是否正确

3.4 更新与卸载方法

第三方 Skill 的更新通常是替换其文件夹；卸载前可先备份，或将其移出 skills 目录，确认不再需要后再删除。

四、如何调用 Skill？

方式一：自动调用

Codex 可以根据任务内容，自动判断是否调用合适的 Skill。

方式二：在提示词中明确指定

在提示词中直接说明要使用的 Skill，例如：

使用 pptx Skill 帮我制作一份演示文稿。

方式三：通过 / 菜单调用

在 Codex 输入框中输入 /，再选择对应的 Skill，例如：

/Find Skills

反魂蝶.png

五. 简单运行示例

下面以翻译助手为例，创建一个只包含 SKILL.md 的最小 Skill。它不依赖脚本或其他资源，只通过清晰的元数据和指令告诉 Codex：何时使用它、应如何完成任务。

5.1 目录结构

先创建一个名为 translation-helper 的文件夹，并在其中新建 SKILL.md：

translation-helper/
└── SKILL.md

5.2 SKILL.md 示例

将以下内容写入 SKILL.md：

---
name: translation-helper
description: 将用户提供的中英文文本在中文与英文之间翻译。当用户要求翻译、润色翻译或双语转换时使用；不用于撰写原创内容或解释术语。
---

# 翻译助手

工作步骤

1. 判断用户提供文本的语言，以及目标语言；未明确目标语言时先询问用户。
2. 忠实保留原文的含义、语气、段落结构和 Markdown 格式。
3. 人名、品牌名、代码、链接和文件路径保持不变，除非用户明确要求翻译。
4. 默认只输出译文；用户要求说明时，再补充简短的翻译说明。

其中，YAML frontmatter 中的 name 和 description 是必需信息：

  • name 是 Skill 的标识名称，建议使用简短、清晰的英文名称。
  • description 决定 Skill 的适用范围，也是 Codex 判断是否自动调用它的重要依据；应写明适合处理什么任务，以及不适合处理什么任务。
  • 正文则是 Agent 实际遵循的工作步骤和输出规则。

5.3 如何使用

  1. 将 translation-helper 整个文件夹放入前文介绍的 Skill 安装目录。
  2. 重新加载 Codex，或等待其自动识别新建的 Skill。
  3. 在对话中明确调用，或直接提出符合其描述的翻译任务。

例如：

使用 translation-helper 将以下内容翻译成英文，并保留 Markdown 格式：
DISCUSSION

评论

使用 GitHub 登录