Claude Code Skills 是一套模块化功能扩展系统，允许开发者通过结构化的文件夹来增强 Claude 的能力。每个Skills(Skill)都包含一个核心的 SKILL.md 文件以及相关的辅助资源文件。

Skills存储方式

  1. 个人Skills (Personal Skills)
  • 存储位置：~/.claude/skills/ 目录
  • 适用场景：个人工作流程优化、实验性功能开发、个人生产力工具
  1. 项目Skills (Project Skills)
  • 存储位置：项目根目录下的 .claude/skills/ 目录
  • 适用场景：团队协作、项目特定的专业知识、共享工具集
  1. 插件Skills (Plugin Skills)
  • 获取方式：通过 Claude Code 插件系统安装
  • 特点：安装后自动可用，便于分发和管理

创建Skills的详细步骤

前置准备

确保已安装 Claude Code 1.0 或更高版本，并具备基本的使用经验。

Skills文件结构

每个Skills的核心是 SKILL.md 文件，基本结构如下：

---
name: your-skill-name
description: 简要描述该Skills的功能以及使用场景
---

# Skills名称

## 功能说明
为 Claude 提供清晰的分步操作指导

## 使用示例
展示该Skills的具体应用场景和使用方法

重要规范

  • name 字段：仅使用小写字母、数字和连字符，长度限制在 64 个字符以内
  • description 字段：最多 1024 个字符，必须清楚说明Skills功能和使用时机

辅助文件支持

Skills可以包含以下类型的辅助文件：

  • 脚本文件（Python、JavaScript 等）
  • 模板文件
  • 参考文档
  • 示例数据

测试与调试

功能测试

创建Skills后，通过提出与描述相匹配的问题来验证功能。

路径检查

# 检查个人Skills
ls ~/.claude/skills/skill-name/SKILL.md
# 检查项目Skills
ls .claude/skills/skill-name/SKILL.md

调试模式

DEBUG=claude:skills claude code

安装与部署

通过插件安装

# 从市场安装
/plugin marketplace add anthropics/skills
# 从本地目录安装
/plugin add /path/to/skill-directory

团队共享方案

推荐方式（插件机制）：

  1. 将Skills添加到插件的 skills/ 目录
  2. 将插件发布到市场
  3. 团队成员通过市场安装

Git 共享方式：

# 添加到项目
mkdir -p .claude/skills/my-skill
# 创建 SKILL.md 文件
# 提交到版本控制
git add .claude/skills/my-skill
git commit -m "Add team Skills"

最佳实践指南

  1. 保持功能专一性

每个Skills应该专注解决单一能力，例如：

  • PDF 表单填写
  • Excel 数据分析
  • Git 提交消息生成
  1. 编写清晰的描述
  • 在描述中包含具体的触发关键词
  • 帮助 Claude 准确识别使用时机
  • 包含用户可能提及的相关术语
  1. 提供完整示例

在 SKILL.md 文件中包含：

  • 示例输入格式
  • 预期输出结果
  • 使用场景说明
  1. 版本管理
  • 使用版本控制系统跟踪变更
  • 记录功能更新和修复日志
  1. 安全考虑
  • 避免在脚本中硬编码敏感信息（API 密钥、密码等）
  • 在启用下载的Skills前进行代码审查

遵循最小权限原则

Skills使用技巧

Skills组合使用

多个Skills可以配合使用以实现复杂的工作流程：

  • brand-guidelines + theme-factory = 一致的品牌化设计
  • mcp-builder + webapp-testing = 完整的应用开发测试流程
  • internal-comms + canvas-design = 专业的内部沟通材料

性能优化建议

  • 合理使用 references：将大型文档放在 references/ 目录，避免主 SKILL.md 过于冗长
  • 脚本模块化：将复杂逻辑拆分为多个小脚本，提高可维护性
  • 描述优化：使用具体的关键词和场景描述，帮助 Claude 准确匹配

调试技巧

使用 DEBUG=claude:skills claude code 启用调试模式 检查 ~/.claude/skills/ 或 .claude/skills/ 目录结构 运行官方验证脚本：python scripts/quick_validate.py <skill-directory>