064405c052
Bug fixes: - Fix --var flag silently dropped in create routing (args.workflow_var → args.var) - Fix double _score_code_quality() call in word scraper - Add .docx file extension validation in WordToSkillConverter - Fix weaviate ImportError masked by generic Exception handler - Fix RAG chunking crash using non-existent converter.output_dir Chunking pipeline improvements: - Wire --chunk-overlap-tokens through entire package pipeline (package_skill → adaptor.package → format_skill_md → _maybe_chunk_content → RAGChunker) - Add auto-scaling overlap: max(50, chunk_tokens//10) when chunk size is non-default - Rename --no-preserve-code to --no-preserve-code-blocks (backward-compat alias kept) - Replace hardcoded 512/50 chunk defaults with DEFAULT_CHUNK_TOKENS/DEFAULT_CHUNK_OVERLAP_TOKENS constants across all 12 concrete adaptors, rag_chunker, base, and package_skill Code quality: - Extract shared _generate_openai_embeddings() and _generate_st_embeddings() to SkillAdaptor base class, removing ~150 lines of duplication from chroma/weaviate/pinecone - Add Pinecone adaptor with full upload support (pinecone_adaptor.py) Tests (14 new): - chunk_overlap_tokens parameter wiring, auto-scaling overlap, preserve_code_blocks flag - .docx/.doc/no-extension file validation, --var flag routing E2E - Embedding method inheritance verification, backward-compatible flag aliases Docs: - Update CHANGELOG, CLI_REFERENCE, API_REFERENCE, packaging guide (EN+ZH) - Update README test count badge (1880+ → 2283+) All 2283 tests passing, 8 skipped, 0 failures. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Skill Seekers Documentation
Complete documentation for Skill Seekers v3.1.0
Welcome!
This is the official documentation for Skill Seekers - the universal tool for converting documentation, code, and PDFs into AI-ready skills.
Where Should I Start?
🚀 I'm New Here
Start with our Getting Started guides:
- Installation - Install Skill Seekers
- Quick Start - Create your first skill in 3 commands
- Your First Skill - Complete walkthrough
- Next Steps - Where to go from here
📖 I Want to Learn
Explore our User Guides:
- Core Concepts - How Skill Seekers works
- Scraping Guide - All scraping options
- Enhancement Guide - AI enhancement explained
- Packaging Guide - Export to platforms
- Workflows Guide - Enhancement workflows
- Troubleshooting - Common issues
📚 I Need Reference
Look up specific information:
- CLI Reference - All 20 commands
- MCP Reference - 26 MCP tools
- Config Format - JSON specification
- Environment Variables - All env vars
🚀 I'm Ready for Advanced Topics
Power user features:
- MCP Server Setup - MCP integration
- MCP Tools Deep Dive - Advanced MCP usage
- Custom Workflows - Create workflows
- Multi-Source Scraping - Combine sources
Quick Reference
The 3 Commands
# 1. Install
pip install skill-seekers
# 2. Create skill
skill-seekers create https://docs.django.com/
# 3. Package for Claude
skill-seekers package output/django --target claude
Common Commands
# Scrape documentation
skill-seekers scrape --config react
# Analyze GitHub repo
skill-seekers github --repo facebook/react
# Extract PDF
skill-seekers pdf manual.pdf --name docs
# Analyze local code
skill-seekers analyze --directory ./my-project
# Enhance skill
skill-seekers enhance output/my-skill/
# Package for platform
skill-seekers package output/my-skill/ --target claude
# Upload
skill-seekers upload output/my-skill-claude.zip
# List workflows
skill-seekers workflows list
Documentation Structure
docs/
├── README.md # This file - start here
├── ARCHITECTURE.md # How docs are organized
│
├── getting-started/ # For new users
│ ├── 01-installation.md
│ ├── 02-quick-start.md
│ ├── 03-your-first-skill.md
│ └── 04-next-steps.md
│
├── user-guide/ # Common tasks
│ ├── 01-core-concepts.md
│ ├── 02-scraping.md
│ ├── 03-enhancement.md
│ ├── 04-packaging.md
│ ├── 05-workflows.md
│ └── 06-troubleshooting.md
│
├── reference/ # Technical reference
│ ├── CLI_REFERENCE.md # 20 commands
│ ├── MCP_REFERENCE.md # 26 MCP tools
│ ├── CONFIG_FORMAT.md # JSON spec
│ └── ENVIRONMENT_VARIABLES.md
│
└── advanced/ # Power user topics
├── mcp-server.md
├── mcp-tools.md
├── custom-workflows.md
└── multi-source.md
By Use Case
I Want to Build AI Skills
For Claude, Gemini, ChatGPT:
I Want to Build RAG Pipelines
For LangChain, LlamaIndex, vector DBs:
I Want AI Coding Assistance
For Cursor, Windsurf, Cline:
- Your First Skill
- Local Codebase Analysis
skill-seekers install-agent --agent cursor
Version Information
- Current Version: 3.1.0
- Last Updated: 2026-02-16
- Python Required: 3.10+
Contributing to Documentation
Found an issue? Want to improve docs?
- Edit files in the
docs/directory - Follow the existing structure
- Submit a PR
See Contributing Guide for details.
External Links
- Main Repository: https://github.com/yusufkaraaslan/Skill_Seekers
- Website: https://skillseekersweb.com/
- PyPI: https://pypi.org/project/skill-seekers/
- Issues: https://github.com/yusufkaraaslan/Skill_Seekers/issues
License
MIT License - see LICENSE file.
Happy skill building! 🚀