📃个人主页：island1314

⛺️ 欢迎关注：👍点赞 👂🏽留言 😍收藏 💞 💞 💞

• 生活总是不会一帆风顺，前进的道路也不会永远一马平川，如何面对挫折影响人生走向 – 《人民日报》

---

---

这份文档面向两类人：

• 想安装别人现成 Skill 的人
• 想自己写 SKILL.md、并在 Claude Code 或 Codex 里复用的人

你可以重点看 4 个问题：

1. Skill 和 Plugin 到底是什么。
2. Skill 应该放到哪里，项目级和用户级分别怎么生效。
3. SKILL.md 该怎么写，常用字段分别是什么意思。
4. 为什么 Skill 不触发、命令不可用、安装后没反应，该怎么排查。

---

1. Skill 是什么

Skill 可以理解成一段可复用的能力说明。它通常以一个 SKILL.md 文件为入口，里面写清楚：

• 什么时候该触发这项能力
• 它要完成什么任务
• 执行时遵循什么步骤
• 是否允许自动触发
• 是否允许用户手动调用

本质上，它不是传统意义上的二进制插件，更像是“结构化提示词 + 可选参考资料/脚本”。

1.1 一个 Skill 到底能带来什么

举个最直观的例子：如果你装了一个做 PPT 的 Skill，模型就不再只是“会回答问题”，而是会按一套固定流程去生成更像样的结果。

先看调用界面：

再看生成效果：

这类 Skill 的价值，不是“凭空变聪明”，而是把某个领域里反复验证过的工作流固定下来。这样同类任务每次都能更稳定地产出。

你可以把它理解成：把专家经验打包成可复用模块，让通用 AI 助手在某件事上表现得更像专业工具。

1.2 Skill 的三个关键特点

1. 可复用：写好一次，后面可以反复调用。
2. 可分享：别人写好的 Skill，你装上就能用。
3. 可自动触发：当用户意图和 description 匹配时，客户端会尝试自动调用。

自动触发大概就是这种体验：

当然，也可以手动点名调用：

一句话记住：

• Skill 是能力本身
• 模型是否好用，很大程度取决于 Skill 写得是否清楚

---

2. Skill 和 Plugin 的区别

这是新手最容易混淆的一组概念。

2.1 Skill：单一能力模块

Skill 往往就是一个目录，核心文件是 SKILL.md。

my-skill/
├── SKILL.md            # 必需：Skill 主入口
├── reference.md        # 可选：参考资料
├── examples.md         # 可选：示例输入输出
└── scripts/            # 可选：辅助脚本
    └── helper.py

你完全可以只写一个 SKILL.md，就让它工作起来。

2.2 Plugin：多个能力的容器

Plugin 更像打包分发单位。一个插件里可以包含多个 Skill，也可以带命令、脚本、配置和其他资源。

my-plugin/
├── .claude-plugin/
│   └── plugin.json
├── skills/
│   ├── pptx/
│   │   └── SKILL.md
│   └── wechat-format/
│       ├── SKILL.md
│       ├── templates.md
│       └── scripts/
│           └── render.py
├── agents/
├── hooks/
├── commands/
├── .mcp.json
├── .lsp.json
├── bin/
└── settings.json

2.3 一句话区分

• Skill：一个能力
• Plugin：一包能力

如果你只想解决一个具体问题，装单个 Skill 往往更轻。如果你想一次装一整套工作流，就更适合装 Plugin。

---

3. Skill 应该放在哪里

Skill 是否生效，首先取决于它放的位置对不对。

3.1 项目级目录

项目根目录下：

.claude/skills/

特点：

• 只在当前项目生效
• 适合和仓库强绑定的规则
• 适合团队共享

典型场景：

• 项目专用代码规范
• 固定部署流程
• 团队内部提交流程

3.2 用户级目录

用户主目录下：

~/.claude/skills/

特点：

• 对当前用户的所有项目生效
• 更适合通用型能力

典型场景：

• PPT 生成
• Markdown 润色
• PDF 处理
• 通用调研

3.3 如果你同时在用 Codex

很多 Codex 生态的 Skill 会放在类似下面的位置：

~/.codex/skills/

但要注意：

• 目录可以相似
• 调用方式和字段支持不一定完全相同

所以同一个 Skill 如果要同时兼容 Claude Code 和 Codex，文档里最好把两边的触发方式单独说明。

---

4. 安装别人的 Skill

常见方式有 3 种：

1. 手动复制 Skill 目录
2. 借助技能站或安装工具
3. 通过 Plugin 一次安装整包能力

4.1 手动复制

这是最直接、最稳妥的方式。

操作思路：

1. 拿到一个完整的 Skill 目录
2. 确认目录里有 SKILL.md
3. 把整个目录复制到项目级或用户级 skills 目录
4. 重新打开客户端或刷新相关界面

如果别人已经把 Skill 文件夹整理好了，直接复制进去就行：

例如，你想装官方仓库里的 pptx Skill，可以先找到它的目录：

复制到目标目录后，再进入客户端，就能看到对应能力：

4.2 借助技能站或安装工具

如果你不想手动复制，也可以直接用社区安装工具。

以 skills.sh 为例：

进入某个 Skill 页面后，通常会给出一条安装命令：

npx skills add https://github.com/anthropics/skills --skill frontend-design

执行后的效果一般类似这样：

另一个常见站点是 skillsmp.com：

它的优点是，同一个 Skill 往往会给出多种安装方式，方便你按手头工具选择：

4.3 通过 Plugin 安装整包

如果你想装的是一整套能力，而不是单个 Skill，就更适合走 Plugin。

常见命令形式如下：

# 1. 先添加市场源（只需一次）
/plugin marketplace add anthropic-agent-skills

# 2. 再安装技能包或插件
/plugin install document-skills@anthropic-agent-skills

# 3. 也可以先搜索再安装
/plugin search frontend anthropic-agent-skills
/plugin install anthropic-agent-skills/xxx

官方仓库通常会提供相应说明：

这里最容易混淆的有两个名字：

1. 市场源 ID，比如 anthropic-agent-skills
2. 包名，比如 document-skills

安装时，常见格式就是：

/plugin install document-skills@anthropic-agent-skills

对应界面大致如下：

安装完成后，你会发现 Skills 列表里一下子多出很多能力，因为它们是随 Plugin 一起装进来的：

常见字段含义：

列	含义
on	已启用，可按 Space 开关
plugin	来源于插件，而不是手动安装
locked by plugin	由插件托管，不能单独删除
~120 tok	大致上下文占用

如果你后面想把整包卸掉，改成单独安装某个 Skill，可以尝试：

/plugin uninstall document-skills
/plugin install pdf@anthropic-agent-skills
/plugin install docx@anthropic-agent-skills

但要注意：不是所有市场都支持拆包单装。

---

5. 自己写一个 Skill

自己写 Skill 的门槛并不高。最小可用版本通常只需要一个 SKILL.md。

5.1 一个 Skill 目录里通常有什么

除了 SKILL.md，你还可以按需要补充参考文档、模板和脚本：

适合拆出去的内容包括：

• 很长的参考说明
• 输出模板
• 示例输入输出
• 辅助脚本

如果 Skill 很简单，只保留一个 SKILL.md 也完全没问题。

5.2 SKILL.md 分成哪两部分

通常分成两段：

1. Frontmatter 元信息
2. 正文指令

Frontmatter 负责告诉系统“这是什么”，正文负责告诉系统“具体怎么做”。

其中最关键的字段通常有：

• name：技能名称
• description：什么时候该用它
• disable-model-invocation：是否禁用自动触发
• user-invocable：是否允许用户手动调用
• allowed-tools：允许使用哪些工具
• argument-hint：手动调用时参数提示
• effort：大致工作强度

5.3 一个更直观的示例

下面这个例子是一个 commit Skill：

可以这样理解这份配置：

• description 决定什么时候触发
• disable-model-invocation: true 用来防止误触发提交
• 正文部分明确要求先看 git status、git diff、最近提交，再生成 commit message

一个简化版示例如下：

---
name: commit
description: 读取当前 git 仓库变更，生成规范的 commit message，并在用户明确要求时执行提交。
disable-model-invocation: true
user-invocable: true
allowed-tools:
  - Bash
argument-hint: "[commit message hint]"
effort: low
---

读取当前仓库变更，先总结改动，再生成提交信息。

执行步骤：

1. 查看 `git status --short`
2. 查看 `git diff HEAD`
3. 参考最近 5 条提交风格
4. 生成 commit message
5. 仅在用户明确要求时再执行提交

5.4 description 为什么最重要

大多数自动触发问题，都和 description 写得不够清楚有关。

写法上尽量同时说清楚这 3 件事：

1. 用户在什么场景下会需要它
2. 它要解决什么任务
3. 它输出什么结果

例如：

description: 当用户要求润色 Markdown 文档、补充说明、优化 README 或完善技术文档时使用。

这就比一句“用于优化内容”清楚得多。

5.5 自动生成 Skill 的两种方式

如果你不想手写，也可以先让工具帮你起草。

方式 1：直接让 Claude Code 帮你生成

方式 2：用内置的 /skill-creator 之类的能力引导生成

建议做法不是“生成完直接用”，而是先自己检查一遍：

• 触发条件是否写清楚
• 边界是否写清楚
• 有没有可能误触发高风险操作

---

6. Skill 怎么触发，以及怎么控制它的行为

6.1 自动触发

自动触发本质上依赖匹配。客户端会读取已安装 Skill 的描述，再根据用户当前输入判断要不要用它。

所以自动触发能否成功，通常取决于：

• description 是否准确
• 和别的 Skill 是否冲突
• 用户输入是否给出了足够明确的信号

6.2 手动触发

手动触发方式会因客户端而异：

• 在 Claude Code 里，常见是 /技能名
• 在 Codex 里，常见是 $SkillName 或由上下文规则触发

写文档时，最好不要只写一句“用命令调用”，而要把不同客户端的调用方式分开写清楚。

6.3 禁用高风险自动触发

像提交代码、部署、发消息、改线上配置这类有副作用的动作，不建议自动触发。

这时候应该加上：

disable-model-invocation: true

含义很直接：

• 可以存在这个 Skill
• 但模型不能自己决定调用它

6.4 只允许后台自动使用，不让用户手动点

如果某个 Skill 只是一个“幕后能力”，不想暴露给用户直接调用，可以写：

user-invocable: false

这样它可以作为系统内部工作流的一部分存在，但不会出现在显式调用列表里。

---

7. 怎么查看、禁用和管理 Skill

如果你想看当前到底装了哪些 Skill，可以直接打开技能列表界面：

常见管理动作有 3 类：

7.1 查看

• 看看当前有哪些 Skill
• 确认来源是用户手动安装，还是 Plugin 托管
• 顺便看上下文占用

7.2 临时禁用

如果客户端支持列表开关，通常按下面方式即可：

1. 输入 /skills
2. 用方向键选择技能
3. 按 Space 切换 on/off
4. 按 Enter 保存

7.3 删除

• 自己手动装的 Skill：直接删除对应目录
• Plugin 托管的 Skill：往往不能单独删，只能禁用或卸载整个 Plugin

如果你发现某些 Skill 平时根本不用，尽早关掉，能减少干扰和误触发。

---

8. 常见问题排查

8.1 安装失败

优先检查这几项：

• 网络是否能正常访问对应仓库或市场
• 地址是否写错
• 权限是否足够
• 当前客户端是否已经支持相应 Skill / Plugin 能力

如果网络一直不稳定，最稳的方式还是回到“手动复制目录”。

8.2 安装后不生效

最常见的原因有：

• SKILL.md 文件名不对
• 目录多嵌套了一层
• 放错到了别的目录
• 客户端没有重新加载

正确结构应该类似：

~/.claude/skills/md-polish/SKILL.md

而不是：

~/.claude/skills/md-polish/md-polish/SKILL.md

8.3 能看到 Skill，但从不自动触发

优先看：

• description 是否太泛
• 是否和其他 Skill 描述重叠
• 是否设置了 disable-model-invocation: true
• 用户输入是不是没有明确触发信号

8.4 插件冲突

如果装了多个功能相近的大插件，最容易出现：

• 同类 Skill 互相抢触发
• 命令命名空间冲突
• 上下文占用过高

处理方式通常是：

• 用 /plugin list 或等价命令查看来源
• 卸载功能高度重叠的整包
• 只保留你真正常用的一套

8.5 斜杠命令提示“未知命令”

常见原因：

• 命令名拼写不对
• 客户端不支持这种调用方式
• 插件没有正确加载
• 需要带命名空间调用

例如某些插件里的命令可能是：

/everything-claude-code:plan

而不是简单的 /plan。

---

9. 去哪里找现成 Skill / Plugin

学会安装后，下一个问题就是：去哪里找质量更高的能力包。

9.1 官方插件市场

官方市场通常是第一优先级，因为来源更清晰、兼容性也更容易判断。

适合做的事：

• 先看有没有官方或社区认证版本
• 再决定要装单个 Skill 还是整包 Plugin

9.2 技能分享站

常见站点包括：

• AgentSkill.sh
• Lobehub Skills
• ClawHub
• SkillHub
• Skills.sh
• SkillsMap

9.3 GitHub 直接找

如果你想自己判断质量，GitHub 往往仍然是最好用的入口。

可以直接搜索：

• Claude Code Skill
• Claude Code Plugin
• Codex Skill

筛选时重点看 4 件事：

1. 最近是否仍在维护
2. 文档是否完整
3. 是否明确写了支持的客户端
4. SKILL.md 是否把触发条件和边界写清楚

---

10. 一些常见社区 Plugin / Skill 方向

这一节不是“越多越好”的清单，而是给你一个选型参照。重点看它更适合哪类场景、安装方式和典型用法。

10.1 everything-claude-code

适合：

• 想一次装一整套开发工作流的人
• 需要计划、TDD、审查、安全扫描等成体系能力的人

安装示例：

/plugin marketplace add https://github.com/affaan-m/everything-claude-code
/plugin install everything-claude-code@everything-claude-code

Windows 用户如果文档要求手动复制 rules，再补这一步：

D:
cd \ClaudeSkillsLocal 2>nul || md \ClaudeSkillsLocal && cd \ClaudeSkillsLocal
git clone https://github.com/affaan-m/everything-claude-code.git
cd everything-claude-code
md %USERPROFILE%\.claude\rules
xcopy /E /I /Y rules\* %USERPROFILE%\.claude\rules\
cd ..
rd /s /q everything-claude-code

典型用法：

/plan "实现用户认证模块"
/tdd
/security-scan

10.2 superpowers

适合：

• 想把研发流程标准化
• 想强制走计划、执行、复盘的人

安装示例：

/plugin marketplace add https://github.com/obra/superpowers-marketplace
/plugin install superpowers@superpowers-marketplace

典型用法：

/superpowers:brainstorm "用户认证系统"
/superpowers:write-plan "实现 OAuth2 认证"
/superpowers:execute-plan

10.3 claude-mem

适合：

• 长期维护项目
• 多会话开发
• 想把项目规则长期记住

安装示例：

/plugin marketplace add https://github.com/thedotmack/claude-mem
/plugin install claude-mem@claude-mem

典型用法：

/mem-remember "这个项目使用 Spring Boot 和 MySQL"
/mem-recall "项目使用的技术栈"
/mem-list

10.4 ui-ux-pro-max-skill

适合：

• 前端页面设计
• 交互体验优化
• 想让设计类提示更有方法论

安装示例：

/plugin marketplace add https://github.com/nextlevelbuilder/ui-ux-pro-max-skill
/plugin install ui-ux-pro-max@ui-ux-pro-max-skill

典型用法：

/ui-design "登录页面"
/ux-optimize "用户注册流程"

10.5 beads

适合：

• 长时间开发会话
• 上下文密集型任务
• 想增强长期记忆管理

安装示例：

/plugin marketplace add https://github.com/steveyegge/beads
/plugin install beads@beads

典型用法：

/beads-store "项目关键信息"
/beads-retrieve "项目关键信息"
/beads-optimize

10.6 baoyu-skills

适合：

• 中文内容创作
• 信息图和 PPT 生成
• 偏中文场景的营销内容

安装示例：

/plugin marketplace add https://github.com/JimLiu/baoyu-skills
/plugin install baoyu-skills@baoyu-skills

典型用法：

/baoyu-xiaohongshu "AI 编程工具推荐"
/baoyu-infographic "Python 学习路径"
/baoyu-ppt "AI 技术分享"

10.7 claude-scientific-skills

适合：

• 科学研究
• 数据分析
• 学术或技术文档生成

安装示例：

/plugin marketplace add https://github.com/K-Dense-AI/scientific-agent-skills
/plugin install scientific-agent-skills@scientific-agent-skills

典型用法：

/scientific-analyze data.csv
/scientific-doc "实验报告"

10.8 Anthropic-Cybersecurity-Skills

适合：

• 安全研究
• 漏洞检测
• 安全审计工作流

安装示例：

/plugin marketplace add https://github.com/mukul975/Anthropic-Cybersecurity-Skills
/plugin install Anthropic-Cybersecurity-Skills@Anthropic-Cybersecurity-Skills

典型用法：

/security-scan
/vuln-scan
/security-audit

10.9 claude-scholar

适合：

• 文献搜索
• 文献综述
• 学术写作辅助

安装示例：

/plugin marketplace add https://github.com/Galaxy-Dawn/claude-scholar
/plugin install claude-scholar@claude-scholar

典型用法：

/scholar-search "machine learning"
/scholar-review "AI in healthcare"
/scholar-cite "paper_title"

10.10 Context7

适合：

• 保存项目上下文
• 跨会话检索记忆
• 长期维护复杂项目

安装示例：

/plugin marketplace add https://github.com/upstash/context7
/plugin install context7@context7

典型用法：

/context-save "项目关键信息"
/context-retrieve "项目技术栈"
/context-list

10.11 Firecrawl

适合：

• 网页抓取
• 内容提取
• 信息检索

安装示例：

/plugin marketplace add https://github.com/firecrawl-dev/firecrawl
/plugin install firecrawl@firecrawl

典型用法：

/firecrawl-crawl "https://example.com"
/firecrawl-extract "https://example.com"
/firecrawl-search "AI programming"

10.12 Playwright Plugin

适合：

• 网页自动化
• 截图
• E2E 测试

安装示例：

/plugin marketplace add https://github.com/playwright-community/claude-plugin
/plugin install playwright@claude-plugin

典型用法：

/playwright-navigate "https://example.com"
/playwright-screenshot
/playwright-test "test.spec.ts"

10.13 Frontend Design Plugin

适合：

• UI 组件生成
• 响应式布局
• 前端设计系统辅助

安装示例：

/plugin marketplace add https://github.com/frontend-design/frontend-design-plugin
/plugin install frontend-design@frontend-design-plugin

典型用法：

/frontend-generate "button component"
/frontend-responsive "dashboard"
/frontend-system "colors"

---

11. 按场景选组合

如果你不想一个个试，可以先按场景搭配。

场景	推荐组合	原因
个人开发	everything-claude-code + Context7	一套管流程，一套管上下文
团队协作	superpowers + claude-mem	一套管流程标准化，一套管团队共享记忆
UI/UX 设计	ui-ux-pro-max-skill + Frontend Design Plugin + Playwright Plugin	设计、实现、验证三段打通
内容创作	baoyu-skills + Firecrawl	一套负责创作，一套负责抓素材
安全审计	Anthropic-Cybersecurity-Skills	专门做安全工作流更直接
学术研究	claude-scientific-skills + claude-scholar + Firecrawl	分析、综述、资料抓取配合更顺
复杂项目	everything-claude-code + beads + Context7	流程、上下文、长期记忆一起补齐

---

12. 总结

记住 3 句话就够了：

1. Skill 是能力说明，Plugin 是能力包。
2. Skill 是否好用，关键看 description、边界约束和执行流程写得是否清楚。
3. 真正高质量的 Skill 文档，不只告诉你“怎么装”，还会告诉你“什么时候触发、为什么不生效、出了问题怎么查”。

如果你接下来还要继续扩写这份文档，最值得补的内容有 4 类：

• 你自己机器上的真实目录截图
• 你当前使用的客户端版本信息
• 某个具体 Skill 的实战案例
• 一次真实的排障过程

这样它就不只是入门介绍，而是一份能直接落地的配置参考。

【★,°:.☆(￣▽￣)/$:.°★ 】那么本篇到此就结束啦，如果有不懂 和 发现问题的小伙伴可以在评论区说出来哦，同时我还会继续更新关于【】的内容，请持续关注我 ！！