Claude/OpenCode Skills 小白超详细讲解 + 知识整理

ninigogoup
1,647 阅读11分钟

Claude/OpenCode Skills 小白超详细讲解 + 知识整理

作为刚接触 Claude 和 OpenCode 的技术小白，不用被文中的专业词汇吓到，这篇内容会把 Skills 的核心知识拆成大白话解释 + 步骤化操作 + 核心区别，全程避开复杂术语，让你轻松搞懂 Skills 是什么、怎么用、有啥用。

一、先搞懂：Skills 到底是个啥？（核心定义）

大白话版本

Skills 是 Anthropic（Claude 的开发公司）在 2025 年 10 月推出、12 月开放的新功能，简单说就是给 AI 智能体（Agent）用的 “可重复使用的技能包” ，就像给 Claude/OpenCode 装了一个个 “专用工具”，装完之后 AI 就能按固定流程自动完成特定任务，不用你每次都反复教它怎么做。

官方简单定义

把流程性的工作知识（比如 “怎么采集热点做选题”“怎么打包 GitHub 项目”）封装成一个文件夹（不是单纯的文字），AI 需要时能自己调用，实现工作流程自动化，核心就是复用性（一次配置，无限次用）。

关键特点（小白必记）

  1. 是文件夹不是纯文字，里面能装指令、脚本、模板、参考资料；
  2. 适配 Claude Code、OpenCode，Codex/Cursor 等编程工具也兼容；
  3. 用自然语言触发（比如你说 “开始今日选题生成”，AI 就自动调用对应 Skills）；
  4. 能节省 Token（AI 的 “计算资源”），避免长对话里 AI 变 “笨”。

二、最容易懂的类比：Skills/Prompt/MCP 的区别（核心重点）

文中用 “带新人” 的例子特别形象，小白直接记这个类比，再也不会混淆：把AI 智能体（Agent） 比作刚入职的实习生（聪明但不懂公司规矩，不会干具体活），三者的作用完全不同：

名称类比核心作用特点小白理解的 “使用场景”
Prompt（指令）你站在实习生旁边当场口头交代任务给 AI 临时的、一次性的指令对话内有效，关了对话就消失；临场、反应式偶尔用一次的简单任务，比如 “帮我写一句公众号开头”“帮我改一下这段文字的语气”
Skills（技能包）给实习生一本公司内部 SOP 操作手册（文件夹形式，含步骤、模板、规范）给 AI 可重复使用的固定工作流程全局生效，随时调用；稳定复用，按需加载经常要做的重复性任务，比如 “每天采集热点做选题”“把 GitHub 项目打包成能用的软件”
MCP给实习生一张公司仓库的门禁卡让 AI 安全连接外部系统 / 工具，获取操作权限只负责 “开门”，不教 “怎么干活”AI 需要调用外部工具时用，比如 “让 AI 访问你的 GitHub 仓库”“让 AI 连接 Excel 软件读取数据”

一句话总结区别

  • Prompt：临时教一次，用完就忘；
  • Skills：一次性教会，终身会用；
  • MCP：给个权限，让 AI 能碰外部工具。

三、Skills 能做啥？看 2 个小白也能理解的实际案例

不用纠结复杂的技术实现，看案例就能直观知道 Skills 的价值，这两个案例也是文中的核心例子，覆盖内容创作和编程小白刚需：

案例 1：AI 选题系统（内容创作者刚需）

痛点

以前找选题，要手动刷微博、知乎、GitHub 等 8 个平台，筛选热点、想切入角度、定标题，每天花 2-3 小时，特别麻烦；

用 Skills 的解决方式

搭 1 个总控 AI（Agent）+3 个 Skills，你只需要说一句 “开始今日选题生成” ，AI 全自动完成：

  1. 热点采集 Skill：自动爬 8 个平台的最新科技热点（共 80 条）；
  2. 选题生成 Skill：按 “信息密度高、话题性强”4 个标准，筛选出 10 个选题（含事件描述 + 核心角度 + 标题）；
  3. 选题审核 Skill：按固定方法论审核选题，对不通过的选题给出修改意见，再让选题生成 Skill 重新优化，直到 100% 通过。
结果

原本 2-3 小时的工作，AI 3分钟完成，还能自己迭代优化，全程不用你动手。

案例 2：整合包生成器（编程小白刚需）

痛点

GitHub 上很多优秀开源项目（比如做数学动画的 Manim），没有前端界面，还要装各种环境 / 依赖，小白根本不会用；

用 Skills 的解决方式

做一个整合包生成器 Skill，你只需要把 GitHub 项目链接发给 AI，说一句 “帮我把这个项目做成整合包” ，AI 全自动完成：

  1. 自动克隆 GitHub 仓库、识别项目类型、解析需要安装的依赖；
  2. 自动生成前端界面（Gradio WebUI），适配 Windows/Mac 系统；
  3. 打包成解压即用的 ZIP 文件（含启动脚本、自动安装依赖，双击就能用）；
  4. 即使报错，把错误日志发给 AI，它能自己修复。
结果

编程小白不用懂代码 / 环境配置，直接用大佬的开源项目，完美解决 “想用好东西但不会装” 的痛点。

案例总结：Skills 的核心价值

把重复、有固定流程的工作交给 AI，节省你的时间，让你不用做机械劳动，核心就是实现工作流程自动化。

四、Skills 的基本结构：小白只需要记这些（不用自己写，先了解）

Skills 的本质是一个文件夹，文中讲了详细结构，小白不用一开始就自己创建，先记核心规则 + 必装文件，后续用现成的就行：

1. 文件夹命名硬性要求（必须遵守）

全小写 + 连字符，不能有空格、大写字母，比如：hotspot-collector（热点采集）、repo-packager（整合包生成）。

2. 核心文件（唯一必需 + 可选）

一个 Skill 文件夹里，只有 1 个文件是必须的，其他都是可选（小白用现成的 Skills 时，不用管可选文件）：

  • 必需文件：SKILL.md（AI 识别 Skills 的核心，相当于 “技能说明书”）；
  • 可选文件：scripts（脚本文件）、README.md（说明文档）、templates（模板文件）等。

3. 核心文件SKILL.md的固定结构（小白重点看，不用自己写）

这个文件分2 个必须部分，格式固定，Anthropic 官方有规范，小白后续用skill-creator（技能生成器）会自动生成，先了解结构：

第一部分：YAML 头部（用---包裹，AI 的 “技能名片”）

必须包含name（技能名）和description（技能描述），重点注意：描述必须用第三人称，不能说 “我 / 你”，否则 AI 识别出错。

yaml

---
name: 整合包生成器
description: 分析GitHub上的Python项目，生成Gradio WebUI，打包成Windows/Mac便携包，当用户发送GitHub URL并提及打包、部署时触发
---

✅ 正确示例：处理 Excel 文件并生成报告

第二部分：Markdown 主体（技能的 “操作步骤”）

包含 2 个核心模块，写清楚 AI 该怎么做、有什么例子：

  • 指令（Instructions） ：AI 的详细操作步骤，比如 “第一步克隆仓库，第二步解析依赖”；
  • 示例（Examples） ：具体的使用案例，比如 “输入 GitHub 链接：https://xxx，输出 ZIP 整合包”。
小要求

SKILL.md的正文控制在 500 行以内，AI 使用效果最好。

五、小白必学：Skills 的获取、安装、使用（步骤化操作，超简单）

作为小白，完全不用自己写 Skills，先用 Anthropic 官方开源的现成 Skills，安装和使用都只有几步，文中的方法已经简化，我再按小白视角整理成傻瓜式步骤：

第一步：获取现成的 Skills（官方开源，免费可用）

Anthropic 官方在 GitHub 上开源了大量实用 Skills，小白直接用，地址：github.com/anthropics/…

官方推荐小白先装的 Skills（最实用）

docx（处理 Word 文件）、frontend-design（做前端设计）、pdf（处理 PDF 文件）、skill-creator（技能生成器，重点装）、xlsx（处理 Excel 文件）。✅ 重点：skill-creator是能自动生成其他 Skills 的 Skills，装了它，后续你想要什么技能，直接让 AI 生成，不用自己写！

第二步：安装 Skills（2 种方法，小白推荐方法 1，更简单）

安装环境：打开Claude Code或OpenCode（小白推荐用 OpenCode，兼容更好），二选一即可，这里以 OpenCode 为例。

方法 1：命令安装（小白首选，复制粘贴就行）
  1. 打开 OpenCode，在对话框里输入下面的内容，把地址换成你要装的 Skills 地址（比如装 skill-creator）；
  2. 发送后，AI 会自动完成安装，全程不用你操作。

plaintext

安装这个skill，skill项目地址为: https://github.com/anthropics/skills/tree/main/skills/skill-creator

👉 装其他 Skills：只需要替换后面的 GitHub 地址，比如装xlsx，就把地址改成https://github.com/anthropics/skills/tree/main/skills/xlsx。

方法 2：手动安装（拖文件夹，适合想了解底层的小白）

  1. 先在电脑上创建对应文件夹（初始没有，手动建）；

    • Claude Code：创建路径~/.claude/skills；
    • OpenCode：创建路径~/.config/opencode/skill；（Mac/Windows 路径一致，直接复制创建就行）

  2. 从 GitHub 上下载 Skills 的文件夹，按要求改好名字（全小写 + 连字符）；

  3. 把改好名的文件夹，直接拖到上面创建的路径里；

  4. OpenCode 需要退出重进才能识别，Claude Code 不用（2.1.0 版本支持热重载）。

第三步：使用 Skills（超简单，自然语言触发）

安装完成后，不用记复杂命令，直接用日常说话的方式告诉 AI，AI 会自动识别并调用对应的 Skills：

  1. 打开 Claude Code/OpenCode；
  2. 在对话框里说你的需求（包含触发关键词，比如装了整合包生成器，就说 “帮我把这个 GitHub 项目做成整合包：https://xxx”）；
  3. （可选）先用Plan 模式让 AI 规划执行步骤，确认后再让 AI 执行；
  4. AI 全自动完成任务，全程不用你干预。

小技巧

把 Skills 装在全局目录（就是上面的安装路径），这样你在电脑任何文件夹打开 Claude/OpenCode，AI 都能识别到 Skills，不用重复安装。

六、Skills 的核心设计原则：渐进式披露（小白了解即可）

文中提到的 “渐进式披露” 是 Skills 的核心设计，小白不用深究原理，只需要知道它的作用是让 AI 更高效、更省资源：

大白话解释

就像你用手机 APP，点头像→进菜单栏→点设置→看详细配置，一步一步展示复杂内容，而不是一打开就把所有功能都堆在你面前。

对 AI 的作用

AI 调用 Skills 时，不会一次性加载所有内容，而是：

  1. 先加载技能元信息（比如 “这是一个整合包生成器，处理 GitHub 项目”），让 AI 知道有没有这个技能；
  2. 确认需要用这个技能后，再加载完整的 SKILL.md；
  3. 还不够的话，再按需加载脚本、模板等可选文件。

最终效果

  • 降低 AI 的 “认知负荷”，避免一次性加载太多内容导致出错；
  • 节省 Token（AI 的计算资源），长对话里 AI 也不会变 “笨”。

七、小白学习 Skills 的核心建议（避坑 + 进阶）

作为刚入门的小白，不用一开始就追求 “自己写 Skills”，按以下步骤来，轻松上手不踩坑：

入门阶段（先会用）

  1. 先装Anthropic 官方的现成 Skills，重点装skill-creator（技能生成器）；
  2. 用自然语言触发，体验 Skills 的自动化效果，比如用xlsx处理 Excel、用pdf处理 PDF，先感受 “省时间” 的价值；
  3. 熟悉 Claude Code/OpenCode 的基本操作，不用纠结底层原理。

进阶阶段（会生成）

  1. 用skill-creator让 AI帮你生成专属 Skills，比如你经常要 “把链接变成摘要”，直接告诉 AI “帮我生成一个链接摘要的 Skill”，AI 会自动生成SKILL.md和文件夹；
  2. 简单修改生成的 Skills，比如改一下触发关键词、操作步骤，适配自己的需求。

高阶阶段（会封装）

当你有固定的工作流程后，把自己的经验封装成专属 Skills，比如 “自媒体排版 Skill”“数据分析 Skill”，实现个人工作全自动化（小白暂时不用考虑）。

八、核心知识速记（小白收藏版，一分钟回顾）

  1. Skills 是给 AI 的可复用技能包，核心是复用性 + 自动化；
  2. 形式是文件夹，唯一必需文件是SKILL.md，文件夹命名要全小写 + 连字符；
  3. 和 Prompt 的区别：Prompt 临时用，Skills 终身用；
  4. 小白不用自己写，先装官方开源 Skills，重点装skill-creator；
  5. 安装用命令法（复制粘贴），使用用自然语言触发（日常说话）；
  6. 核心价值：把重复工作交给 AI，节省你的时间。

备注：一枚刚开始学习AI的设计师，日常学习总结，非原创。

avatar
文章
阅读
粉丝