skill-seekers-reference/docs/getting-started/02-quick-start.md

Quick Start Guide

Skill Seekers v3.1.0
Create your first skill in 3 commands

---

The 3 Commands

# 1. Install Skill Seekers
pip install skill-seekers

# 2. Create a skill from any source
skill-seekers create https://docs.django.com/

# 3. Package it for your AI platform
skill-seekers package output/django --target claude

That's it! You now have output/django-claude.zip ready to upload.

---

What You Can Create From

The create command auto-detects your source:

Source Type	Example Command
Documentation	skill-seekers create https://docs.react.dev/
GitHub Repo	skill-seekers create facebook/react
Local Code	skill-seekers create ./my-project
PDF File	skill-seekers create manual.pdf
Config File	skill-seekers create configs/custom.json

---

Examples by Source

Documentation Website

# React documentation
skill-seekers create https://react.dev/
skill-seekers package output/react --target claude

# Django documentation  
skill-seekers create https://docs.djangoproject.com/
skill-seekers package output/django --target claude

GitHub Repository

# React source code
skill-seekers create facebook/react
skill-seekers package output/react --target claude

# Your own repo
skill-seekers create yourusername/yourrepo
skill-seekers package output/yourrepo --target claude

Local Project

# Your codebase
skill-seekers create ./my-project
skill-seekers package output/my-project --target claude

# Specific directory
cd ~/projects/my-api
skill-seekers create .
skill-seekers package output/my-api --target claude

PDF Document

# Technical manual
skill-seekers create manual.pdf --name product-docs
skill-seekers package output/product-docs --target claude

# Research paper
skill-seekers create paper.pdf --name research
skill-seekers package output/research --target claude

---

Common Options

Specify a Name

skill-seekers create https://docs.example.com/ --name my-docs

Add Description

skill-seekers create facebook/react --description "React source code analysis"

Dry Run (Preview)

skill-seekers create https://docs.react.dev/ --dry-run

Skip Enhancement (Faster)

skill-seekers create https://docs.react.dev/ --enhance-level 0

Use a Preset

# Quick analysis (1-2 min)
skill-seekers create ./my-project --preset quick

# Comprehensive analysis (20-60 min)
skill-seekers create ./my-project --preset comprehensive

---

Package for Different Platforms

Claude AI (Default)

skill-seekers package output/my-skill/
# Creates: output/my-skill-claude.zip

Google Gemini

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

OpenAI ChatGPT

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

LangChain

skill-seekers package output/my-skill/ --target langchain
# Creates: output/my-skill-langchain/ directory

Multiple Platforms

for platform in claude gemini openai; do
  skill-seekers package output/my-skill/ --target $platform
done

---

Upload to Platform

Upload to Claude

export ANTHROPIC_API_KEY=sk-ant-...
skill-seekers upload output/my-skill-claude.zip --target claude

Upload to Gemini

export GOOGLE_API_KEY=AIza...
skill-seekers upload output/my-skill-gemini.tar.gz --target gemini

Auto-Upload After Package

export ANTHROPIC_API_KEY=sk-ant-...
skill-seekers package output/my-skill/ --target claude --upload

---

Complete One-Command Workflow

Use install for everything in one step:

# Complete: scrape → enhance → package → upload
export ANTHROPIC_API_KEY=sk-ant-...
skill-seekers install --config react --target claude

# Skip upload
skill-seekers install --config react --target claude --no-upload

---

Output Structure

After running create, you'll have:

output/
├── django/                    # The skill
│   ├── SKILL.md              # Main skill file
│   ├── references/           # Organized documentation
│   │   ├── index.md
│   │   ├── getting_started.md
│   │   └── api_reference.md
│   └── .skill-seekers/       # Metadata
│
└── django-claude.zip         # Packaged skill (after package)

---

Time Estimates

Source Type	Size	Time
Small docs (< 50 pages)	~10 MB	2-5 min
Medium docs (50-200 pages)	~50 MB	10-20 min
Large docs (200-500 pages)	~200 MB	30-60 min
GitHub repo (< 1000 files)	varies	5-15 min
Local project	varies	2-10 min
PDF (< 100 pages)	~5 MB	1-3 min

Times include scraping + enhancement (level 2). Use --enhance-level 0 to skip enhancement.

---

Quick Tips

Test First with Dry Run

skill-seekers create https://docs.example.com/ --dry-run

Use Presets for Faster Results

# Quick mode for testing
skill-seekers create https://docs.react.dev/ --preset quick

Skip Enhancement for Speed

skill-seekers create https://docs.react.dev/ --enhance-level 0
skill-seekers enhance output/react/  # Enhance later

Check Available Configs

skill-seekers estimate --all

Resume Interrupted Jobs

skill-seekers resume --list
skill-seekers resume <job-id>

---

Next Steps

• Your First Skill - Complete walkthrough
• Core Concepts - Understand how it works
• Scraping Guide - All scraping options

---

Troubleshooting

"command not found"

# Add to PATH
export PATH="$HOME/.local/bin:$PATH"

"No module named 'skill_seekers'"

# Reinstall
pip install --force-reinstall skill-seekers

Scraping too slow

# Use async mode
skill-seekers create https://docs.react.dev/ --async --workers 5

Out of memory

# Use streaming mode
skill-seekers package output/large-skill/ --streaming

---

See Also

• Installation Guide - Detailed installation
• CLI Reference - All commands
• Config Format - Custom configurations