Bulletproof Quick Start Guide

Bulletproof Quick Start Guide

**Target Audience:** Complete beginners | Never used Python/git before? Start here!

**Time:** 15-30 minutes total (including all installations)

**Result:** Working Skill Seeker installation + your first Claude skill created

---

📋 What You'll Need

Before starting, you need:

• A computer (macOS, Linux, or Windows with WSL)
• Internet connection
• 30 minutes of time

That's it! We'll install everything else together.

---

Step 1: Install Python (5 minutes)

Check if You Already Have Python

Open Terminal (macOS/Linux) or Command Prompt (Windows) and type:

python3 --version

**✅ If you see:** `Python 3.10.x` or `Python 3.11.x` or higher → **Skip to Step 2!**

**❌ If you see:** `command not found` or version less than 3.10 → **Continue below**

Install Python

macOS:

# Install Homebrew (if not installed)
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

# Install Python
brew install python3

**Verify:**

python3 --version
# Should show: Python 3.11.x or similar

Linux (Ubuntu/Debian):

sudo apt update
sudo apt install python3 python3-pip

**Verify:**

python3 --version
pip3 --version

Windows:

1. Download Python from: https://www.python.org/downloads/
2. Run installer
3. IMPORTANT: Check "Add Python to PATH" during installation
4. Open Command Prompt and verify:

python --version

**✅ Success looks like:**

Python 3.11.5

---

Step 2: Install Git (3 minutes)

Check if You Have Git

git --version

**✅ If you see:** `git version 2.x.x` → **Skip to Step 3!**

**❌ If not installed:**

macOS:

brew install git

Linux:

sudo apt install git

Windows:

Download from: https://git-scm.com/download/win

**Verify:**

git --version
# Should show: git version 2.x.x

---

Step 3: Get Skill Seeker (2 minutes)

Choose Where to Put It

Pick a location for the project. Good choices:

• macOS/Linux: ~/Projects/ or ~/Documents/
  • Note: ~ means your home directory ($HOME or /Users/yourname on macOS, /home/yourname on Linux)
• Windows: C:\Users\YourName\Projects\

Clone the Repository

# Create Projects directory (if it doesn't exist)
mkdir -p ~/Projects
cd ~/Projects

# Clone Skill Seeker
git clone https://github.com/yusufkaraaslan/Skill_Seekers.git

# Enter the directory
cd Skill_Seekers

**✅ Success looks like:**

Cloning into 'Skill_Seekers'...
remote: Enumerating objects: 245, done.
remote: Counting objects: 100% (245/245), done.

**Verify you're in the right place:**

pwd
# Should show something like:
#   macOS: /Users/yourname/Projects/Skill_Seekers
#   Linux: /home/yourname/Projects/Skill_Seekers
# (Replace 'yourname' with YOUR actual username)

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

**❌ If `git clone` fails:**

# Check internet