package - 打包技能

为部署到多个 LLM 平台打包技能。

基本用法

skill-seekers package INPUT_DIR [OPTIONS]

快速示例

# 为 Claude 打包（默认）
skill-seekers package output/react/

# 为特定平台打包
skill-seekers package output/react/ --target gemini
skill-seekers package output/react/ --target openai
skill-seekers package output/react/ --target markdown

# 为所有平台打包
skill-seekers package output/react/ --target claude
skill-seekers package output/react/ --target gemini
skill-seekers package output/react/ --target openai
skill-seekers package output/react/ --target markdown

选项

  • --target PLATFORM - 目标平台（claude、gemini、openai、markdown）
  • --output FILE - 自定义输出文件名

支持的平台

Claude AI（默认）

skill-seekers package output/react/
# 创建：output/react.zip

格式：

  • ZIP 存档
  • SKILL.md 中的 YAML 前置元数据
  • References 文件夹结构

用于： Claude Code、Claude Desktop、claude.ai

Google Gemini

skill-seekers package output/react/ --target gemini
# 创建：output/react-gemini.tar.gz

前置要求：

pip install skill-seekers[gemini]

格式：

  • tar.gz 存档
  • 纯 markdown（无 YAML）
  • 使用 system_instructions.md 而非 SKILL.md
  • Gemini 特定元数据

用于： Google AI Studio、Gemini API

OpenAI ChatGPT

skill-seekers package output/react/ --target openai
# 创建：output/react-openai.zip

前置要求：

pip install skill-seekers[openai]

格式：

  • ZIP 存档
  • 纯文本说明
  • 向量存储文件
  • OpenAI Assistant 配置

用于： ChatGPT、OpenAI Assistants API

通用 Markdown

skill-seekers package output/react/ --target markdown
# 创建：output/react-markdown.zip

格式：

  • ZIP 存档
  • 纯 markdown（无前置元数据）
  • 通用兼容性
  • 包含元数据的 Manifest.json

用于： 任何 LLM、离线文档、自托管

平台比较

功能ClaudeGeminiOpenAIMarkdown
格式ZIPtar.gzZIPZIP
前置元数据✅ YAML❌❌❌
大小优化压缩索引通用
上传 API✅✅✅❌

输出文件

Claude AI

react.zip
├── SKILL.md              # YAML 前置元数据 + markdown
└── references/
    ├── index.md
    ├── getting-started.md
    └── api-reference.md

Google Gemini

react-gemini.tar.gz
├── system_instructions.md    # 纯 markdown
├── references/
│   └── ...
└── gemini_metadata.json

OpenAI ChatGPT

react-openai.zip
├── assistant_instructions.txt    # 纯文本
├── vector_store_files/
│   └── ...
└── openai_metadata.json

通用 Markdown

react-markdown.zip
├── README.md
├── DOCUMENTATION.md
├── references/
│   └── ...
└── manifest.json

多平台工作流

# 1. 抓取一次
skill-seekers scrape --config configs/react.json

# 2. 增强一次
skill-seekers enhance output/react/

# 3. 为所有平台打包
skill-seekers package output/react/ --target claude
skill-seekers package output/react/ --target gemini
skill-seekers package output/react/ --target openai
skill-seekers package output/react/ --target markdown

# 结果：
# - output/react.zip（Claude）
# - output/react-gemini.tar.gz（Gemini）
# - output/react-openai.zip（OpenAI）
# - output/react-markdown.zip（通用）

文件大小

典型技能大小：

大小类别页数典型大小示例
小10-505-20 KB教程文档
中50-20020-100 KB框架文档
大200-500100-500 KB完整 API

检查大小：

ls -lh output/react*.zip

平台限制

平台最大文件大小典型大小
Claude AI~25 MB10-500 KB
Google Gemini~100 MB10-500 KB
OpenAI ChatGPT~512 MB 向量存储10-500 KB
通用 Markdown无限制10-500 KB

故障排除

”SKILL.md not found”

确保先进行抓取：

skill-seekers scrape --config configs/react.json
skill-seekers package output/react/

“Invalid target platform”

使用有效的平台：

# 有效
--target claude
--target gemini
--target openai
--target markdown

# 无效
--target anthropic  ❌
--target google     ❌

错误的文件格式

每个平台需要特定格式：

  • Claude/OpenAI/Markdown：.zip
  • Gemini：.tar.gz

正确使用 --target 参数。

下一步