package - Package Skills

Package skills for deployment to multiple LLM platforms.

Basic Usage

skill-seekers package INPUT_DIR [OPTIONS]

Quick Examples

# Package for Claude (default)
skill-seekers package output/react/

# Package for specific platform
skill-seekers package output/react/ --target gemini
skill-seekers package output/react/ --target openai
skill-seekers package output/react/ --target markdown

# Package for all platforms
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

Options

  • --target PLATFORM - Target platform (claude, gemini, openai, markdown)
  • --output FILE - Custom output filename

Supported Platforms

Claude AI (Default)

skill-seekers package output/react/
# Creates: output/react.zip

Format:

  • ZIP archive
  • YAML frontmatter in SKILL.md
  • References folder structure

Use for: Claude Code, Claude Desktop, claude.ai

Google Gemini

skill-seekers package output/react/ --target gemini
# Creates: output/react-gemini.tar.gz

Prerequisites:

pip install skill-seekers[gemini]

Format:

  • tar.gz archive
  • Plain markdown (no YAML)
  • system_instructions.md instead of SKILL.md
  • Gemini-specific metadata

Use for: Google AI Studio, Gemini API

OpenAI ChatGPT

skill-seekers package output/react/ --target openai
# Creates: output/react-openai.zip

Prerequisites:

pip install skill-seekers[openai]

Format:

  • ZIP archive
  • Plain text instructions
  • Vector store files
  • OpenAI Assistant configuration

Use for: ChatGPT, OpenAI Assistants API

Generic Markdown

skill-seekers package output/react/ --target markdown
# Creates: output/react-markdown.zip

Format:

  • ZIP archive
  • Pure markdown (no frontmatter)
  • Universal compatibility
  • Manifest.json with metadata

Use for: Any LLM, offline docs, self-hosting

Platform Comparison

FeatureClaudeGeminiOpenAIMarkdown
FormatZIPtar.gzZIPZIP
Frontmatter✅ YAML
SizeOptimizedCompressedIndexedUniversal
Upload API

Output Files

Claude AI

react.zip
├── SKILL.md              # YAML frontmatter + markdown
└── references/
    ├── index.md
    ├── getting-started.md
    └── api-reference.md

Google Gemini

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

OpenAI ChatGPT

react-openai.zip
├── assistant_instructions.txt    # Plain text
├── vector_store_files/
│   └── ...
└── openai_metadata.json

Generic Markdown

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

Multi-Platform Workflow

# 1. Scrape once
skill-seekers scrape --config configs/react.json

# 2. Enhance once
skill-seekers enhance output/react/

# 3. Package for all platforms
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

# Result:
# - output/react.zip (Claude)
# - output/react-gemini.tar.gz (Gemini)
# - output/react-openai.zip (OpenAI)
# - output/react-markdown.zip (Universal)

File Size

Typical skill sizes:

Size CategoryPagesTypical SizeExample
Small10-505-20 KBTutorial docs
Medium50-20020-100 KBFramework docs
Large200-500100-500 KBComplete API

Check size:

ls -lh output/react*.zip

Platform Limits

PlatformMax File SizeTypical Size
Claude AI~25 MB10-500 KB
Google Gemini~100 MB10-500 KB
OpenAI ChatGPT~512 MB vector store10-500 KB
Generic MarkdownNo limit10-500 KB

Troubleshooting

”SKILL.md not found”

Make sure you scraped first:

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

“Invalid target platform”

Use valid platforms:

# Valid
--target claude
--target gemini
--target openai
--target markdown

# Invalid
--target anthropic
--target google

Wrong file format

Each platform requires specific format:

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

Use --target parameter correctly.

Next Steps