新闻详情

新闻详情

首页 / 资讯中心 / 详情

【Claude Code使用指南】添加Skills的两种方式:marketplace与SKILL.md配置实战

发布时间:2026/11/16 8:29:14来源:尧图网络
【Claude Code使用指南】添加Skills的两种方式:marketplace与SKILL.md配置实战
1. Claude Code 的 Skills 到底是什么为什么值得折腾Claude Code 用久了会发现一个现象每次让它做同类任务都要重复交代一遍背景。比如你希望它生成 drawio 流程图第一次得告诉它文件放哪、导出什么格式、命名规则是什么第二次、第三次还是得再说一遍。Skills 就是来解决这个问题的——它本质是一份写给 Claude Code 看的说明书文档告诉它在什么场景下、按什么步骤干活。你可以把 Skills 理解成给 Claude Code 装的「操作手册」。它和 MCP 不一样MCP 是接外部工具和数据源Skills 是教 Claude Code 怎么用已有的能力完成特定任务。一个 Skill 的核心就是一个SKILL.md文件里面写清楚触发条件、工作流程、命令示例。当你的请求匹配到 description 里描述的场景Claude Code 就会自动加载并执行这套流程。这篇聚焦两种添加路径一是通过 marketplace 安装现成插件这是最省事的方式二是手写SKILL.md配合自定义 marketplace 目录适合需要定制功能的场景。两种方式我都会给出可复制的配置和验证方法面向本地开发环境Windows 和 macOS 路径会分别说明。如果你只是想快速用上别人写好的 Skills看第 2 节就够了想自己造轮子第 3 节开始是重点。2. 前置准备TaoToken 接入与 Claude Code 环境确认在折腾 Skills 之前得先保证 Claude Code 本身能正常跑起来。Claude Code 需要配置 API 接入点这里我用 TaoToken 来做接入它的 API 地址是https://taotoken.net/api兼容 Anthropic 的接口格式配置起来比较直接。先确认你的 Claude Code 版本。打开终端输入claude --version如果提示命令不存在说明还没装。安装方式按官方文档走装完后需要配置环境变量指向接入点。在 Windows 的 PowerShell 里$env:ANTHROPIC_BASE_URLhttps://taotoken.net/api $env:ANTHROPIC_API_KEY你的API KeymacOS 或 Linux 的 bash/zshexport ANTHROPIC_BASE_URLhttps://taotoken.net/api export ANTHROPIC_API_KEY你的API KeyAPI Key 在 TaoToken 控制台的 API Keys 页面生成地址是https://taotoken.net/console/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi_keysutm_campaignrewrite。生成后复制出来注意别提交到 git 仓库里。配置完启动 Claude Codeclaude能正常进入会话就说明接入没问题。这一步很关键因为后面所有 Skills 的加载和触发都依赖 Claude Code 会话本身能正常工作。如果这里就报连接错误先排查 API Key 和 base URL 是否写对别急着往下走。注意环境变量只在当前终端会话生效。想持久化的话Windows 用setxmacOS 写进~/.zshrc或~/.bash_profile。3. 方式一通过 marketplace 安装现成插件这是最简单的路径。很多官方和社区插件都自带 Skills装完就能用不需要自己写任何配置文件。3.1 用命令直接安装在 Claude Code 会话里运行/plugin install code-simplifierclaude-plugins-official这条命令的意思是从claude-plugins-official这个 marketplace 里安装名为code-simplifier的插件。插件里自带的 Skills 会一并装好。类似的还有update-config、simplify、loop等都是官方插件库里比较常用的。3.2 用菜单浏览安装如果你不确定插件名可以输入/plugin然后选择Discover会列出当前 marketplace 里所有可安装的插件。找到需要的那个回车安装即可。这种方式适合第一次探索能看到每个插件的描述再决定装不装。3.3 安装后重启生效装完插件后Skills 通常不会立刻在当前会话生效。退出 Claude Code 再重新进入/exit claude重启后输入/就能看到新加载的 Skills 列表。如果没看到先确认插件是否真的装上了用/plugin查看已安装列表。4. 方式二手写 SKILL.md 配合自定义 marketplace现成插件满足不了需求时就得自己写。核心思路是创建一个自定义 marketplace 目录在里面放插件目录插件目录里放SKILL.md。Claude Code 通过加载这个自定义 marketplace 来识别你的 Skills。4.1 目录结构要求先看整体结构这个层级不能错marketplace-name/ └── .claude-plugin/ └── marketplace.json └── skill-name/ ├── .claude-plugin/ │ └── plugin.json └── skills/ └── SKILL.md几个关键点marketplace 根目录下必须有.claude-plugin/marketplace.json每个插件目录下必须有.claude-plugin/plugin.jsonSkills 放在插件目录的skills/子目录里每个 Skill 一个SKILL.md。4.2 marketplace.json 配置这是市场的入口文件格式如下{ $schema: https://anthropic.com/claude-code/marketplace.schema.json, name: custom-plugins, description: Directory of custom Claude Code extensions, owner: { name: 你的名字, email: youremail.com }, plugins: [ { name: drawio, description: Use when user requests diagrams, flowcharts, architecture charts, version: 1.0.0, source: ./drawio, skills: [./drawio/skills] } ] }这里有两个字段特别容易写错我踩过坑。source必须是字符串不能写成对象// 错误 { source: { directory: ./drawio } } // 正确 { source: ./drawio }skills必须是字符串数组不能写成对象数组// 错误 { skills: [{ name: drawio, path: ./drawio/skills }] } // 正确 { skills: [./drawio/skills] }写错这两个字段加载时会直接报Invalid schema错误。4.3 plugin.json 配置每个插件目录下的.claude-plugin/plugin.json{ name: drawio, description: Use when user requests diagrams, flowcharts, architecture charts, author: { name: 你的名字, email: youremail.com } }description字段很重要它决定了 Claude Code 什么时候会主动触发这个 Skill。写得越贴近用户实际会说的话触发越准。4.4 SKILL.md 模板这是 Skill 的核心文档。必需部分包括 Overview、When to Use、Workflow可选部分有 Prerequisites、Commands、Common Mistakes。一个可复制的模板--- name: drawio description: Use when user requests diagrams, flowcharts, architecture charts, or says 画图, diagram, visualize --- ## Overview Generate .drawio XML files and export to PNG/SVG/PDF locally. ## When to Use **Explicit triggers:** user says 画图, diagram, visualize, flowchart **Proactive triggers:** - Explaining a system with 3 components - Describing multi-step processes ## Workflow 1. Detect CLI availability 2. Plan the diagram structure 3. Generate .drawio XML 4. Export draft to PNG 5. Self-check output 6. Review loop with user 7. Final export ## Commands bash drawio --export --format png --output diagram.png diagram.drawioCommon MistakesForgetting to escape XML special charactersNot checking CLI installation before generating注意 frontmatter 里的 description 要包含用户可能用的关键词中英文都写上触发命中率会高很多。 ### 4.5 添加自定义 marketplace 的步骤 目录和文件都准备好后在 Claude Code 会话里操作 第一步把整个 marketplace 目录放到 Claude Code 的插件目录下。Windows 路径通常是 text C:\Users\你的用户名\.claude\plugins\marketplaces\macOS 是~/.claude/plugins/marketplaces/第二步在会话里输入/plugin选择Add marketplace然后输入你创建的 marketplace 路径。第三步重新加载插件/reload-plugins第四步用/plugin查看已安装的插件和 Skills确认你的 Skill 出现在列表里。5. 验证 Skills 是否被正确加载装完不等于生效得验证。最直接的方式是在 Claude Code 会话里输入/会弹出可用 Skills 列表。如果你的 Skill 在里面说明加载成功。再进一步测试触发。比如你的 Skill 描述里写了「画图」「diagram」那就直接输入帮我画一个三层架构的流程图如果 Claude Code 自动应用了你的 Skill你会看到它按照SKILL.md里定义的 Workflow 步骤来执行而不是随便给你一段文字描述。这一步能验证 description 的触发条件写得准不准。还可以用/plugin命令查看插件详情确认 Skills 路径被正确识别。如果列表里没有回到第 4 节检查目录结构和 JSON 格式。6. 常见错误排查加载失败基本集中在几个点上我整理成对照表错误信息原因解决方案Invalid schema: plugins.0.source: Invalid inputsource 写成了对象改为source: ./skill-nameInvalid schema: plugins.0.skills: Invalid inputskills 写成了对象数组改为skills: [./skill-name/skills]技能不显示skills 目录路径错误检查 skills 文件夹和 SKILL.md 是否存在marketplace 添加失败JSON 格式错误用 JSON 验证器检查语法Skill 装了但不触发description 关键词不匹配在 description 里补充用户常用说法还有一个容易忽略的点SKILL.md的 frontmatter 必须用---包裹且name和description不能少。少了任何一个Skill 可能加载但不会触发。如果排查完还是不行可以到 TaoToken 的接入文档对照 API 配置是否有问题地址是https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite。有时候不是 Skills 的问题而是会话本身没连上。7. 接下来怎么走如果你只需要现成功能直接走 marketplace 安装那条路几分钟就能用上。官方插件库里的code-simplifier、update-config这些覆盖了大部分日常场景。想验证模型对话效果可以在https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_contentmodel_chatutm_campaignrewrite里先试试触发词。如果你要定制手写SKILL.md是绕不开的。建议从一个最小可用的 Skill 开始比如就写一个「生成 commit message」的跑通整个流程后再加复杂度。长期做编码和 Agent 任务的话Coding Plan 的额度更划算地址在https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding_planutm_campaignrewrite。最后提醒一句只装可信来源的插件。Skills 本质是让 Claude Code 执行你写的指令来源不明的插件可能访问文件系统或执行命令。自己写的至少心里有数别人的先看一遍SKILL.md内容再决定。
网站建设高端定制企业官网
RELATED

相关资讯

更多精彩内容,欢迎继续阅读

较早相关资讯

最新相关资讯

【外设】之大彩串口显示屏 2026/11/15 4:54:16

【外设】之大彩串口显示屏

大彩串口屏初步使用 1 .官网下载 STM32 屏幕 GUI 设计资料 http://www.gz-dc.com/category/typeid/4112 找到 STM32 Keil 工程,移植相关代码因项目而异进行移植,由于项目简单,本人只对用到的指令接口进行修改。 比如:注意事项&…

阅读更多 →
无法下载Windows系统iso文件 2026/11/15 2:04:12

无法下载Windows系统iso文件

当我遇到这个问题的时候,我打开了一个网站: 登录 然后我打算下载的时候: 突然那个官方的连接就可以下载了:

阅读更多 →
【清华代码熊】DeepSeek V4.1 Flash 后训练详解 2026/11/14 10:11:15

【清华代码熊】DeepSeek V4.1 Flash 后训练详解

📌 上期解析了 DeepSeek V4.1 Flash 模型架构改进,本期解析 DeepSeek V4.1 Flash 预训练/后训练技术: 🌟 预训练:45T 文本 多模态混合语料、直接训练 sparse attention(取消 DeepSeek V4 的 dense 冷启动&…

阅读更多 →
Shuffle-R1: Efficient RL framework for Multimodal Large Language Models via Data-centric Dynamic ... 2026/11/16 6:47:19

Shuffle-R1: Efficient RL framework for Multimodal Large Language Models via Data-centric Dynamic ...

文章主要内容和创新点 主要内容 本文聚焦于多模态大语言模型(MLLM)强化学习(RL)训练中的效率问题,提出了一个名为Shuffle-R1的框架。研究发现,当前RL训练存在两个关键缺陷: 优势值坍缩(Advantage Collapsing):批次中大多数优势值集中在零附近,导致有效梯度信号被淹…

阅读更多 →
PRvL: Quantifying the Capabilities and Risks of Large Language Models for PII Redaction 2026/11/14 16:35:50

PRvL: Quantifying the Capabilities and Risks of Large Language Models for PII Redaction

一、文章主要内容总结 本文聚焦于利用大型语言模型(LLMs)实现个人身份信息(PII)脱敏的研究,旨在解决传统脱敏方法(如基于规则的系统、领域特定命名实体识别(NER)模型)泛化能力差、跨格式/跨语境适应性弱的问题。 研究通过全面评估多种LLM架构(包括密集型LLM(D-LLM…

阅读更多 →
LLaVA-RE: Binary Image-Text Relevancy Evaluation with Multimodal Large Language Model 2026/11/15 4:06:36

LLaVA-RE: Binary Image-Text Relevancy Evaluation with Multimodal Large Language Model

文章主要内容和创新点 主要内容 本文聚焦于二进制图像-文本相关性评估任务(判断图像与文本“相关”或“不相关”),针对该任务中文本格式多样、相关性定义随场景变化等挑战,提出了基于多模态大语言模型(MLLM)的解决方案LLaVA-RE。 模型设计:LLaVA-RE基于LLaVA 1.5架构,…

阅读更多 →

今日资讯

本周资讯

本月资讯

看完文章仍有疑问?

联系尧图顾问,获取一对一建站咨询

立即免费咨询 📞 400-888-8888
📞 ✉