📋 Template Skill - 模板技能

这是一个创建新 Skill 的空白模板。
建议先阅读 Skill Creator 了解如何使用此模板。

快速开始

这是什么？

Template Skill 是创建新 Skill 的基础模板，提供最小化但符合规范的起点。

何时使用？

✅ 需要从零开始创建新 Skill
✅ 想要快速搭建 Skill 结构
✅ 需要参考标准 Skill 格式

模板内容

SKILL.md 模板

---
name: template-skill
description: Replace with description of the skill and when Claude should use it.
---

# Insert instructions below

使用步骤

初始化：运行 init_skill.py 生成 Skill 目录
自定义前置元数据：
- 更新 name 为您的 skill 名称
- 编写详细的 description（包含触发场景）
编写指令：替换 "Insert instructions below" 为实际指令
添加资源：
- 在 scripts/ 添加可执行脚本
- 在 references/ 添加参考文档
- 在 assets/ 添加输出用资产
打包：运行 package_skill.py 验证并打包

前置元数据指南

name 字段

格式：小写，连字符分隔

示例：

name: pdf-editor          ✅
name: PDF Editor          ❌ (包含大写和空格)
name: pdfEditor           ❌ (驼峰命名)

description 字段

要求：

说明 Skill 做什么
说明 何时使用 Skill
列出所有触发场景

示例：

❌ 太简单：

description: Edit PDF files.

✅ 完整清晰：

description: >
  Edit, rotate, merge, and extract pages from PDF files. 
  Use when working with PDF documents for: 
  (1) Rotating pages, 
  (2) Merging multiple PDFs, 
  (3) Extracting specific pages, 
  (4) Filling PDF forms.

目录结构模板

最小结构（仅 SKILL.md）

my-skill/
└── SKILL.md

适用于：仅需文本指令的简单 skill

标准结构（含资源）

my-skill/
├── SKILL.md
├── scripts/
│   ├── main_script.py
│   └── helper_script.sh
├── references/
│   ├── api_docs.md
│   └── examples.md
└── assets/
    ├── template.html
    └── logo.png

适用于：大多数实际 skill

复杂结构（多变体）

my-skill/
├── SKILL.md (导航和核心流程)
├── scripts/
│   └── common_script.py
├── references/
│   ├── variant-a.md
│   ├── variant-b.md
│   └── variant-c.md
└── assets/
    ├── variant-a/
    └── variant-b/

适用于：支持多个框架或变体的 skill

SKILL.md 正文模板

模板 1：工具集成型

---
name: tool-name
description: 使用 [工具名] 进行 [任务]。当需要 [场景1]、[场景2] 或 [场景3] 时使用。
---

# [Tool Name]

## 快速开始

[最简单的使用示例]

\`\`\`python
# 代码示例
\`\`\`

## 核心功能

### 功能 1
[说明和示例]

### 功能 2
[说明和示例]

## 高级用法

参见 [ADVANCED.md](references/ADVANCED.md) 了解更多。

## 常见问题

**Q: [问题]**  
A: [答案]

模板 2：工作流程型

---
name: workflow-name
description: [工作流程描述]。当需要 [场景描述] 时使用。
---

# [Workflow Name]

## 流程概览

这个工作流程包含以下步骤：

1. [步骤 1] - [说明]
2. [步骤 2] - [说明]
3. [步骤 3] - [说明]

## 详细步骤

### 步骤 1: [名称]

[详细说明]

\`\`\`bash
# 命令或代码
\`\`\`

### 步骤 2: [名称]

[详细说明]

## 参考资源

- [REFERENCE.md](references/REFERENCE.md) - 完整 API 文档
- [EXAMPLES.md](references/EXAMPLES.md) - 更多示例

模板 3：领域知识型

---
name: domain-knowledge
description: [领域描述]。当需要 [具体任务] 时使用，包括 [场景列表]。
---

# [Domain Knowledge]

## 概览

[领域简介]

## 核心概念

### 概念 1
[解释]

### 概念 2
[解释]

## 常见任务

### 任务 1: [名称]

**场景**: [何时使用]

**步骤**:
1. [步骤]
2. [步骤]

**示例**:
\`\`\`
[示例代码或数据]
\`\`\`

## 领域特定资源

不同领域的详细信息：
- [finance.md](references/finance.md) - 财务相关
- [sales.md](references/sales.md) - 销售相关
- [product.md](references/product.md) - 产品相关

资源模板

scripts/ 模板

rotate_pdf.py 示例：

#!/usr/bin/env python3
"""
旋转 PDF 文件的页面
"""
import sys
from PyPDF2 import PdfReader, PdfWriter

def rotate_pdf(input_path, output_path, angle):
    reader = PdfReader(input_path)
    writer = PdfWriter()
    
    for page in reader.pages:
        page.rotate(angle)
        writer.add_page(page)
    
    with open(output_path, 'wb') as f:
        writer.write(f)

if __name__ == '__main__':
    if len(sys.argv) != 4:
        print("Usage: rotate_pdf.py <input.pdf> <output.pdf> <angle>")
        sys.exit(1)
    
    input_path = sys.argv[1]
    output_path = sys.argv[2]
    angle = int(sys.argv[3])
    
    rotate_pdf(input_path, output_path, angle)
    print(f"已旋转 PDF: {output_path}")

references/ 模板

API_REFERENCE.md 示例：

# API Reference

## 目录

- [认证](#认证)
- [端点](#端点)
- [错误处理](#错误处理)

## 认证

使用 API 密钥进行认证：

\`\`\`python
headers = {
    'Authorization': f'Bearer {API_KEY}'
}
\`\`\`

## 端点

### GET /users

获取用户列表。

**参数**:
- `limit` (int): 返回数量，默认 10
- `offset` (int): 偏移量，默认 0

**响应**:
\`\`\`json
{
  "users": [...],
  "total": 100
}
\`\`\`

## 错误处理

所有错误返回标准格式：

\`\`\`json
{
  "error": "错误消息",
  "code": "ERROR_CODE"
}
\`\`\`

assets/ 模板

template.html 示例：

<!DOCTYPE html>
<html lang="zh-CN">
<head>
    <meta charset="UTF-8">
    <meta name="viewport" content="width=device-width, initial-scale=1.0">
    <title>{{ title }}</title>
    <style>
        /* 样式 */
    </style>
</head>
<body>
    <header>
        <h1>{{ heading }}</h1>
    </header>
    
    <main>
        {{ content }}
    </main>
    
    <footer>
        {{ footer }}
    </footer>
</body>
</html>

验证清单

打包前确认：

[ ] name 符合命名规范（小写、连字符分隔）
[ ] description 完整（包含做什么 + 何时使用）
[ ] SKILL.md 正文清晰简洁（<500 行）
[ ] 所有脚本已测试可运行
[ ] 引用的资源文件存在
[ ] 删除了不需要的示例文件
[ ] 使用祈使句/不定式
[ ] 无重复信息（信息只在一处）

快速命令参考

初始化新 Skill

cd /path/to/anthropics-skills
scripts/init_skill.py my-new-skill --path ./skills

验证并打包

scripts/package_skill.py ./skills/my-new-skill

指定输出目录

scripts/package_skill.py ./skills/my-new-skill ./dist

常见问题

Q: 必须使用 init_skill.py 吗？

A: 强烈推荐。手动创建容易遗漏必需字段或格式错误。脚本确保结构正确。

Q: 可以修改生成的示例文件吗？

A: 当然！示例文件仅为演示。保留需要的，删除不需要的，根据需求自定义。

Q: 如果打包时验证失败怎么办？

A: 脚本会报告具体错误。修复后重新运行 package_skill.py。常见错误：

缺少必需字段（name、description）
YAML 格式错误
引用的文件不存在