Anthropic 工程师、Claude Code 构建者发布重磅教程《Claude Code 的经验教训：我们如何使用 Skill》，系统总结了 Skill 设计、开发与分发的核心实践。
Skill 是 Anthropic 提出的智能体开放标准，已成为 Claude Code 等框架中最主流的扩展机制之一。它以文件夹为单位，支持脚本、配置、数据资产及动态 hook，兼具灵活性与可扩展性。当前已有数百个 Skill 在生产环境中被活跃使用。
什么是 Skill？
Skill 并非简单的 Markdown 文件，而是结构化文件夹，可包含脚本、API 参考、模板、日志、配置等资源；Claude Code 支持通过 config.json 注册动态 hook，实现高度定制化行为。
制作 Skill 的核心技巧
Anthropic 近期推出 Skill Creator 工具，大幅降低 Skill 创建门槛。以下是经验证的最佳实践：
避免陈述显而易见的信息
Claude 本身已具备强大代码理解能力，Skill 应聚焦突破其常规认知边界的信息。例如“前端设计 Skill”通过迭代优化，主动规避 Inter 字体、紫色渐变等通用设计陷阱，显著提升输出质量。
建立 Gotchas（易错点）部分
Gotchas 是 Skill 中价值最高的内容——基于真实失败案例提炼，持续更新可显著提升成功率。建议随使用反馈动态补充。
善用文件系统与渐进式披露
将 Skill 视为上下文工程载体：通过目录结构引导 Claude 按需读取内容。例如：
- 将函数签名与示例拆至
references/api.md； - 将模板文件置于
assets/目录供直接复用； - 按用途划分
scripts/、examples/、docs/等子目录。
避免对 Claude 施加过度限制
指令需提供必要约束，同时保留决策弹性。避免僵化表述（如“必须用 X 方式”），改用“优先考虑 X，但在 Y 条件下可切换为 Z”等引导式措辞。
重视 Setup 流程设计
对需用户输入的 Skill（如 Slack 频道选择），推荐在 config.json 中定义可配置项；未设置时由智能体调用 AskUserQuestion 工具发起结构化提问。
Description 字段面向模型而非人类
该字段用于触发匹配，应精准描述适用场景（如“当用户要求生成带身份认证的内部 API 客户端时启用”），而非概括功能。
合理实现状态记忆与数据存储
可通过日志（standups.log）、JSON 或 SQLite 存储历史状态，支持增量分析与行为反思。数据应存于稳定路径 ${CLAUDE_PLUGIN_DATA}，避免因 Skill 升级丢失。
提供可复用脚本与辅助函数
向 Claude 注入高质量脚本库（如数据获取、日志解析），使其专注于高阶编排而非重复造轮子。例如数据科学 Skill 内置事件源查询函数，即可响应“周二发生了什么？”等自然语言分析请求。
按需启用 Hook
针对特定场景启用临时防护机制，避免全局生效干扰日常操作。典型示例：
/careful：拦截rm -rf、DROP TABLE、force-push等高危命令；/freeze：限制编辑范围仅限指定目录；- 调试辅助：自动注入日志、隔离无关变更。
Skill 的九大类型
实践中，优质 Skill 通常清晰归属于以下类别之一：
1. 库与 API 参考
说明内部或外部 SDK/CLI 的正确用法，含参考片段与易错点清单。 示例：billing-lib（计费库边缘场景）、internal-platform-cli（子命令详解）、frontend-design（设计系统适配）。
2. 产品验证
驱动 Playwright/tmux 等工具执行端到端验证，强制断言状态。 示例：signup-flow-driver（注册流程全链路验证）、checkout-verifier（Stripe 结账状态校验）。
3. 数据获取与分析
连接监控与数据平台，内置凭据、仪表板 ID 及常用查询逻辑。 示例：funnel-query（转化漏斗关联规则）、cohort-compare（留存率统计学差异分析）。
4. 业务流程与团队自动化
将高频人工流程封装为单命令，支持日志回溯与增量执行。 示例：standup-post（聚合工单/GitHub/Slack 生成站会报告）、weekly-recap（PR/部署/工单周报自动生成）。
5. 代码脚手架与模板
生成符合组织规范的样板代码，结合自然语言需求增强灵活性。 示例：new-migration（迁移文件模板+常见坑点）、create-app（预集成认证/日志/部署配置）。
6. 代码质量与审查
执行风格检查、测试覆盖建议、对抗式代码评审。 示例：adversarial-review（子智能体多轮批判迭代）、code-style（Claude 默认薄弱项强化）。
7. CI/CD 与部署
覆盖 PR 监控、灰度发布、故障回滚等关键环节。 示例：babysit-pr（CI 失败重试+冲突解决+自动合并）、deploy-<service>（错误率对比+自动回滚）。
8. 运行手册（Runbooks）
基于警报/错误签名触发多工具协同诊断，输出结构化报告。 示例：<service>-debugging（症状→工具→查询映射）、log-correlator（跨服务请求 ID 日志聚合）。
9. 基础设施运维
封装需护栏的高危操作，确保合规性与安全性。 示例：<resource>-orphans（Pod/卷清理四步流程）、cost-investigation（账单激增根因定位）。
分发与管理 Skill
Skill 可通过两种方式共享：
- 签入代码仓库
/.claude/Skills目录（适合小型团队）； - 发布为插件，接入内部 Plugin Marketplace（支持按需安装与规模化治理）。
推荐采用“沙盒孵化→牵引验证→PR 入市”机制：先上传至 GitHub 沙盒并推广试用；获真实采纳后，由作者提交 PR 进入正式市场。需建立策展审核流程，防范低质/冗余 Skill 泛滥。
依赖管理暂未原生支持，但可直接通过 Skill 名称引用已安装组件（如“CSV 生成”调用“文件上传”Skill）。
Claude 内部通过 PreToolUse hook 实现 Skill 使用追踪，可用于评估热度、优化触发策略。相关实现可参考公开示例代码。
Skill 作为智能体时代的关键扩展范式，仍处于快速演进阶段。本文所列技巧均来自一线工程实践验证，非终极指南。最佳学习路径是立即动手——从几行代码与一个易错点起步，在真实迭代中持续完善。