firefrost-gaming/skill-seekers-reference

Files

yusyus 6bb7078fbc docs: update all documentation for 12 LLM platforms and 18 agents

- README.md + 11 i18n READMEs: 5→12 LLM platforms, 11→18 agents, new platform/agent tables
- CLAUDE.md: updated --target list, adaptor directory tree
- CHANGELOG.md: added v3.4.0 entry with all Phase 1-4 changes
- docs/reference/CLI_REFERENCE.md: new --target and --agent options
- docs/reference/FEATURE_MATRIX.md: updated all platform counts and tables
- docs/user-guide/04-packaging.md: new platform and agent rows
- docs/FAQ.md: expanded platform/agent answers
- docs/zh-CN/*: synchronized Chinese documentation

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

2026-03-21 20:42:31 +03:00

35 KiB

Raw Blame History

CLI Reference - Skill Seekers

Version: 3.4.0 Last Updated: 2026-03-21 Complete reference for all 30+ CLI commands

Overview
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
- video - Extract from video
- word - Extract from Word document
- epub - Extract from EPUB
- jupyter - Extract from Jupyter Notebook
- html - Extract from local HTML
- openapi - Extract from OpenAPI/Swagger spec
- asciidoc - Extract from AsciiDoc
- pptx - Extract from PowerPoint
- rss - Extract from RSS/Atom feed
- manpage - Extract from man page
- confluence - Extract from Confluence wiki
- notion - Extract from Notion pages
- chat - Extract from Slack/Discord export
- workflows - Manage workflow presets
Common Workflows
Exit Codes
Troubleshooting

Overview

Skill Seekers provides a unified CLI for converting 17 source types—documentation, GitHub repositories, PDFs, videos, notebooks, wikis, and more—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:

Flag	Description
`-h, --help`	Show help message and exit
`--version`	Show version number and exit
`-v, --verbose`	Enable verbose (DEBUG) output
`-q, --quiet`	Minimize output (WARNING only)
`--dry-run`	Preview without executing

Environment Variables

See ENVIRONMENT_VARIABLES.md for complete reference.

Common variables:

Variable	Purpose
`ANTHROPIC_API_KEY`	Claude AI API access
`GOOGLE_API_KEY`	Google Gemini API access
`OPENAI_API_KEY`	OpenAI API access
`GITHUB_TOKEN`	GitHub API (higher rate limits)

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:

Name	Required	Description
`--directory DIR`	Yes	Directory to analyze
`--output DIR`	No	Output directory (default: output/codebase/)

Flags:

Short	Long	Default	Description
	`--preset`	standard	Analysis preset: quick, standard, comprehensive
	`--preset-list`		Show available presets and exit
	`--languages`	auto	Comma-separated languages (Python,JavaScript,C++)
	`--file-patterns`		Comma-separated file patterns
	`--enhance-level`	2	AI enhancement: 0=off, 1=SKILL.md, 2=+config, 3=full
	`--skip-api-reference`		Skip API docs generation
	`--skip-dependency-graph`		Skip dependency graph
	`--skip-patterns`		Skip pattern detection
	`--skip-test-examples`		Skip test example extraction
	`--skip-how-to-guides`		Skip how-to guide generation
	`--skip-config-patterns`		Skip config pattern extraction
	`--skip-docs`		Skip project docs (README)
	`--no-comments`		Skip comment extraction
`-v`	`--verbose`		Enable verbose logging

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:

Short	Long	Description
	`--github`	Go directly to GitHub token setup
	`--api-keys`	Go directly to API keys setup
	`--show`	Show current configuration
	`--test`	Test connections

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:

Name	Required	Description
`source`	No	Source URL, repo, path, or config file

Source Types (Auto-Detected):

Source Pattern	Type	Example
`https://...`	Documentation	`https://docs.react.dev/`
`owner/repo`	GitHub	`facebook/react`
`./path`	Local codebase	`./my-project`
`*.pdf`	PDF	`manual.pdf`
`*.docx`	Word Document	`report.docx`
`*.epub`	EPUB	`book.epub`
`*.ipynb`	Jupyter Notebook	`analysis.ipynb`
`.html` / `.htm`	Local HTML	`page.html`
`.yaml` / `.yml` (OpenAPI)	OpenAPI/Swagger	`api-spec.yaml`
`.adoc` / `.asciidoc`	AsciiDoc	`guide.adoc`
`*.pptx`	PowerPoint	`slides.pptx`
`.rss` / `.atom`	RSS/Atom Feed	`feed.rss`
`.1`–`.8` / `*.man`	Man Page	`curl.1`
`*.json`	Config file	`config.json`

Flags:

Short	Long	Default	Description
`-n`	`--name`	auto	Skill name
`-d`	`--description`	auto	Skill description
`-o`	`--output`	auto	Output directory
`-p`	`--preset`		Analysis preset: quick, standard, comprehensive
`-c`	`--config`		Load settings from JSON file
	`--enhance-level`	2	AI enhancement level (0-3)
	`--api-key`		Anthropic API key
	`--enhance-workflow`		Apply workflow preset (can use multiple)
	`--enhance-stage`		Add inline enhancement stage
	`--var`		Override workflow variable (key=value)
	`--workflow-dry-run`		Preview workflow without executing
	`--dry-run`		Preview without creating
	`--chunk-for-rag`		Enable RAG chunking
	`--chunk-tokens`	512	Chunk size in tokens
	`--chunk-overlap-tokens`	50	Chunk overlap in tokens
	`--help-web`		Show web scraping options
	`--help-github`		Show GitHub options
	`--help-local`		Show local analysis options
	`--help-pdf`		Show PDF options
	`--help-all`		Show all 120+ options

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:

Name	Required	Description
`SKILL_DIRECTORY`	Yes	Path to skill directory

Flags:

Long	Default	Description
`--agent`	claude	Local coding agent to use
`--agent-cmd`		Override agent command template
`--background`		Run in background
`--daemon`		Run as daemon
`--no-force`		Enable confirmations
`--timeout`	600	Timeout in seconds

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:

Name	Required	Description
`SKILL_DIRECTORY`	Yes	Path to skill directory

Flags:

Short	Long	Default	Description
`-w`	`--watch`		Watch in real-time
	`--json`		JSON output
	`--interval`	5	Watch interval in seconds

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:

Name	Required	Description
`config`	No	Config JSON file path

Flags:

Short	Long	Default	Description
	`--all`		List all available configs
	`--max-discovery`	1000	Max pages to discover

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:

Short	Long	Default	Description
	`--repo`		Repository (owner/repo format)
`-c`	`--config`		Config JSON file
	`--token`		GitHub personal access token
`-n`	`--name`	auto	Skill name
`-d`	`--description`	auto	Description
	`--no-issues`		Skip GitHub issues
	`--no-changelog`		Skip CHANGELOG
	`--no-releases`		Skip releases
	`--max-issues`	100	Max issues to fetch
	`--scrape-only`		Only scrape, don't build
	`--enhance-level`	2	AI enhancement (0-3)
	`--api-key`		Anthropic API key
	`--enhance-workflow`		Apply workflow preset
	`--non-interactive`		CI/CD mode (fail fast)
	`--profile`		GitHub profile from config

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:

Name	Required	Description
`--config CONFIG`	Yes	Config name or path

Flags:

Long	Default	Description
`--destination`	output/	Output directory
`--no-upload`		Skip upload to Claude
`--unlimited`		Remove page limits
`--dry-run`		Preview without executing

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, Roo, Aider, Bolt, Kilo, Continue, Kimi Code).

Purpose: Direct installation to IDE AI assistant context directories.

Syntax:

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

Arguments:

Name	Required	Description
`SKILL_DIRECTORY`	Yes	Path to skill directory
`--agent AGENT`	Yes	Target agent: cursor, windsurf, cline, continue, roo, aider, bolt, kilo, kimi-code

Flags:

Short	Long	Description
	`--force`	Overwrite existing

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:

Short	Long	Description
`-c`	`--config`	Config JSON file
	`--primary`	Primary language
	`--languages`	Comma-separated languages
	`--merge-strategy`	How to merge: parallel, hierarchical

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:

Name	Required	Description
`SKILL_DIRECTORY`	Yes	Path to skill directory

Flags:

Long	Default	Description
`--target`	claude	Target platform
`--no-open`		Don't open output folder
`--skip-quality-check`		Skip quality checks
`--upload`		Auto-upload after packaging
`--streaming`		Streaming mode for large docs
`--streaming-chunk-chars`	4000	Max chars per chunk (streaming)
`--streaming-overlap-chars`	200	Overlap between chunks (chars)
`--batch-size`	100	Chunks per batch
`--chunk-for-rag`		Enable RAG chunking
`--chunk-tokens`	512	Max tokens per chunk
`--chunk-overlap-tokens`	50	Overlap between chunks (tokens)
`--no-preserve-code-blocks`		Allow code block splitting

Supported Platforms:

Platform	Format	Flag
Claude AI	ZIP + YAML	`--target claude`
Google Gemini	tar.gz	`--target gemini`
OpenAI	ZIP + Vector	`--target openai`
OpenCode	Directory	`--target opencode`
Kimi	ZIP	`--target kimi`
DeepSeek	ZIP	`--target deepseek`
Qwen	ZIP	`--target qwen`
OpenRouter	ZIP	`--target openrouter`
Together AI	ZIP	`--target together`
Fireworks AI	ZIP	`--target fireworks`
LangChain	Documents	`--target langchain`
LlamaIndex	TextNodes	`--target llama-index`
Haystack	Documents	`--target haystack`
ChromaDB	Collection	`--target chroma`
Weaviate	Objects	`--target weaviate`
Qdrant	Points	`--target qdrant`
FAISS	Index	`--target faiss`
Pinecone	Markdown	`--target pinecone`
Markdown	ZIP	`--target markdown`

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:

Short	Long	Description
`-c`	`--config`	PDF config JSON file
	`--pdf`	Direct PDF file path
`-n`	`--name`	Skill name
`-d`	`--description`	Description
	`--from-json`	Build from extracted JSON
	`--enhance-workflow`	Apply workflow preset
	`--enhance-stage`	Add inline stage
	`--var`	Override workflow variable
	`--workflow-dry-run`	Preview workflow
	`--enhance-level`	0

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:

Name	Required	Description
`SKILL_DIRECTORY`	Yes	Path to skill directory

Flags:

Short	Long	Description
	`--report`	Generate detailed report
	`--threshold`	Quality threshold (0-10)

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:

Name	Required	Description
`JOB_ID`	No	Job ID to resume

Flags:

Short	Long	Description
	`--list`	List all resumable jobs
	`--clean`	Clean up old progress files

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:

Name	Required	Description
`url`	No	Base documentation URL

Flags:

Short	Long	Default	Description
`-c`	`--config`		Config JSON file
`-n`	`--name`		Skill name
`-d`	`--description`		Description
	`--enhance-level`	2	AI enhancement (0-3)
	`--api-key`		Anthropic API key
	`--enhance-workflow`		Apply workflow preset
	`--enhance-stage`		Add inline stage
	`--var`		Override workflow variable
	`--workflow-dry-run`		Preview workflow
`-i`	`--interactive`		Interactive mode
	`--url`		Base URL (alternative to positional)
	`--max-pages`		Max pages to scrape
	`--skip-scrape`		Use existing data
	`--dry-run`		Preview without scraping
	`--resume`		Resume from checkpoint
	`--fresh`		Clear checkpoint
`-r`	`--rate-limit`	0.5	Rate limit in seconds
`-w`	`--workers`	1	Parallel workers (max 10)
	`--async`		Enable async mode
	`--no-rate-limit`		Disable rate limiting
	`--interactive-enhancement`		Interactive enhancement
`-v`	`--verbose`		Verbose output
`-q`	`--quiet`		Quiet output

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:

Short	Long	Description
`-c`	`--config`	Config JSON file
	`--streaming-chunk-chars`	Maximum characters per chunk (default: 4000)
	`--output`	Output directory

Examples:

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

# Custom chunk size
skill-seekers stream --config configs/large-docs.json --streaming-chunk-chars 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:

Name	Required	Description
`--config FILE`	Yes	Unified config JSON file

Flags:

Long	Default	Description
`--merge-mode`	claude-enhanced	Merge mode: rule-based, claude-enhanced
`--fresh`		Clear existing data
`--dry-run`		Dry run mode

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:

Short	Long	Description
`-c`	`--config`	Config JSON file
	`--since`	Update since date
	`--check-only`	Check for updates only

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:

Name	Required	Description
`PACKAGE_FILE`	Yes	Path to package file (.zip, .tar.gz)

Flags:

Long	Default	Description
`--target`	claude	Target platform
`--api-key`		Platform API key
`--chroma-url`		ChromaDB URL
`--persist-directory`	./chroma_db	ChromaDB local directory
`--embedding-function`		Embedding function
`--openai-api-key`		OpenAI key for embeddings
`--weaviate-url`		Weaviate URL
`--use-cloud`		Use Weaviate Cloud
`--cluster-url`		Weaviate Cloud cluster URL

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

video

Extract content from YouTube, Vimeo, or local video files.

Syntax:

skill-seekers video [options]

Flags:

Short	Long	Default	Description
	`--url`		YouTube/Vimeo URL
	`--video-file`		Local video file path
	`--playlist`		YouTube playlist URL
`-n`	`--name`	auto	Skill name
	`--visual`		Enable visual frame analysis
	`--enhance-level`	2	AI enhancement (0-3)
	`--start-time`		Start time (seconds or MM:SS or HH:MM:SS)
	`--end-time`		End time
	`--setup`		Auto-detect GPU and install visual dependencies

Examples:

# YouTube video
skill-seekers video --url https://www.youtube.com/watch?v=... --name tutorial

# Local video with visual analysis
skill-seekers video --video-file recording.mp4 --name recording --visual

# Setup GPU-aware dependencies
skill-seekers video --setup

word

Extract content from Word (.docx) documents.

Syntax:

skill-seekers word --docx FILE [options]

Examples:

skill-seekers word --docx report.docx --name report
# Or via create:
skill-seekers create report.docx

epub

Extract content from EPUB e-books.

Syntax:

skill-seekers epub --epub FILE [options]

Examples:

skill-seekers epub --epub book.epub --name book
# Or via create:
skill-seekers create book.epub

jupyter

Extract content from Jupyter Notebooks (.ipynb).

Syntax:

skill-seekers jupyter --notebook FILE [options]

Examples:

skill-seekers jupyter --notebook analysis.ipynb --name data-analysis
# Or via create:
skill-seekers create analysis.ipynb

html

Extract content from local HTML files.

Syntax:

skill-seekers html --html-path FILE [options]

Examples:

skill-seekers html --html-path docs/index.html --name local-docs
# Or via create:
skill-seekers create page.html

openapi

Extract API documentation from OpenAPI/Swagger specifications.

Syntax:

skill-seekers openapi --spec FILE [options]

Examples:

skill-seekers openapi --spec api-spec.yaml --name my-api
# Or via create:
skill-seekers create api-spec.yaml

asciidoc

Extract content from AsciiDoc files.

Syntax:

skill-seekers asciidoc --asciidoc-path FILE [options]

Examples:

skill-seekers asciidoc --asciidoc-path guide.adoc --name guide
# Or via create:
skill-seekers create guide.adoc

pptx

Extract content from PowerPoint (.pptx) presentations.

Syntax:

skill-seekers pptx --pptx FILE [options]

Examples:

skill-seekers pptx --pptx slides.pptx --name presentation
# Or via create:
skill-seekers create slides.pptx

rss

Extract content from RSS/Atom feeds.

Syntax:

skill-seekers rss [options]

Flags:

Short	Long	Description
	`--feed-url`	RSS/Atom feed URL
	`--feed-path`	Local RSS/Atom file path
`-n`	`--name`	Skill name

Examples:

skill-seekers rss --feed-url https://blog.example.com/feed --name blog
skill-seekers rss --feed-path feed.rss --name feed
# Or via create:
skill-seekers create feed.rss

manpage

Extract content from Unix man pages.

Syntax:

skill-seekers manpage --man-path FILE [options]

Examples:

skill-seekers manpage --man-path curl.1 --name curl-docs
# Or via create:
skill-seekers create curl.1

confluence

Extract content from Confluence wikis.

Syntax:

skill-seekers confluence [options]

Flags:

Short	Long	Description
	`--space-key`	Confluence space key
	`--base-url`	Confluence base URL
	`--export-path`	Path to Confluence export directory
`-n`	`--name`	Skill name

Examples:

# From Confluence API
skill-seekers confluence --space-key DEV --base-url https://wiki.example.com --name team-wiki

# From Confluence export
skill-seekers confluence --export-path ./confluence-export/ --name wiki

notion

Extract content from Notion pages and databases.

Syntax:

skill-seekers notion [options]

Flags:

Short	Long	Description
	`--database-id`	Notion database ID
	`--page-id`	Notion page ID
	`--export-path`	Path to Notion export directory
`-n`	`--name`	Skill name

Examples:

# From Notion API
skill-seekers notion --database-id abc123 --name my-notes

# From Notion export
skill-seekers notion --export-path ./notion-export/ --name notes

chat

Extract content from Slack/Discord chat exports.

Syntax:

skill-seekers chat --export-path DIR [options]

Examples:

skill-seekers chat --export-path ./slack-export/ --name team-chat
skill-seekers chat --export-path ./discord-export/ --name server-archive

workflows

Manage enhancement workflow presets.

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

Syntax:

skill-seekers workflows ACTION [options]

Actions:

Action	Description
`list`	List all workflows (bundled + user)
`show`	Print YAML content of workflow
`copy`	Copy bundled workflow to user dir
`add`	Install custom YAML workflow
`remove`	Delete user workflow
`validate`	Validate workflow file

Flags:

Short	Long	Description
	`--name`	Custom name for add action

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

Code	Meaning
`0`	Success
`1`	General error
`2`	Warning (e.g., estimation hit limit)
`130`	Interrupted by user (Ctrl+C)

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

35 KiB Raw Blame History Unescape Escape

CLI Reference - Skill Seekers

Table of Contents

Overview

Installation

Global Flags

Environment Variables

Command Reference

analyze

config

create

enhance

enhance-status

estimate

github

install

install-agent

multilang

package

pdf

quality

resume

scrape

stream

unified

update

upload

video

word

epub

jupyter

html

openapi

asciidoc

pptx

rss

manpage

confluence

notion

chat

workflows

Common Workflows

Workflow 1: Documentation → Skill

Workflow 2: GitHub → Skill

Workflow 3: Local Codebase → Skill

Workflow 4: PDF → Skill

Workflow 5: Multi-Source → Skill

Workflow 6: One-Command Complete

Exit Codes

Troubleshooting

Command not found

ImportError

Rate limiting

Out of memory

See Also

35 KiB

Raw Blame History