本指南将指导用户创建 Claude Code 的 Agent 技能。当你想要创建、编写、设计新技能，或需要在 SKILL.md 文件、前置元数据及技能结构方面获得帮助时，可使用本指南。
SkillsLM
官网：
https://skillslm.com/
简单说，它就是一个 Agent Skills 的搜索引擎和学习平台。目前收录了 41454+ 个社区 Skills，数据直接来自 GitHub。支持中英文搜索，你可以按名称、描述、作者来查找你需要的技能。
网站有三个核心板块：
- Browse Skills - 搜索和浏览海量 Skills
- Learn Skills - 完整的 Skills 学习教程
SKILL.md 说明
技能编写器（Skill Writer）
该技能可帮助你为 Claude Code 创建结构良好的 Agent 技能，遵循最佳实践和验证要求。
何时使用该技能
以下场景可使用本技能：
操作步骤
步骤1：确定技能范围
首先，明确该技能应实现的功能：
需澄清的问题：
核心原则：保持专注——一项技能=一项功能
- 合理示例：「PDF表单填写」「Excel数据分析」
步骤2：选择技能存放位置
确定技能的创建路径：
个人技能（Personal Skills）
路径：~/.claude/skills/适用场景：
项目技能（Project Skills）
路径：.claude/skills/适用场景：
步骤3：创建技能结构
创建对应的目录和文件：
# 个人技能mkdir -p ~/.claude/skills/skill-name# 项目技能mkdir -p .claude/skills/skill-name
多文件技能的目录结构：
skill-name/├── SKILL.md（必需）├── reference.md（可选，参考文档）├── examples.md（可选，示例文档）├── scripts/│ └── helper.py（可选，辅助脚本）└── templates/ └── template.txt（可选，模板文件）
步骤4：编写 SKILL.md 前置元数据
创建包含必填字段的 YAML 前置元数据：
---name:skill-namedescription:简要描述技能功能及适用场景---
字段要求：
名称（name）：
- 合理示例：
pdf-processor、git-commit-helper - 不合理示例：
PDF_Processor、Git Commits!
描述（description）：
可选前置元数字段：
allowed-tools：限制技能可访问的工具（逗号分隔列表）
allowed-tools:Read,Grep,Glob
适用场景：
步骤5：撰写有效的描述
描述是 Claude 发现技能的关键，遵循公式：[功能] + [使用场景] + [关键触发词]
合理示例：
description: 从PDF文件中提取文本和表格、填写表单、合并文档。适用于处理PDF文件或用户提及PDF、表单、文档提取的场景。
description: 分析Excel电子表格、创建数据透视表、生成图表。适用于处理Excel文件、电子表格或分析.xlsx格式的表格数据。
过于模糊的示例：
description: 辅助处理文档description: 用于数据分析
撰写技巧：
- 包含具体文件扩展名（.pdf、.xlsx、.json）
- 添加上下文提示（「适用于……时」「用于……场景」）
步骤6：组织技能内容
使用清晰的 Markdown 章节结构：
# 技能名称简要概述该技能的功能。## 快速入门提供简单示例，帮助快速上手。## 操作指南为 Claude 提供分步指导：1. 明确操作的第一步2. 说明第二步及预期结果3. 处理边缘情况## 示例展示具体使用示例（含代码或命令）。## 最佳实践- 需遵循的核心规范- 需避免的常见问题- 适用与不适用场景## 依赖要求列出所有依赖项或前置条件：```bashpip install package-name
高级用法
复杂场景相关内容，请参阅 reference.md。
步骤7：添加辅助文件（可选）
### 第七步：添加辅助文件（可选）创建用于逐步披露的附加文件：R1：**参考文档.md**：详细的API文档，高级选项```示例.md：扩展示例与用例```**scripts/**：辅助脚本与工具**templates/**: 文件模板或代码骨架请参阅SKILL.md文件中的引用内容：```markdown```如需高级用法，请参阅[reference.md](reference.md)。运行辅助脚本：```bashpython scripts/helper.py input.txt
步骤8：验证技能
请查看以下要求：
✅ 文件结构：
✅ YAML 前言：
✅ 内容质量：
✅ 测试：
步骤9：测试技能
Can you help me extract text from this PDF?
步骤10：如有需要调试
如果克劳德不使用该技能：
ls ~/.claude/skills/skill-name/SKILL.mdls .claude/skills/skill-name/SKILL.md
cat SKILL.md | head -n 10
claude --debug
常见模式
只读型技能
---name:code-readerdescription:读取并分析代码，不进行任何修改。适用于代码审查、理解代码库或生成文档的场景。allowed-tools:Read,Grep,Glob---
基于脚本的技能
---name:data-processordescription:ProcessCSVandJSONdatafileswithPythonscripts.Usewhenanalyzingdatafilesortransformingdatasets.---# Data Processor## Instructions1. Use the processing script:\`\`\`bashpythonscripts/process.pyinput.csv--outputresults.json\`\`\`2. Validate output with:\`\`\`bashpythonscripts/validate.pyresults.json\`\`\`
多档技能结合渐进披露
---name:api-designerdescription:遵循最佳实践设计RESTAPI。适用于创建API端点、设计路由或规划API架构的场景。---# API设计器快速入门：请参阅[examples.md](examples.md)详细参考：请参阅[reference.md](reference.md)## 操作指南1.收集需求2.设计端点（见examples.md）3.使用OpenAPI规范编写文档4.对照最佳实践进行审查（见reference.md）
技能作者最佳实践
验证清单
最终确定技能前，确认以下项：
- [ ] 名称仅含小写字母、连字符，最多 64 个字符
故障排除
技能未激活
多个技能冲突
技能出现错误
示例
完整示例请参阅文档：
输出格式
创建技能时，我将按以下流程执行：
最终将生成一个完整可用的技能，遵循所有最佳实践和验证规则。
