CLI Reference - Skill Seekers

CLI Reference - Skill Seekers

Version: 3.1.0
Last Updated: 2026-02-16
Complete reference for all 20 CLI commands

Table of Contents

• Overview
  • Installation
  • Global Flags
  • Environment Variables
• Command Reference
  • analyze - Analyze local codebase
  • config - Configuration wizard
  • create - Create skill (auto-detects source)
  • enhance - AI enhancement (local mode)
  • enhance-status - Monitor enhancement
  • estimate - Estimate page counts
  • github - Scrape GitHub repository
  • install - One-command complete workflow
  • install-agent - Install to AI agent
  • multilang - Multi-language docs
  • package - Package skill for platform
  • pdf - Extract from PDF
  • quality - Quality scoring
  • resume - Resume interrupted jobs
  • scrape - Scrape documentation
  • stream - Stream large files
  • unified - Multi-source scraping
  • update - Incremental updates
  • upload - Upload to platform
  • workflows - Manage workflow presets
• Common Workflows
• Exit Codes
• Troubleshooting

Overview

Skill Seekers provides a unified CLI for converting documentation, GitHub repositories, PDFs, and local codebases into AI-ready skills.

Installation

# Basic installation
pip install skill-seekers

# With all platform support
pip install skill-seekers[all-llms]

# Development setup
pip install -e ".[all-llms,dev]"

Verify installation:

skill-seekers --version

Global Flags

These flags work with most commands:

Environment Variables

See ENVIRONMENT_VARIABLES.md for complete reference.

Common variables:

Command Reference

Commands are organized alphabetically.

analyze

Analyze local codebase and extract code knowledge.

Purpose: Deep code analysis with pattern detection, API extraction, and documentation generation.

Syntax:

skill-seekers analyze --directory DIR [options]

Arguments:

Flags:

Examples:

# Basic analysis with defaults
skill-seekers analyze --directory ./my-project

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

# Comprehensive analysis with all features
skill-seekers analyze --directory ./my-project --preset comprehensive

# Specific languages only
skill-seekers analyze --directory ./my-project --languages Python,JavaScript

# Skip heavy features for faster analysis
skill-seekers analyze --directory ./my-project --skip-dependency-graph --skip-patterns

Exit Codes:

• 0 - Success
• 1 - Analysis failed

config

Interactive configuration wizard for API keys and settings.

Purpose: Setup GitHub tokens, API keys, and preferences.

Syntax:

skill-seekers config [options]

Flags:

Examples:

# Full configuration wizard
skill-seekers config

# Quick GitHub setup
skill-seekers config --github

# View current config
skill-seekers config --show

# Test all connections
skill-seekers config --test

create

Create skill from any source. Auto-detects source type.

Purpose: Universal entry point - handles URLs, GitHub repos, local directories, PDFs, and config files automatically.

Syntax:

skill-seekers create [source] [options]

Arguments:

Source Types (Auto-Detected):

Flags:

Examples:

# Documentation website
skill-seekers create https://docs.django.com/

# GitHub repository
skill-seekers create facebook/react

# Local codebase
skill-seekers create ./my-project

# PDF file
skill-seekers create manual.pdf --name product-docs

# With preset
skill-seekers create https://docs.react.dev/ --preset quick

# With enhancement workflow
skill-seekers create ./my-project --enhance-workflow security-focus

# Multi-workflow chaining
skill-seekers create ./my-project \
  --enhance-workflow security-focus \
  --enhance-workflow api-documentation

enhance

Enhance SKILL.md using local coding agent (Claude Code).

Purpose: AI-powered quality improvement without API costs. Requires Claude Code installed.

Syntax:

skill-seekers enhance SKILL_DIRECTORY [options]

Arguments:

Flags:

Examples:

# Basic enhancement
skill-seekers enhance output/react/

# Background mode
skill-seekers enhance output/react/ --background

# With custom timeout
skill-seekers enhance output/react/ --timeout 1200

# Monitor background enhancement
skill-seekers enhance-status output/react/ --watch

Requirements: Claude Code must be installed and authenticated.

enhance-status

Monitor background enhancement processes.

Purpose: Check status of enhancement running in background/daemon mode.

Syntax:

skill-seekers enhance-status SKILL_DIRECTORY [options]

Arguments:

Flags:

Examples:

# Check status once
skill-seekers enhance-status output/react/

# Watch continuously
skill-seekers enhance-status output/react/ --watch

# JSON output for scripting
skill-seekers enhance-status output/react/ --json

estimate

Estimate page count before scraping.

Purpose: Preview how many pages will be scraped without downloading.

Syntax:

skill-seekers estimate [config] [options]

Arguments:

Flags:

Examples:

# Estimate with config file
skill-seekers estimate configs/react.json

# Quick estimate (100 pages)
skill-seekers estimate configs/react.json --max-discovery 100

# List all available presets
skill-seekers estimate --all

github

Scrape GitHub repository and generate skill.

Purpose: Extract code, issues, releases, and metadata from GitHub repos.

Syntax:

skill-seekers github [options]

Flags:

Examples:

# Basic repo analysis
skill-seekers github --repo facebook/react

# With GitHub token (higher rate limits)
skill-seekers github --repo facebook/react --token $GITHUB_TOKEN

# Skip issues for faster scraping
skill-seekers github --repo facebook/react --no-issues

# Scrape only, build later
skill-seekers github --repo facebook/react --scrape-only

install

One-command complete workflow: fetch → scrape → enhance → package → upload.

Purpose: End-to-end automation for common workflows.

Syntax:

skill-seekers install --config CONFIG [options]

Arguments:

Flags:

Examples:

# Complete workflow with preset
skill-seekers install --config react

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

# Custom config
skill-seekers install --config configs/my-project.json

# Dry run to preview
skill-seekers install --config react --dry-run

Note: AI enhancement is mandatory for install command.

install-agent

Install skill to AI agent directories (Cursor, Windsurf, Cline).

Purpose: Direct installation to IDE AI assistant context directories.

Syntax:

skill-seekers install-agent SKILL_DIRECTORY --agent AGENT [options]

Arguments:

Flags:

Examples:

# Install to Cursor
skill-seekers install-agent output/react/ --agent cursor

# Install to Windsurf
skill-seekers install-agent output/react/ --agent windsurf

# Force overwrite
skill-seekers install-agent output/react/ --agent cursor --force

multilang

Multi-language documentation support.

Purpose: Scrape and merge documentation in multiple languages.

Syntax:

skill-seekers multilang --config CONFIG [options]

Flags:

Examples:

# Multi-language scrape
skill-seekers multilang --config configs/react-i18n.json

# Specific languages
skill-seekers multilang --config configs/docs.json --languages en,zh,es

package

Package skill directory into platform-specific format.

Purpose: Create uploadable packages for Claude, Gemini, OpenAI, and RAG platforms.

Syntax:

skill-seekers package SKILL_DIRECTORY [options]

Arguments:

Flags:

Supported Platforms:

Examples:

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

# Package for Gemini
skill-seekers package output/react/ --target gemini

# Package for multiple platforms
for platform in claude gemini openai; do
  skill-seekers package output/react/ --target $platform
done

# Package with upload
skill-seekers package output/react/ --target claude --upload

# Streaming mode for large docs
skill-seekers package output/large-docs/ --streaming

pdf

Extract content from PDF and generate skill.

Purpose: Convert PDF manuals, documentation, and papers into skills.

Syntax:

skill-seekers pdf [options]

Flags:

Examples:

# Direct PDF path
skill-seekers pdf --pdf manual.pdf --name product-manual

# With config file
skill-seekers pdf --config configs/manual.json

# Enable enhancement
skill-seekers pdf --pdf manual.pdf --enhance-level 2

quality

Analyze and score skill documentation quality.

Purpose: Quality assurance before packaging/uploading.

Syntax:

skill-seekers quality SKILL_DIRECTORY [options]

Arguments:

Flags:

Examples:

# Basic quality check
skill-seekers quality output/react/

# Detailed report
skill-seekers quality output/react/ --report

# Fail if below threshold
skill-seekers quality output/react/ --threshold 7.0

resume

Resume interrupted scraping job from checkpoint.

Purpose: Continue from where a scrape failed or was interrupted.

Syntax:

skill-seekers resume [JOB_ID] [options]

Arguments:

Flags:

Examples:

# List resumable jobs
skill-seekers resume --list

# Resume specific job
skill-seekers resume job-abc123

# Clean old checkpoints
skill-seekers resume --clean

scrape

Scrape documentation website and generate skill.

Purpose: The main command for converting web documentation into skills.

Syntax:

skill-seekers scrape [url] [options]

Arguments:

Flags:

Examples:

# With preset config
skill-seekers scrape --config configs/react.json

# Quick mode
skill-seekers scrape --name react --url https://react.dev/

# Interactive mode
skill-seekers scrape --interactive

# Dry run
skill-seekers scrape --config configs/react.json --dry-run

# Fast async scraping
skill-seekers scrape --config configs/react.json --async --workers 5

# Skip scrape, rebuild from cache
skill-seekers scrape --config configs/react.json --skip-scrape

# Resume interrupted scrape
skill-seekers scrape --config configs/react.json --resume

stream

Stream large files chunk-by-chunk.

Purpose: Memory-efficient processing for very large documentation sites.

Syntax:

skill-seekers stream --config CONFIG [options]

Flags:

Examples:

# Stream large documentation
skill-seekers stream --config configs/large-docs.json

# Custom chunk size
skill-seekers stream --config configs/large-docs.json --chunk-size 1000

unified

Multi-source scraping combining docs + GitHub + PDF.

Purpose: Create a single skill from multiple sources with conflict detection.

Syntax:

skill-seekers unified --config FILE [options]

Arguments:

Flags:

Examples:

# Unified scraping
skill-seekers unified --config configs/react-unified.json

# Fresh start
skill-seekers unified --config configs/react-unified.json --fresh

# Rule-based merging
skill-seekers unified --config configs/react-unified.json --merge-mode rule-based

Config Format:

{
  "name": "react-complete",
  "sources": [
    {"type": "docs", "base_url": "https://react.dev/"},
    {"type": "github", "repo": "facebook/react"}
  ]
}

update

Update docs without full rescrape.

Purpose: Incremental updates for changed documentation.

Syntax:

skill-seekers update --config CONFIG [options]

Flags:

Examples:

# Check for updates
skill-seekers update --config configs/react.json --check-only

# Update since specific date
skill-seekers update --config configs/react.json --since 2026-01-01

# Full update
skill-seekers update --config configs/react.json

upload

Upload skill package to LLM platform or vector database.

Purpose: Deploy packaged skills to target platforms.

Syntax:

skill-seekers upload PACKAGE_FILE [options]

Arguments:

Flags:

Examples:

# Upload to Claude
skill-seekers upload output/react-claude.zip

# Upload to Gemini
skill-seekers upload output/react-gemini.tar.gz --target gemini

# Upload to ChromaDB
skill-seekers upload output/react-chroma.zip --target chroma

# Upload to Weaviate Cloud
skill-seekers upload output/react-weaviate.zip --target weaviate \
  --use-cloud --cluster-url https://xxx.weaviate.network

workflows

Manage enhancement workflow presets.

Purpose: List, inspect, copy, add, remove, and validate YAML workflow presets.

Syntax:

skill-seekers workflows ACTION [options]

Actions:

Flags:

Examples:

# List all workflows
skill-seekers workflows list

# Show workflow content
skill-seekers workflows show security-focus

# Copy for editing
skill-seekers workflows copy security-focus

# Add custom workflow
skill-seekers workflows add ./my-workflow.yaml

# Add with custom name
skill-seekers workflows add ./workflow.yaml --name my-custom

# Remove user workflow
skill-seekers workflows remove my-workflow

# Validate workflow
skill-seekers workflows validate security-focus
skill-seekers workflows validate ./my-workflow.yaml

Built-in Presets:

• default - Standard enhancement
• minimal - Light enhancement
• security-focus - Security analysis (4 stages)
• architecture-comprehensive - Deep architecture review (7 stages)
• api-documentation - API docs focus (3 stages)

Common Workflows

Workflow 1: Documentation → Skill

# 1. Estimate pages (optional)
skill-seekers estimate configs/react.json

# 2. Scrape documentation
skill-seekers scrape --config configs/react.json

# 3. Enhance SKILL.md (optional, recommended)
skill-seekers enhance output/react/

# 4. Package for Claude
skill-seekers package output/react/ --target claude

# 5. Upload
skill-seekers upload output/react-claude.zip

Workflow 2: GitHub → Skill

# 1. Analyze repository
skill-seekers github --repo facebook/react

# 2. Package
skill-seekers package output/react/ --target claude

# 3. Upload
skill-seekers upload output/react-claude.zip

Workflow 3: Local Codebase → Skill

# 1. Analyze codebase
skill-seekers analyze --directory ./my-project

# 2. Package
skill-seekers package output/codebase/ --target claude

# 3. Install to Cursor
skill-seekers install-agent output/codebase/ --agent cursor

Workflow 4: PDF → Skill

# 1. Extract PDF
skill-seekers pdf --pdf manual.pdf --name product-docs

# 2. Package
skill-seekers package output/product-docs/ --target claude

Workflow 5: Multi-Source → Skill

# 1. Create unified config (configs/my-project.json)
# 2. Run unified scraping
skill-seekers unified --config configs/my-project.json

# 3. Package
skill-seekers package output/my-project/ --target claude

Workflow 6: One-Command Complete

# Everything in one command
skill-seekers install --config react --destination ./output

# Or with create
skill-seekers create https://docs.react.dev/ --preset standard

Exit Codes

Troubleshooting

Command not found

# Ensure package is installed
pip install skill-seekers

# Check PATH
which skill-seekers

ImportError

# Install in editable mode (development)
pip install -e .

Rate limiting

# Increase rate limit
skill-seekers scrape --config react.json --rate-limit 1.0

Out of memory

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

See Also

• Config Format - JSON configuration specification
• Environment Variables - Complete env var reference
• MCP Reference - MCP tools documentation

For additional help: skill-seekers --help or skill-seekers <command> --help