🔧 元技能类

# 1. 复制 template-skill
cp -r skills/template-skill skills/my-skill

# 2. 编辑 SKILL.md
vim skills/my-skill/SKILL.md

# 3. 打包
scripts/package_skill.py skills/my-skill

路径 2: 使用 init_skill.py（10 分钟）

适合复杂技能：

# 1. 初始化
scripts/init_skill.py my-skill --path ./skills

# 2. 添加资源
# - scripts/
# - references/
# - assets/

# 3. 编写 SKILL.md

# 4. 打包
scripts/package_skill.py skills/my-skill

路径 3: 深入学习（1 小时）

完整掌握技能创建：

阅读 skill-creator - 完整方法论
学习设计模式 - 工作流和输出模式
研究示例技能 - 浏览其他 15 个技能
实践创建 - 创建你的第一个技能
迭代优化 - 基于使用反馈改进

技能解剖学

最小技能（仅 SKILL.md）

my-skill/
└── SKILL.md

适用于：

纯指令性技能
简单工作流程
不需要外部资源

完整技能（含资源）

my-skill/
├── SKILL.md          # 核心定义
├── scripts/          # 可执行代码
│   └── helper.py
├── references/       # 参考文档
│   └── guide.md
└── assets/          # 资产文件
    └── template.txt

适用于：

复杂工作流程
需要脚本自动化
包含参考资料或模板

核心原则

1. 简洁是关键

上下文窗口是公共资源 - 与其他所有内容共享。

✅ 好：使用 `scripts/rotate.py input.pdf output.pdf`
❌ 差：详细解释 PDF 旋转的工作原理...（200 字）

2. 渐进式披露

三级加载系统：

Level 1: name + description (~100 词)
         ↓ 始终在上下文
         
Level 2: SKILL.md 正文 (<5k 词)
         ↓ 技能触发时加载
         
Level 3: 资源 (无限制)
         ↓ 按需加载或执行

3. 清晰的触发机制

description 是关键：

# ✅ 好的 description
description: |
  Generate conventional commit messages.
  Use when Claude needs to:
  (1) Create git commit messages
  (2) Follow conventional commits spec

# ❌ 差的 description
description: Commit message tool

工具链

init_skill.py

创建技能基础结构：

scripts/init_skill.py my-skill --path ./output

生成：

SKILL.md 模板
scripts/ 目录
references/ 目录
assets/ 目录

package_skill.py

打包和验证技能：

scripts/package_skill.py skills/my-skill

自动验证：

YAML frontmatter 格式
必需字段
命名规范
文件引用

输出：my-skill.skill (zip 格式)

quick_validate.py

快速验证技能：

scripts/quick_validate.py skills/my-skill

检查所有规范要求。

学习路径

初学者

template-skill - 了解基本结构
创建简单技能 - 例如提交消息生成器
测试和迭代 - 在实际场景中使用

中级

skill-creator - 学习完整方法论
研究示例技能 - 分析 docx、pdf 等复杂技能
创建带资源的技能 - 包含 scripts、references

高级

深入 OOXML - 研究 document-skills 实现
优化上下文使用 - 应用渐进式披露
创建技能套件 - 多个相关技能组合

常见模式

模式 1: 工作流技能

用于多步骤流程：

# Document Review Workflow

1. Analyze document structure
2. Apply redlining for changes
3. Add review comments
4. Export tracked version

模式 2: 工具集成技能

用于 API 或工具包装：

# GitHub API Skill

## List Issues
Use `scripts/list_issues.py --repo owner/repo`

## Create Issue
See [api-reference.md](references/api-reference.md)

模式 3: 知识库技能

用于特定领域知识：

# Database Schema

See [schema.md](references/schema.md) for table structure.

## Common Queries
[示例查询]

最佳实践

✅ 应该做的

从具体示例开始 - 理解实际使用场景
测试所有脚本 - 确保实际运行
保持简洁 - 挑战每段文字的价值
使用示例而非解释 - 展示而非讲述
迭代改进 - 基于真实使用反馈

❌ 不应该做的

不要创建额外文档 - 无需 README、CHANGELOG
不要重复信息 - 在 SKILL.md 和 references 中
不要深度嵌套 - 保持引用一级深度
不要假设需要解释基础 - Claude 已经很聪明

示例：从零创建技能

场景

创建一个 SQL 查询辅助技能。

步骤 1: 理解需求

用户会说:
- "查询今天的活跃用户"
- "生成收入报表"
- "优化这个查询"

步骤 2: 规划资源

references/schema.md - 数据库架构
references/examples.md - 常见查询示例
SKILL.md - 核心指令和指南

步骤 3: 创建技能

scripts/init_skill.py sql-helper --path ./skills

步骤 4: 编写内容

---
name: sql-helper
description: |
  Help write and optimize SQL queries.
  Use when Claude needs to query the database or optimize SQL.
---

# SQL Query Helper

## Schema
See [schema.md](references/schema.md)

## Guidelines
1. Use parameterized queries
2. Include LIMIT clauses
3. Test in staging first

## Common Queries
See [examples.md](references/examples.md)

步骤 5: 打包

scripts/package_skill.py skills/sql-helper

步骤 6: 测试和迭代

测试: "查询今天登录的所有用户"
反馈: 需要更多示例
改进: 添加更多 examples.md 内容

下一步

准备创建您的第一个技能？

快速开始: template-skill
深入学习: skill-creator
浏览示例: 所有技能

祝您创建出色的技能！ 🚀

返回: 所有技能 | 上一类: 文档处理