文章目录一、Agent Skill 核心概念是什么1. 基础定义2. 通俗核心比喻一本带目录的分层书籍3. Agent Skill 核心特点二、Skill 完整配置实操三步搞定第一步搭建专属技能库文件夹固定路径必须遵守第二步编写核心SKILL.md文件技能包灵魂模拟示例1CSV/Excel数据分析助手skill文件夹名csv-data-summarizer模拟示例2Python代码调试助手skill文件夹名python-debugger模拟示例3PDF转Word内容提取助手skill文件夹名pdf-to-word-extractor模拟示例4Git自动化操作助手skill文件夹名git-automator模拟示例5Markdown格式美化助手skill文件夹名markdown-formatter第三步技能加载与触发实操使用三、核心机制补充与安全、权限提示1. 渐进式披露核心机制必懂2. 安全使用提示重中之重3. 完全权限模式谨慎开启四、完整技能文件夹层级样例参考五、优质常用Skill资源网站直接收藏不管是刚接触AI编程工具还是想优化AI调用效率、减少token消耗Agent Skill都是核心实用功能。这份指南会用最通俗的语言拆解Agent Skill的核心概念、完整配置流程、实操技巧和安全注意事项新手也能一步步看懂、跟着做。一、Agent Skill 核心概念是什么1. 基础定义Agent Skill也常叫Claude Skill是AI公司Anthropic推出的基于文件系统的模块化AI能力标准简单来说就是给AI定制的“专属技能包”而且是一套通用、可复用的标准化技能体系。它的核心运行逻辑是**“渐进式披露”**的提示词管理机制采用分层管理、按需调用的模式彻底解决了传统AI提示词的痛点问题。2. 通俗核心比喻一本带目录的分层书籍大家可以直接把Agent Skill理解成一本带完整目录、正文和附录的工具书对比传统AI提示词优势特别明显传统System Prompt系统提示词是把所有规则、指令、要求一次性全部塞给AI不仅会大量浪费tokenAI计算资源还会让AI接收信息太多、逻辑混淆反而答非所问、执行出错而Agent Skill只有用到的时候才加载对应内容-也就是所谓的按需加载绝不浪费资源。具体分为三层每层分工明确、互不干扰第一层元数据Metadata≈ 书籍目录核心内容只有技能名称和简短的功能描述是最精简的核心信息。加载机制AI启动时就会始终加载这部分全程只看“目录”快速判断用户的问题是否需要调用这个技能包。核心优势体积极小几乎不占用token和AI内存启动速度超快不会给AI造成任何负担。第二层指令Instructions≈ 书籍正文核心内容这是技能包的核心包含具体的执行提示词、详细操作步骤、严格约束条件、触发规则等相当于告诉AI具体该怎么干活。加载机制按需加载只有AI通过目录判断确定需要用这个技能时才会把这部分内容读进AI上下文不用的时候完全不加载。第三层资源Resources≈ 书籍附录核心内容辅助执行的各类文件比如scripts文件夹里的Python/Bash脚本、templates文件夹里的输出模板、参考数据、配置文件等是技能执行的“工具素材”。加载机制按需调用只有在执行正文指令的过程中需要用到这些文件时才会单独读取用完即走不常驻内存。3. Agent Skill 核心特点通用标准化不只是Anthropic自家的Claude支持Cursor、Codex、OpenCode等主流新一代AI编程工具都已经全面适配这个标准学会一套多款工具通用。超低资源消耗完美解决了AI能力越多、上下文窗口Context Window越臃肿、运行越慢的痛点哪怕装几十个技能包AI也不会变卡顿、变迟钝。搭配MCP实现复杂工作流Agent Skill负责定义标准化作业流程SOP告诉AI“该做什么、按什么步骤做”MCP负责提供工具接口比如本地文件读写、代码执行、系统操作等告诉AI“该用什么工具做”两者搭配就能让AI完成复杂的自动化任务不再是简单问答。注MCP模型控制协议是连接AI与本地工具如文件读写、代码执行的接口协议无需深入理解搭配Skill即可实现自动化操作。二、Skill 完整配置实操三步搞定前提准备已安装好Claude Code并完成基础配置如API密钥配置确保Claude Code能正常启动使用。接下来按照三步流程就能顺利搭建并加载技能包。第一步搭建专属技能库文件夹固定路径必须遵守Claude Code有固定的技能扫描路径会自动读取用户根目录下的.claude/skills文件夹所有技能包都要放在这个路径里千万不要随意更改层级否则AI识别不到。Windows系统标准路径C:\Users\你的用户名\.claude\skills\macOS/Linux系统标准路径~/.claude/skills/可通过终端输入cd ~/.claude/skills/快速进入每个独立技能都要单独建一个子文件夹文件夹命名推荐用kebab-case格式小写字母短横线比如pdf-summary、git-automator方便识别和管理标准文件夹层级结构如下# Windows系统示例 C:\Users\用户名\.claude\skills\ # 技能总根目录所有技能包都存在这 │ ├── pdf-summary\ # 单个技能包PDF总结助手 │ │ │ ├── SKILL.md # 核心必备文件文件名必须大写SKILL.md不能改 │ │ │ ├── scripts\ # 技能执行脚本文件夹存放Python、Bash等执行代码 │ │ └── extract.py # 具体脚本文件 │ │ │ └── templates\ # 输出模板文件夹存放固定格式的输出模板 │ └── format.txt │ └── git-automator\ # 第二个技能包Git自动化助手 └── SKILL.md # 每个技能包都必须有这个核心文件 # macOS/Linux系统示例 ~/.claude/skills/ │ ├── python-debugger/ # Python代码调试助手 │ ├── SKILL.md │ └── scripts/ │ └── debug.py └── markdown-formatter/ # Markdown格式美化助手 └── SKILL.md⚠️ 注意SKILL.md文件名必须全部大写不可改为skill.md、Skill.md否则Claude无法识别该技能包导致加载失败。第二步编写核心SKILL.md文件技能包灵魂SKILL.md是Agent Skill的核心Claude会先读取文件顶部的元数据判断是否触发这个技能新手不用从零手写GitHub等平台有大量官方和第三方优质现成技能直接下载使用即可重点看懂文件结构就行。文件分为元数据区、指令区、资源区三部分以下是5个不同场景的模拟Skill示例贴合新手常用需求可直接复制使用覆盖数据处理、代码调试、文档转换、Git操作、Markdown排版方便新手举一反三。模拟示例1CSV/Excel数据分析助手skill文件夹名csv-data-summarizer--- # 【1. 元数据区 / Metadata】 # 核心作用Claude启动时只加载这一小段description必须精准写清功能只有用户问题匹配这段描述才会加载后续指令 name: csv-data-summarizer description: 调用Python和pandas库自动分析CSV/Excel表格数据生成专业统计摘要快速绘制数据可视化图表 metadata: version: 2.1.0 dependencies: python3.8, pandas2.0.0 --- # CSV Data SummarizerCSV数据总结助手 !-- 【2. 指令区 / Instructions】技能触发后AI严格按照这里的规则执行任务 -- ## When to Use触发时机 满足以下任意一种情况自动触发该技能 - 用户上传或引用本地CSV/Excel文件 - 用户要求对表格数据做摘要、清洗、分析、可视化 - 用户想要查看表格数据结构、数据质量、缺失值情况 ## Critical Behavior核心行为准则 ⚠️ 硬性执行规则必须遵守 1. 禁止反复询问用户意图不提问“你想让我做什么”“需要分析哪部分”直接自主执行 2. 立即全量自动化分析自动读取文件、完成数据清洗、生成统计结果和图表一次性输出 3. 智能场景适配根据数据类型销售、财务、客户数据等自动匹配对应的分析逻辑无需用户额外指定 ## Automatic Steps自动化执行步骤 1. 数据加载与校验读取CSV/Excel文件到pandas DataFrame检查文件格式、编码是否正常 2. 数据结构识别自动判断每列数据类型日期、数值、文本分类、布尔值等 3. 深度数据分析针对不同数据类型生成基础统计、缺失值分析、相关性分析、趋势分析等 4. 结果输出整合数据概览、统计报表、异常值提示、可视化图表清晰展示给用户 --- # Files【3. 资源区 / Resources】 !-- 列出该技能需要调用的本地文件都放在同级目录AI执行时自动调用 -- - analyze.py核心数据分析脚本含清洗、统计、绘图逻辑 - requirements.txtPython依赖清单执行pip install -r requirements.txt一键安装 - resources/sample.csv测试用示例数据方便验证技能是否正常运行模拟示例2Python代码调试助手skill文件夹名python-debugger--- # 【1. 元数据区 / Metadata】 name: python-debugger description: 自动检测Python代码语法错误、逻辑漏洞给出具体修改建议支持代码逐行调试和异常排查适配新手编程场景 metadata: version: 1.0.0 dependencies: python3.7, pylint2.15.0 --- # Python Code DebuggerPython代码调试助手 !-- 【2. 指令区 / Instructions】 -- ## When to Use触发时机 满足以下任意一种情况自动触发该技能 - 用户粘贴Python代码询问语法错误、逻辑漏洞 - 用户反馈代码运行报错需要排查异常 - 用户想要优化Python代码提升可读性和运行效率 ## Critical Behavior核心行为准则 ⚠️ 硬性执行规则必须遵守 1. 先定位问题再给出解决方案先明确指出错误位置、错误类型再提供可直接复制的修改代码 2. 适配新手解释错误原因时用通俗语言避免专业术语堆砌必要时补充基础知识点 3. 不冗余只针对报错和漏洞给出建议不额外添加无关的代码优化除非用户主动要求 ## Automatic Steps自动化执行步骤 1. 代码校验调用pylint工具检测代码语法错误、缩进问题、变量未定义等基础错误 2. 逻辑排查分析代码执行流程找出逻辑漏洞如循环死锁、条件判断错误、异常未捕获等 3. 解决方案生成针对每个问题给出具体修改建议提供修改后的完整代码标注修改位置 4. 补充说明简单解释错误原因和修改思路帮助新手理解并避免同类错误 --- # Files【3. 资源区 / Resources】 - debug.py核心调试脚本调用pylint实现错误检测生成调试报告 - requirements.txt依赖清单执行pip install -r requirements.txt一键安装 - examples/error_code.py常见错误代码示例辅助AI精准识别各类问题模拟示例3PDF转Word内容提取助手skill文件夹名pdf-to-word-extractor--- # 【1. 元数据区 / Metadata】 name: pdf-to-word-extractor description: 自动将本地PDF文件转换为可编辑的Word文档支持提取PDF中的文本、图片、表格保留原格式无需手动复制粘贴 metadata: version: 1.2.0 dependencies: python3.8, PyPDF23.0.1, python-docx0.8.11 --- # PDF to Word ExtractorPDF转Word内容提取助手 !-- 【2. 指令区 / Instructions】 -- ## When to Use触发时机 满足以下任意一种情况自动触发该技能 - 用户上传本地PDF文件要求转换为Word文档 - 用户需要提取PDF中的文本、图片或表格 - 用户希望将PDF内容整理为可编辑的文档格式 ## Critical Behavior核心行为准则 ⚠️ 硬性执行规则必须遵守 1. 保留原格式转换后的Word文档尽量保留PDF的排版、字体、图片位置、表格结构 2. 自动处理无需询问用户自动完成转换内容提取生成可直接编辑的Word文件 3. 异常提示若PDF为加密文件无法转换需明确提示用户“请先解除PDF加密”并给出简单的解密建议 ## Automatic Steps自动化执行步骤 1. 文件校验检查上传的PDF文件是否正常、是否加密若加密则提示用户解密 2. 内容提取提取PDF中的文本、图片、表格分类整理确保内容完整无遗漏 3. 格式转换将提取的内容导入Word文档调整排版保留原PDF的格式风格 4. 结果输出生成Word文件保存到与原PDF相同的目录提示用户文件保存路径 --- # Files【3. 资源区 / Resources】 - pdf2word.py核心转换脚本实现PDF转Word、内容提取功能 - requirements.txt依赖清单执行pip install -r requirements.txt一键安装 - templates/word_template.docxWord模板确保转换后的文档格式规范模拟示例4Git自动化操作助手skill文件夹名git-automator--- # 【1. 元数据区 / Metadata】 name: git-automator description: 自动执行Git常用操作提交、推送、拉取、分支创建简化Git命令流程避免新手输错命令导致代码丢失 metadata: version: 1.1.0 dependencies: git2.30.0, python3.7 --- # Git AutomatorGit自动化操作助手 !-- 【2. 指令区 / Instructions】 -- ## When to Use触发时机 满足以下任意一种情况自动触发该技能 - 用户需要执行Git提交、推送、拉取、分支创建等常用操作 - 用户不熟悉Git命令希望快速完成代码版本管理 - 用户需要检查Git仓库状态、查看提交记录 ## Critical Behavior核心行为准则 ⚠️ 硬性执行规则必须遵守 1. 操作前确认执行推送、删除分支等高危操作前询问用户确认避免误操作 2. 命令透明执行操作时显示对应的Git命令帮助新手学习记忆 3. 错误处理若操作失败如冲突、未登录明确提示错误原因并给出具体解决步骤 ## Automatic Steps自动化执行步骤 1. 仓库检测检查当前目录是否为Git仓库若不是提示用户“请先初始化Git仓库git init” 2. 操作识别根据用户需求识别需要执行的Git操作提交、推送、拉取等 3. 命令执行自动执行对应的Git命令实时反馈操作进度 4. 结果反馈操作成功后提示“操作完成”失败则给出错误原因和解决方法 --- # Files【3. 资源区 / Resources】 - git_operate.py核心脚本实现Git常用操作的自动化执行 - requirements.txt依赖清单无需额外安装确保本地已安装Git - commands.txtGit常用命令对照表方便新手查看学习模拟示例5Markdown格式美化助手skill文件夹名markdown-formatter--- # 【1. 元数据区 / Metadata】 name: markdown-formatter description: 自动美化Markdown文档格式统一标题层级、列表缩进、代码块样式去除冗余空行让文档更规范易读 metadata: version: 1.0.0 dependencies: python3.7, markdown-it-py2.2.0 --- # Markdown FormatterMarkdown格式美化助手 !-- 【2. 指令区 / Instructions】 -- ## When to Use触发时机 满足以下任意一种情况自动触发该技能 - 用户粘贴Markdown文本要求美化格式 - 用户上传Markdown文件需要统一格式规范 - 用户希望优化Markdown文档的可读性调整标题、缩进、代码块样式 ## Critical Behavior核心行为准则 ⚠️ 硬性执行规则必须遵守 1. 不改变内容仅美化格式不修改文档中的文字内容、链接、图片等核心信息 2. 格式统一标题层级#~######规范列表缩进一致代码块用正确格式包裹 3. 精简冗余去除多余空行、重复空格确保文档简洁规范不冗余 ## Automatic Steps自动化执行步骤 1. 内容读取读取用户提供的Markdown文本或文件解析文档结构 2. 格式优化统一标题层级、列表缩进规范代码块样式去除冗余空行 3. 预览生成生成美化后的Markdown文本提供预览效果 4. 结果输出输出美化后的完整文本提示用户可直接复制使用 --- # Files【3. 资源区 / Resources】 - format_markdown.py核心美化脚本实现Markdown格式的自动优化 - requirements.txt依赖清单执行pip install -r requirements.txt一键安装 - examples/before.md美化前的Markdown示例after.md美化后的示例方便对比第三步技能加载与触发实操使用重启Claude Code生效搭建好文件夹、放好SKILL.md和相关资源后关闭当前终端重新打开终端输入claude命令启动确保AI扫描到新的技能包。检查技能加载状态启动后在对话框输入指令/doctor或者直接用自然语言提问“你现在加载了哪些技能包”Claude会列出所有识别成功的技能比如pdf-summary、csv-data-summarizer能查到就说明配置成功。自然语言触发使用不用记复杂指令直接说日常话就能触发AI会自动匹配技能描述、调用对应技能。示例“帮我分析桌面上的年度销售报表.csv生成数据摘要和折线图”“读取这份annual_report.pdf帮我转换为Word并提取文本”“帮我调试这段Python代码报错了”。加载失败排查若加载失败可检查3点① 技能文件夹路径是否正确必须在.claude/skills/下② SKILL.md文件名是否大写③ 文件夹层级是否正确单个技能单独建子文件夹。三、核心机制补充与安全、权限提示1. 渐进式披露核心机制必懂这是Agent Skill最关键的逻辑也是它高效的原因Claude启动时绝不加载所有技能的全部内容只读取每个SKILL.md顶部的name和description元数据只有用户的问题和元数据里的功能描述精准匹配时才会把这个技能的指令正文、脚本资源加载进上下文。哪怕安装100个技能包也不会占用多余token不会让AI运行变慢、逻辑混乱效率始终在线。2. 安全使用提示重中之重⚠️ 重点提醒从GitHub、第三方网站下载陌生Skill时一定要提高警惕因为Agent Skill支持scripts脚本文件夹意味着它可以在你的本地电脑上执行任意Python、Shell命令拥有操作本地文件的权限。实操建议使用陌生技能前务必打开scripts文件夹查看里面的代码逻辑确认没有删除文件、篡改系统、恶意读写数据等风险再放入技能库使用。3. 完全权限模式谨慎开启如果不想每次AI调用技能、修改代码、执行脚本时都弹出权限确认提示可以开启完全自主权模式启动命令claude --dangerously-skip-permissions⚠️ 命令里的“dangerously”已经明确提示风险开启后【风险点】Claude会拥有本地操作全权直接修改代码、删除文件、安装依赖、执行系统命令全程不征求你的同意。【使用建议】只在信任的工作环境使用且提前通过Git提交所有代码做好版本备份方便出错后快速回滚不建议日常长期开启。前提Claude CLI版本≥1.0可通过输入claude --version查看版本若版本过低执行claude update升级四、完整技能文件夹层级样例参考# Windows系统示例 C:\Users\用户名\.claude\skills\ # 总根目录 │ ├── pptx-creation/ # 技能1PPT自动生成助手 │ │ │ ├── SKILL.md # 核心指令文件定义PPT制作规则 │ │ │ ├── scripts/ # 执行脚本库 │ │ └── generate_slides.py # Python脚本调用python-pptx生成PPT │ │ │ └── assets/ # 静态资源 │ ├── corporate_template.pptx # 企业专用PPT模板 │ └── layout_config.json # 页面布局配置文件 │ ├── xlsx-analysis/ # 技能2Excel数据清洗分析 │ │ │ ├── SKILL.md # 核心指令文件定义表格分析规则 │ │ │ ├── scripts/ # 执行脚本库 │ │ ├── clean_data.py # 数据清洗脚本处理空值、错误格式 │ │ └── create_pivot_table.py # 数据透视表生成脚本 │ │ │ └── examples/ # 示例参考库 │ ├── prompt_examples.txt # 提示词示例辅助AI精准执行 │ └── sample_output.xlsx # 输出结果样例规范输出格式 │ └── python-debugger/ # 技能3Python代码调试助手 ├── SKILL.md ├── scripts/ │ └── debug.py └── examples/ └── error_code.py五、优质常用Skill资源网站直接收藏直接收藏这些网站免费下载现成技能包省去手写麻烦下载后可直接使用https://skills.homes/zh-CN中文技能库适配国内用户https://skillsmp.com/zh中文精选Skill合集分类清晰https://github.com/ComposioHQ/awesome-claude-skillsGitHub优质合集种类超全https://github.com/anthropics/skills/tree/main/skillsAnthropic官方Skill库安全可靠下载技巧进入网站后找到所需技能包下载压缩包解压后将整个技能文件夹如pdf-summary复制到.claude/skills/目录下重启Claude Code即可加载。
Agent Skill 新手实操指南（完整版）
发布时间：2026/6/13 7:34:42
文章目录一、Agent Skill 核心概念是什么1. 基础定义2. 通俗核心比喻一本带目录的分层书籍3. Agent Skill 核心特点二、Skill 完整配置实操三步搞定第一步搭建专属技能库文件夹固定路径必须遵守第二步编写核心SKILL.md文件技能包灵魂模拟示例1CSV/Excel数据分析助手skill文件夹名csv-data-summarizer模拟示例2Python代码调试助手skill文件夹名python-debugger模拟示例3PDF转Word内容提取助手skill文件夹名pdf-to-word-extractor模拟示例4Git自动化操作助手skill文件夹名git-automator模拟示例5Markdown格式美化助手skill文件夹名markdown-formatter第三步技能加载与触发实操使用三、核心机制补充与安全、权限提示1. 渐进式披露核心机制必懂2. 安全使用提示重中之重3. 完全权限模式谨慎开启四、完整技能文件夹层级样例参考五、优质常用Skill资源网站直接收藏不管是刚接触AI编程工具还是想优化AI调用效率、减少token消耗Agent Skill都是核心实用功能。这份指南会用最通俗的语言拆解Agent Skill的核心概念、完整配置流程、实操技巧和安全注意事项新手也能一步步看懂、跟着做。一、Agent Skill 核心概念是什么1. 基础定义Agent Skill也常叫Claude Skill是AI公司Anthropic推出的基于文件系统的模块化AI能力标准简单来说就是给AI定制的“专属技能包”而且是一套通用、可复用的标准化技能体系。它的核心运行逻辑是**“渐进式披露”**的提示词管理机制采用分层管理、按需调用的模式彻底解决了传统AI提示词的痛点问题。2. 通俗核心比喻一本带目录的分层书籍大家可以直接把Agent Skill理解成一本带完整目录、正文和附录的工具书对比传统AI提示词优势特别明显传统System Prompt系统提示词是把所有规则、指令、要求一次性全部塞给AI不仅会大量浪费tokenAI计算资源还会让AI接收信息太多、逻辑混淆反而答非所问、执行出错而Agent Skill只有用到的时候才加载对应内容-也就是所谓的按需加载绝不浪费资源。具体分为三层每层分工明确、互不干扰第一层元数据Metadata≈ 书籍目录核心内容只有技能名称和简短的功能描述是最精简的核心信息。加载机制AI启动时就会始终加载这部分全程只看“目录”快速判断用户的问题是否需要调用这个技能包。核心优势体积极小几乎不占用token和AI内存启动速度超快不会给AI造成任何负担。第二层指令Instructions≈ 书籍正文核心内容这是技能包的核心包含具体的执行提示词、详细操作步骤、严格约束条件、触发规则等相当于告诉AI具体该怎么干活。加载机制按需加载只有AI通过目录判断确定需要用这个技能时才会把这部分内容读进AI上下文不用的时候完全不加载。第三层资源Resources≈ 书籍附录核心内容辅助执行的各类文件比如scripts文件夹里的Python/Bash脚本、templates文件夹里的输出模板、参考数据、配置文件等是技能执行的“工具素材”。加载机制按需调用只有在执行正文指令的过程中需要用到这些文件时才会单独读取用完即走不常驻内存。3. Agent Skill 核心特点通用标准化不只是Anthropic自家的Claude支持Cursor、Codex、OpenCode等主流新一代AI编程工具都已经全面适配这个标准学会一套多款工具通用。超低资源消耗完美解决了AI能力越多、上下文窗口Context Window越臃肿、运行越慢的痛点哪怕装几十个技能包AI也不会变卡顿、变迟钝。搭配MCP实现复杂工作流Agent Skill负责定义标准化作业流程SOP告诉AI“该做什么、按什么步骤做”MCP负责提供工具接口比如本地文件读写、代码执行、系统操作等告诉AI“该用什么工具做”两者搭配就能让AI完成复杂的自动化任务不再是简单问答。注MCP模型控制协议是连接AI与本地工具如文件读写、代码执行的接口协议无需深入理解搭配Skill即可实现自动化操作。二、Skill 完整配置实操三步搞定前提准备已安装好Claude Code并完成基础配置如API密钥配置确保Claude Code能正常启动使用。接下来按照三步流程就能顺利搭建并加载技能包。第一步搭建专属技能库文件夹固定路径必须遵守Claude Code有固定的技能扫描路径会自动读取用户根目录下的.claude/skills文件夹所有技能包都要放在这个路径里千万不要随意更改层级否则AI识别不到。Windows系统标准路径C:\Users\你的用户名\.claude\skills\macOS/Linux系统标准路径~/.claude/skills/可通过终端输入cd ~/.claude/skills/快速进入每个独立技能都要单独建一个子文件夹文件夹命名推荐用kebab-case格式小写字母短横线比如pdf-summary、git-automator方便识别和管理标准文件夹层级结构如下# Windows系统示例 C:\Users\用户名\.claude\skills\ # 技能总根目录所有技能包都存在这 │ ├── pdf-summary\ # 单个技能包PDF总结助手 │ │ │ ├── SKILL.md # 核心必备文件文件名必须大写SKILL.md不能改 │ │ │ ├── scripts\ # 技能执行脚本文件夹存放Python、Bash等执行代码 │ │ └── extract.py # 具体脚本文件 │ │ │ └── templates\ # 输出模板文件夹存放固定格式的输出模板 │ └── format.txt │ └── git-automator\ # 第二个技能包Git自动化助手 └── SKILL.md # 每个技能包都必须有这个核心文件 # macOS/Linux系统示例 ~/.claude/skills/ │ ├── python-debugger/ # Python代码调试助手 │ ├── SKILL.md │ └── scripts/ │ └── debug.py └── markdown-formatter/ # Markdown格式美化助手 └── SKILL.md⚠️ 注意SKILL.md文件名必须全部大写不可改为skill.md、Skill.md否则Claude无法识别该技能包导致加载失败。第二步编写核心SKILL.md文件技能包灵魂SKILL.md是Agent Skill的核心Claude会先读取文件顶部的元数据判断是否触发这个技能新手不用从零手写GitHub等平台有大量官方和第三方优质现成技能直接下载使用即可重点看懂文件结构就行。文件分为元数据区、指令区、资源区三部分以下是5个不同场景的模拟Skill示例贴合新手常用需求可直接复制使用覆盖数据处理、代码调试、文档转换、Git操作、Markdown排版方便新手举一反三。模拟示例1CSV/Excel数据分析助手skill文件夹名csv-data-summarizer--- # 【1. 元数据区 / Metadata】 # 核心作用Claude启动时只加载这一小段description必须精准写清功能只有用户问题匹配这段描述才会加载后续指令 name: csv-data-summarizer description: 调用Python和pandas库自动分析CSV/Excel表格数据生成专业统计摘要快速绘制数据可视化图表 metadata: version: 2.1.0 dependencies: python3.8, pandas2.0.0 --- # CSV Data SummarizerCSV数据总结助手 !-- 【2. 指令区 / Instructions】技能触发后AI严格按照这里的规则执行任务 -- ## When to Use触发时机 满足以下任意一种情况自动触发该技能 - 用户上传或引用本地CSV/Excel文件 - 用户要求对表格数据做摘要、清洗、分析、可视化 - 用户想要查看表格数据结构、数据质量、缺失值情况 ## Critical Behavior核心行为准则 ⚠️ 硬性执行规则必须遵守 1. 禁止反复询问用户意图不提问“你想让我做什么”“需要分析哪部分”直接自主执行 2. 立即全量自动化分析自动读取文件、完成数据清洗、生成统计结果和图表一次性输出 3. 智能场景适配根据数据类型销售、财务、客户数据等自动匹配对应的分析逻辑无需用户额外指定 ## Automatic Steps自动化执行步骤 1. 数据加载与校验读取CSV/Excel文件到pandas DataFrame检查文件格式、编码是否正常 2. 数据结构识别自动判断每列数据类型日期、数值、文本分类、布尔值等 3. 深度数据分析针对不同数据类型生成基础统计、缺失值分析、相关性分析、趋势分析等 4. 结果输出整合数据概览、统计报表、异常值提示、可视化图表清晰展示给用户 --- # Files【3. 资源区 / Resources】 !-- 列出该技能需要调用的本地文件都放在同级目录AI执行时自动调用 -- - analyze.py核心数据分析脚本含清洗、统计、绘图逻辑 - requirements.txtPython依赖清单执行pip install -r requirements.txt一键安装 - resources/sample.csv测试用示例数据方便验证技能是否正常运行模拟示例2Python代码调试助手skill文件夹名python-debugger--- # 【1. 元数据区 / Metadata】 name: python-debugger description: 自动检测Python代码语法错误、逻辑漏洞给出具体修改建议支持代码逐行调试和异常排查适配新手编程场景 metadata: version: 1.0.0 dependencies: python3.7, pylint2.15.0 --- # Python Code DebuggerPython代码调试助手 !-- 【2. 指令区 / Instructions】 -- ## When to Use触发时机 满足以下任意一种情况自动触发该技能 - 用户粘贴Python代码询问语法错误、逻辑漏洞 - 用户反馈代码运行报错需要排查异常 - 用户想要优化Python代码提升可读性和运行效率 ## Critical Behavior核心行为准则 ⚠️ 硬性执行规则必须遵守 1. 先定位问题再给出解决方案先明确指出错误位置、错误类型再提供可直接复制的修改代码 2. 适配新手解释错误原因时用通俗语言避免专业术语堆砌必要时补充基础知识点 3. 不冗余只针对报错和漏洞给出建议不额外添加无关的代码优化除非用户主动要求 ## Automatic Steps自动化执行步骤 1. 代码校验调用pylint工具检测代码语法错误、缩进问题、变量未定义等基础错误 2. 逻辑排查分析代码执行流程找出逻辑漏洞如循环死锁、条件判断错误、异常未捕获等 3. 解决方案生成针对每个问题给出具体修改建议提供修改后的完整代码标注修改位置 4. 补充说明简单解释错误原因和修改思路帮助新手理解并避免同类错误 --- # Files【3. 资源区 / Resources】 - debug.py核心调试脚本调用pylint实现错误检测生成调试报告 - requirements.txt依赖清单执行pip install -r requirements.txt一键安装 - examples/error_code.py常见错误代码示例辅助AI精准识别各类问题模拟示例3PDF转Word内容提取助手skill文件夹名pdf-to-word-extractor--- # 【1. 元数据区 / Metadata】 name: pdf-to-word-extractor description: 自动将本地PDF文件转换为可编辑的Word文档支持提取PDF中的文本、图片、表格保留原格式无需手动复制粘贴 metadata: version: 1.2.0 dependencies: python3.8, PyPDF23.0.1, python-docx0.8.11 --- # PDF to Word ExtractorPDF转Word内容提取助手 !-- 【2. 指令区 / Instructions】 -- ## When to Use触发时机 满足以下任意一种情况自动触发该技能 - 用户上传本地PDF文件要求转换为Word文档 - 用户需要提取PDF中的文本、图片或表格 - 用户希望将PDF内容整理为可编辑的文档格式 ## Critical Behavior核心行为准则 ⚠️ 硬性执行规则必须遵守 1. 保留原格式转换后的Word文档尽量保留PDF的排版、字体、图片位置、表格结构 2. 自动处理无需询问用户自动完成转换内容提取生成可直接编辑的Word文件 3. 异常提示若PDF为加密文件无法转换需明确提示用户“请先解除PDF加密”并给出简单的解密建议 ## Automatic Steps自动化执行步骤 1. 文件校验检查上传的PDF文件是否正常、是否加密若加密则提示用户解密 2. 内容提取提取PDF中的文本、图片、表格分类整理确保内容完整无遗漏 3. 格式转换将提取的内容导入Word文档调整排版保留原PDF的格式风格 4. 结果输出生成Word文件保存到与原PDF相同的目录提示用户文件保存路径 --- # Files【3. 资源区 / Resources】 - pdf2word.py核心转换脚本实现PDF转Word、内容提取功能 - requirements.txt依赖清单执行pip install -r requirements.txt一键安装 - templates/word_template.docxWord模板确保转换后的文档格式规范模拟示例4Git自动化操作助手skill文件夹名git-automator--- # 【1. 元数据区 / Metadata】 name: git-automator description: 自动执行Git常用操作提交、推送、拉取、分支创建简化Git命令流程避免新手输错命令导致代码丢失 metadata: version: 1.1.0 dependencies: git2.30.0, python3.7 --- # Git AutomatorGit自动化操作助手 !-- 【2. 指令区 / Instructions】 -- ## When to Use触发时机 满足以下任意一种情况自动触发该技能 - 用户需要执行Git提交、推送、拉取、分支创建等常用操作 - 用户不熟悉Git命令希望快速完成代码版本管理 - 用户需要检查Git仓库状态、查看提交记录 ## Critical Behavior核心行为准则 ⚠️ 硬性执行规则必须遵守 1. 操作前确认执行推送、删除分支等高危操作前询问用户确认避免误操作 2. 命令透明执行操作时显示对应的Git命令帮助新手学习记忆 3. 错误处理若操作失败如冲突、未登录明确提示错误原因并给出具体解决步骤 ## Automatic Steps自动化执行步骤 1. 仓库检测检查当前目录是否为Git仓库若不是提示用户“请先初始化Git仓库git init” 2. 操作识别根据用户需求识别需要执行的Git操作提交、推送、拉取等 3. 命令执行自动执行对应的Git命令实时反馈操作进度 4. 结果反馈操作成功后提示“操作完成”失败则给出错误原因和解决方法 --- # Files【3. 资源区 / Resources】 - git_operate.py核心脚本实现Git常用操作的自动化执行 - requirements.txt依赖清单无需额外安装确保本地已安装Git - commands.txtGit常用命令对照表方便新手查看学习模拟示例5Markdown格式美化助手skill文件夹名markdown-formatter--- # 【1. 元数据区 / Metadata】 name: markdown-formatter description: 自动美化Markdown文档格式统一标题层级、列表缩进、代码块样式去除冗余空行让文档更规范易读 metadata: version: 1.0.0 dependencies: python3.7, markdown-it-py2.2.0 --- # Markdown FormatterMarkdown格式美化助手 !-- 【2. 指令区 / Instructions】 -- ## When to Use触发时机 满足以下任意一种情况自动触发该技能 - 用户粘贴Markdown文本要求美化格式 - 用户上传Markdown文件需要统一格式规范 - 用户希望优化Markdown文档的可读性调整标题、缩进、代码块样式 ## Critical Behavior核心行为准则 ⚠️ 硬性执行规则必须遵守 1. 不改变内容仅美化格式不修改文档中的文字内容、链接、图片等核心信息 2. 格式统一标题层级#~######规范列表缩进一致代码块用正确格式包裹 3. 精简冗余去除多余空行、重复空格确保文档简洁规范不冗余 ## Automatic Steps自动化执行步骤 1. 内容读取读取用户提供的Markdown文本或文件解析文档结构 2. 格式优化统一标题层级、列表缩进规范代码块样式去除冗余空行 3. 预览生成生成美化后的Markdown文本提供预览效果 4. 结果输出输出美化后的完整文本提示用户可直接复制使用 --- # Files【3. 资源区 / Resources】 - format_markdown.py核心美化脚本实现Markdown格式的自动优化 - requirements.txt依赖清单执行pip install -r requirements.txt一键安装 - examples/before.md美化前的Markdown示例after.md美化后的示例方便对比第三步技能加载与触发实操使用重启Claude Code生效搭建好文件夹、放好SKILL.md和相关资源后关闭当前终端重新打开终端输入claude命令启动确保AI扫描到新的技能包。检查技能加载状态启动后在对话框输入指令/doctor或者直接用自然语言提问“你现在加载了哪些技能包”Claude会列出所有识别成功的技能比如pdf-summary、csv-data-summarizer能查到就说明配置成功。自然语言触发使用不用记复杂指令直接说日常话就能触发AI会自动匹配技能描述、调用对应技能。示例“帮我分析桌面上的年度销售报表.csv生成数据摘要和折线图”“读取这份annual_report.pdf帮我转换为Word并提取文本”“帮我调试这段Python代码报错了”。加载失败排查若加载失败可检查3点① 技能文件夹路径是否正确必须在.claude/skills/下② SKILL.md文件名是否大写③ 文件夹层级是否正确单个技能单独建子文件夹。三、核心机制补充与安全、权限提示1. 渐进式披露核心机制必懂这是Agent Skill最关键的逻辑也是它高效的原因Claude启动时绝不加载所有技能的全部内容只读取每个SKILL.md顶部的name和description元数据只有用户的问题和元数据里的功能描述精准匹配时才会把这个技能的指令正文、脚本资源加载进上下文。哪怕安装100个技能包也不会占用多余token不会让AI运行变慢、逻辑混乱效率始终在线。2. 安全使用提示重中之重⚠️ 重点提醒从GitHub、第三方网站下载陌生Skill时一定要提高警惕因为Agent Skill支持scripts脚本文件夹意味着它可以在你的本地电脑上执行任意Python、Shell命令拥有操作本地文件的权限。实操建议使用陌生技能前务必打开scripts文件夹查看里面的代码逻辑确认没有删除文件、篡改系统、恶意读写数据等风险再放入技能库使用。3. 完全权限模式谨慎开启如果不想每次AI调用技能、修改代码、执行脚本时都弹出权限确认提示可以开启完全自主权模式启动命令claude --dangerously-skip-permissions⚠️ 命令里的“dangerously”已经明确提示风险开启后【风险点】Claude会拥有本地操作全权直接修改代码、删除文件、安装依赖、执行系统命令全程不征求你的同意。【使用建议】只在信任的工作环境使用且提前通过Git提交所有代码做好版本备份方便出错后快速回滚不建议日常长期开启。前提Claude CLI版本≥1.0可通过输入claude --version查看版本若版本过低执行claude update升级四、完整技能文件夹层级样例参考# Windows系统示例 C:\Users\用户名\.claude\skills\ # 总根目录 │ ├── pptx-creation/ # 技能1PPT自动生成助手 │ │ │ ├── SKILL.md # 核心指令文件定义PPT制作规则 │ │ │ ├── scripts/ # 执行脚本库 │ │ └── generate_slides.py # Python脚本调用python-pptx生成PPT │ │ │ └── assets/ # 静态资源 │ ├── corporate_template.pptx # 企业专用PPT模板 │ └── layout_config.json # 页面布局配置文件 │ ├── xlsx-analysis/ # 技能2Excel数据清洗分析 │ │ │ ├── SKILL.md # 核心指令文件定义表格分析规则 │ │ │ ├── scripts/ # 执行脚本库 │ │ ├── clean_data.py # 数据清洗脚本处理空值、错误格式 │ │ └── create_pivot_table.py # 数据透视表生成脚本 │ │ │ └── examples/ # 示例参考库 │ ├── prompt_examples.txt # 提示词示例辅助AI精准执行 │ └── sample_output.xlsx # 输出结果样例规范输出格式 │ └── python-debugger/ # 技能3Python代码调试助手 ├── SKILL.md ├── scripts/ │ └── debug.py └── examples/ └── error_code.py五、优质常用Skill资源网站直接收藏直接收藏这些网站免费下载现成技能包省去手写麻烦下载后可直接使用https://skills.homes/zh-CN中文技能库适配国内用户https://skillsmp.com/zh中文精选Skill合集分类清晰https://github.com/ComposioHQ/awesome-claude-skillsGitHub优质合集种类超全https://github.com/anthropics/skills/tree/main/skillsAnthropic官方Skill库安全可靠下载技巧进入网站后找到所需技能包下载压缩包解压后将整个技能文件夹如pdf-summary复制到.claude/skills/目录下重启Claude Code即可加载。
的演进与通信机制)
