yusufkaraaslan

Troubleshooting Guide

Development community intermediate

SOURCE https://github.com/yusufkaraaslan/Skill_Seekers

Description

Common issues and solutions when using Skill Seeker. ---

Installation

This entry records only its repository, not the path inside it, so there is no exact command to give. Open the source below and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

Repository README

This is the README for yusufkaraaslan/Skill_Seekers, shared by 5 entries in this directory. It describes the repository, not this entry specifically.

Troubleshooting Guide

Common issues and solutions when using Skill Seeker.

Installation Issues

Python Not Found

**Error:**

python3: command not found

**Solutions:**

**Check if Python is installed:**

which python3
python --version  # Try without the 3

**Install Python:**
- macOS: brew install python3
- Linux: sudo apt install python3 python3-pip
- Windows: Download from python.org, check "Add to PATH"
**Use python instead of python3:**
```
python cli/doc_scraper.py --help
```

Module Not Found

**Error:**

ModuleNotFoundError: No module named 'requests'
ModuleNotFoundError: No module named 'bs4'
ModuleNotFoundError: No module named 'mcp'

**Solutions:**

**Install dependencies:**

pip3 install requests beautifulsoup4
pip3 install -r mcp/requirements.txt  # For MCP

**Use --user flag if permission denied:**

pip3 install --user requests beautifulsoup4

**Check pip is working:**
```
pip3 --version
```

Permission Denied

**Error:**

Permission denied: '/usr/local/lib/python3.x/...'

**Solutions:**

**Use --user flag:**

pip3 install --user requests beautifulsoup4

**Use sudo (not recommended):**

sudo pip3 install requests beautifulsoup4

**Use virtual environment (best practice):**

python3 -m venv venv
source venv/bin/activate
pip install requests beautifulsoup4

Runtime Issues

File Not Found

**Error:**

FileNotFoundError: [Errno 2] No such file or directory: 'cli/doc_scraper.py'

**Solutions:**

**Check you're in the Skill_Seekers directory:**

pwd
# Should show: .../Skill_Seekers

ls
# Should show: README.md, cli/, mcp/, configs/

**Change to the correct directory:**

cd ~/Projects/Skill_Seekers  # Adjust path

Config File Not Found

**Error:**

❌ Error: Config file not found: configs/myconfig.json

**Understanding Config Locations:**

The tool searches for configs in this order:

Exact path as provided
./configs/ (current directory)
~/.config/skill-seekers/configs/ (user config directory)
SkillSeekersWeb.com API (preset configs)

**Solutions:**

**Place config in user directory (recommended for custom configs):**

mkdir -p ~/.config/skill-seekers/configs
cp myconfig.json ~/.config/skill-seekers/configs/

# Now you can use it from anywhere
skill-seekers scrape --config myconfig.json

**Place config in current directory (project-specific):**

mkdir -p configs
cp myconfig.json configs/

skill-seekers scrape --config configs/myconfig.json

**Use absolute path:**

skill-seekers scrape --config /full/path/to/myconfig.json

**Check if it's a preset config (auto-downloads):**
```
# List all available pr
```