2cab53bc94
Test Vector Database Adaptors / Test MCP Vector DB Tools (push) Has been cancelled
Tests / Code Quality (Ruff & Mypy) (push) Has been cancelled
Tests / Fast Unit Tests (parallel) (macos-latest, 3.11) (push) Has been cancelled
Tests / Fast Unit Tests (parallel) (macos-latest, 3.12) (push) Has been cancelled
Tests / Tests (push) Has been cancelled
Docker Publish / Build and Push Docker Images (map[description:Skill Seekers CLI - Convert documentation to AI skills dockerfile:Dockerfile name:skill-seekers]) (push) Has been cancelled
Docker Publish / Build and Push Docker Images (map[description:Skill Seekers MCP Server - 25 tools for AI assistants dockerfile:Dockerfile.mcp name:skill-seekers-mcp]) (push) Has been cancelled
Docker Publish / Test Docker Images (push) Has been cancelled
Tests / Fast Unit Tests (parallel) (ubuntu-latest, 3.10) (push) Has been cancelled
Tests / Fast Unit Tests (parallel) (ubuntu-latest, 3.11) (push) Has been cancelled
Tests / Fast Unit Tests (parallel) (ubuntu-latest, 3.12) (push) Has been cancelled
Tests / Serial / Integration / E2E Tests (push) Has been cancelled
Tests / MCP Server Tests (push) Has been cancelled
Test Vector Database Adaptors / Test chroma Adaptor (push) Has been cancelled
Test Vector Database Adaptors / Test faiss Adaptor (push) Has been cancelled
Test Vector Database Adaptors / Test qdrant Adaptor (push) Has been cancelled
Test Vector Database Adaptors / Test weaviate Adaptor (push) Has been cancelled
2.6 KiB
2.6 KiB
Troubleshooting Guide
Skill Seekers v3.6.0
This chapter covers the most common issues. For the complete troubleshooting guide with all error codes, platform-specific fixes, and advanced diagnostics, see docs/TROUBLESHOOTING.md.
Quick Fixes
| Issue | Quick Fix |
|---|---|
command not found |
export PATH="$HOME/.local/bin:$PATH" |
ImportError |
pip install -e . |
Rate limit |
Add --rate-limit 2.0 |
No content |
Check selectors in config |
Enhancement fails |
Set ANTHROPIC_API_KEY |
Out of memory |
Use --streaming mode |
Installation Issues
"command not found: skill-seekers"
Cause: pip bin directory not in PATH
export PATH="$HOME/.local/bin:$PATH"
which skill-seekers
"No module named 'skill_seekers'"
Cause: Package not installed
pip install -e .
python -c "import skill_seekers; print(skill_seekers.__version__)"
Scraping Issues
"Rate limit exceeded"
skill-seekers create <url> --rate-limit 2.0
export GITHUB_TOKEN=ghp_...
"No content extracted"
Cause: Wrong CSS selectors. Check your config or use auto-detection:
skill-seekers create <url> --preset quick
Enhancement Issues
"Enhancement failed: No API key"
export ANTHROPIC_API_KEY=sk-ant-...
# Or use LOCAL mode (no API key needed — pick an installed local agent)
skill-seekers enhance output/my-skill/ --agent claude
Packaging & Upload Issues
"Target platform not supported"
skill-seekers package output/my-skill/ --target claude
# Valid targets: claude, gemini, openai, langchain, llama-index,
# haystack, pinecone, chroma, weaviate, qdrant, faiss, markdown,
# deepseek, kimi, qwen, openrouter, together, fireworks, ibm-bob
"Upload failed: Invalid API key"
Check platform-specific env vars:
- Claude:
ANTHROPIC_API_KEY - Gemini:
GOOGLE_API_KEY - OpenAI:
OPENAI_API_KEY
Getting Help
Debug Mode
skill-seekers create <source> --verbose
export SKILL_SEEKERS_DEBUG=1
Report an Issue
- Gather info:
skill-seekers --version,python --version - Enable debug:
skill-seekers <command> --verbose 2>&1 | tee debug.log - Create issue: https://github.com/yusufkaraaslan/Skill_Seekers/issues
Need more? See the complete troubleshooting guide for:
- All error codes and solutions
- Platform-specific fixes (Docker, K8s, Windows)
- Performance tuning
- Network and SSL issues
- Source-specific troubleshooting (PDF, video, GitHub, etc.)