[快速上手]skills这种能提效的东东
[快速上手]skills这种能提效的东东
在claude code中skills 是以文件夹的形式存放在
项目目录/.claude/skills/skill-namel/
项目目录/.claude/skills/skill-name2/每个skill就是1个文件夹，每个skill至少包含一个SKILL.md【注意，必须是大写的SKILL】的定义文件
这个定义文件里面存放的是skill的元数据层与指令层的内容
在skill的这个文件夹里面，还可以放入其他类型的辅助文件，这些文件就是skill 的资源层（可选）
- 图示来自：技术爬爬虾
1个SKILL.md示例
先来写这个skill 的metadata，元数据用六个横杠包裹起来
---
name: 帮我写作
description: 结合用户提供的材料进行文案写作
---里面只需要填上这个skill 的名字然后它的描述就可以了
描述部分最重要是写清楚Al应该在什么时机来调用这个skill
元数据写完后，我们来写指令，指令部分就可以写的详细一点了
结合我发你的材料，撰写一篇深度文案，输出到项目根目录
如果是软件/AI/计算机相关的材料，请先阅读参考 references/ 里面所有的范文，学习我的行文风格。
如果是其他方面材料的则无需参考范文。
其他要求如下：
- 整体行文要流畅、易于口播
- 节奏感强：多用短句，逻辑清晰，观点有衔接，段落之间过渡自然，读起来顺滑。
- 正文用 2–4 个清晰的小节拆解。
- 观点鲜明：语气自信、果断，敢于下结论。
- 不需要写画面调度。
## 后续处理
你先检查我名下有没有 ai-docs的Github仓库，如果没有就用create_repository MCP工具来创建一个仓库，然后把你刚才写好的文件，用create_or_update_file MCP工具上传到这个仓库。一个完整的Skill 就定义完成了
总结，重点有3个
- 首先是目录结构：
.claude/skills/字母转markdown/SKILL.md - 第二个是skill 定义文件的文件名：
SKILL.md - 第三个就是这里的元数据
搞定后，你在claude中就能使用/skills看到咋们自定义的skill了
底层原理
情况1
情况2
最后
skills的进阶用法：资源层
还可以放入任意类型的辅助文件
这些文件就可以作为这个skill 的资源
比如
- 资源文件可以是可执行脚本
- 可以是补充说明文档
- 也可以是图片等其他的资源
在Agent Skilks开放标准有推荐：https://agentskills.io/what-are-skills
对比
skills编写难度较小只需要编写一个markdown 文件就可以使用基础功能
附录1、小彩蛋：其实你可以拖文件到claude code
他会自动把文件路径给粘贴到claude code对话框，自然就形成了那种你选中这个文件的样子
模拟了一部分GUI的那种效果
附录2、如果想将你某个项目的skills也放到全局生效，那你要把他移动一下
比如mac是这个全局的目录下面：~/.claude/skills/
➜ agent-skills-examples git:(main) ✗ mkdir -p ~/.claude/skills
➜ agent-skills-examples git:(main) ✗ cp -rf 帮我写作 ~/.claude/skills附录3、编写好的skill可以给哪些用？
- claude code
~/.claude/skills/
- codex
~/.codex/skills/
附录4、关于skill的安全性
由于 Skill 可以包含 Python 脚本并执行系统命令，安全性至关重要。Claude Agent SDK 默认在容器化环境（Docker Container）或受限的沙箱中运行这些 Skill1。
网络隔离：限制 Skill 只能访问特定的 URL（如 API 端点）。
文件系统隔离：Skill 只能读写特定的工作目录，无法访问宿主机的系统核心文件。
这是 Skill 区别于简单 Prompt 的重要特征：它是在一个受控的计算环境中运行的，而不仅仅是在文本框里生成文字。
参考资料
- 技术爬爬虾
- 一堆开源skills：https://skillmaster.cc/