AI 大模型推理

    • AI 大模型推理 > 最佳实践 > Claude Code Skills 使用指南

    Claude Code Skills 使用指南

    最近更新时间: 2025-11-07 19:11:03

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

    核心特性

    • 自动调用机制：Claude 会根据用户请求和Skills描述自动判断何时使用相应的Skills
    • 渐进式加载：系统启动时仅预加载Skills的名称和描述，只有在需要时才加载完整内容
    • 跨平台兼容：支持在 Claude.ai、API 接口以及 Claude Code 编辑器中使用
    • 可执行代码支持：允许包含脚本文件，适用于需要精确逻辑处理的任务场景

    Skills存储方式

    1. 个人Skills (Personal Skills)

    • 存储位置：~/.claude/skills/ 目录
    • 适用场景：个人工作流程优化、实验性功能开发、个人生产力工具

    2. 项目Skills (Project Skills)

    • 存储位置：项目根目录下的 .claude/skills/ 目录
    • 适用场景：团队协作、项目特定的专业知识、共享工具集

    3. 插件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 提交消息生成

    2. 编写清晰的描述

    • 在描述中包含具体的触发关键词
    • 帮助 Claude 准确识别使用时机
    • 包含用户可能提及的相关术语

    3. 提供完整示例

    在 SKILL.md 文件中包含：

    • 示例输入格式
    • 预期输出结果
    • 使用场景说明

    4. 版本管理

    • 使用版本控制系统跟踪变更
    • 记录功能更新和修复日志

    5. 安全考虑

    • 避免在脚本中硬编码敏感信息（API 密钥、密码等）
    • 在启用下载的Skills前进行代码审查
    • 遵循最小权限原则

    Skills使用技巧

    Skills组合使用

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

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

    性能优化建议

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

    调试技巧

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

    Skills分类概览

    Claude Skills 根据应用场景可以分为以下几个主要类别，每个类别都有相应的官方和社区Skills可供选择。

    官方Skills仓库推荐

    Anthropic 官方Skills集合

    访问 Anthropic Skills 仓库 获取完整的Skills列表：

    🎨 创意设计类

    • algorithmic-art - 使用 p5.js 创建生成艺术，支持种子随机性、流场和粒子系统
    • canvas-design - 设计精美的视觉艺术，输出 PNG 和 PDF 格式，运用设计哲学
    • slack-gif-creator - 创建针对 Slack 尺寸约束优化的动画 GIF

    💻 开发技术类

    • artifacts-builder - 构建复杂的 HTML artifacts，支持 React、Tailwind CSS 和 shadcn/ui 组件
    • mcp-builder - 创建 MCP（Model Context Protocol）服务器，集成外部 API 和服务
    • webapp-testing - 使用 Playwright 进行 Web 应用测试，UI 验证和调试

    🏢 企业沟通类

    • internal-comms - 编写内部沟通文档，如状态报告、通讯和 FAQ
    • brand-guidelines - 应用 Anthropic 官方品牌色彩和字体样式
    • theme-factory - 提供 10 个预设专业主题或生成自定义主题

    📄 文档处理类

    Anthropic 提供的生产级文档处理Skills（源码可参考但不开源）：

    • docx - Word 文档创建、编辑和分析，支持追踪更改、评论和格式保留
    • pdf - PDF 操作工具包，支持文本提取、文档创建、合并分割和表单处理
    • pptx - PowerPoint 演示文稿处理，支持布局、模板、图表和自动幻灯片生成
    • xlsx - Excel 电子表格处理，支持公式、格式化、数据分析和可视化

    🔧 Skills开发工具

    合作伙伴Skills

    参考资源

    更多详细信息和示例可以查看：

    以上内容是否对您有帮助？