chore: Bump version to v2.5.0 - Multi-Platform Feature Parity
Prepare v2.5.0 release with multi-LLM platform support. Major changes: - Add support for 4 platforms (Claude, Gemini, OpenAI, Markdown) - Complete feature parity across all platforms - 18 MCP tools with multi-platform support - Comprehensive platform documentation Updated files: - pyproject.toml: version 2.4.0 → 2.5.0 - README.md: version badge updated, tests 427 → 700 - CHANGELOG.md: Added v2.5.0 release notes - docs/CLAUDE.md: Updated version and features Release date: 2025-12-28
This commit is contained in:
yusyus
239
CHANGELOG.md
239
CHANGELOG.md
@@ -17,6 +17,245 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
|
|||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
|
## [2.5.0] - 2025-12-28
|
||||||
|
|
||||||
|
### 🚀 Multi-Platform Feature Parity - 4 LLM Platforms Supported
|
||||||
|
|
||||||
|
This **major feature release** adds complete multi-platform support for Claude AI, Google Gemini, OpenAI ChatGPT, and Generic Markdown export. All features now work across all platforms with full feature parity.
|
||||||
|
|
||||||
|
### 🎯 Major Features
|
||||||
|
|
||||||
|
#### Multi-LLM Platform Support
|
||||||
|
- **4 platforms supported**: Claude AI, Google Gemini, OpenAI ChatGPT, Generic Markdown
|
||||||
|
- **Complete feature parity**: All skill modes work with all platforms
|
||||||
|
- **Platform adaptors**: Clean architecture with platform-specific implementations
|
||||||
|
- **Unified workflow**: Same scraping output works for all platforms
|
||||||
|
- **Smart enhancement**: Platform-specific AI models (Claude Sonnet 4, Gemini 2.0 Flash, GPT-4o)
|
||||||
|
|
||||||
|
#### Platform-Specific Capabilities
|
||||||
|
|
||||||
|
**Claude AI (Default):**
|
||||||
|
- Format: ZIP with YAML frontmatter + markdown
|
||||||
|
- Upload: Anthropic Skills API
|
||||||
|
- Enhancement: Claude Sonnet 4 (local or API)
|
||||||
|
- MCP integration: Full support
|
||||||
|
|
||||||
|
**Google Gemini:**
|
||||||
|
- Format: tar.gz with plain markdown
|
||||||
|
- Upload: Google Files API + Grounding
|
||||||
|
- Enhancement: Gemini 2.0 Flash
|
||||||
|
- Long context: 1M tokens supported
|
||||||
|
|
||||||
|
**OpenAI ChatGPT:**
|
||||||
|
- Format: ZIP with assistant instructions
|
||||||
|
- Upload: Assistants API + Vector Store
|
||||||
|
- Enhancement: GPT-4o
|
||||||
|
- File search: Semantic search enabled
|
||||||
|
|
||||||
|
**Generic Markdown:**
|
||||||
|
- Format: ZIP with pure markdown
|
||||||
|
- Upload: Manual distribution
|
||||||
|
- Universal compatibility: Works with any LLM
|
||||||
|
|
||||||
|
#### Complete Feature Parity
|
||||||
|
|
||||||
|
**All skill modes work with all platforms:**
|
||||||
|
- Documentation scraping → All 4 platforms
|
||||||
|
- GitHub repository analysis → All 4 platforms
|
||||||
|
- PDF extraction → All 4 platforms
|
||||||
|
- Unified multi-source → All 4 platforms
|
||||||
|
- Local repository analysis → All 4 platforms
|
||||||
|
|
||||||
|
**18 MCP tools with multi-platform support:**
|
||||||
|
- `package_skill` - Now accepts `target` parameter (claude, gemini, openai, markdown)
|
||||||
|
- `upload_skill` - Now accepts `target` parameter (claude, gemini, openai)
|
||||||
|
- `enhance_skill` - NEW standalone tool with `target` parameter
|
||||||
|
- `install_skill` - Full multi-platform workflow automation
|
||||||
|
|
||||||
|
### Added
|
||||||
|
|
||||||
|
#### Core Infrastructure
|
||||||
|
- **Platform Adaptors** (`src/skill_seekers/cli/adaptors/`)
|
||||||
|
- `base_adaptor.py` - Abstract base class for all adaptors
|
||||||
|
- `claude_adaptor.py` - Claude AI implementation
|
||||||
|
- `gemini_adaptor.py` - Google Gemini implementation
|
||||||
|
- `openai_adaptor.py` - OpenAI ChatGPT implementation
|
||||||
|
- `markdown_adaptor.py` - Generic Markdown export
|
||||||
|
- `__init__.py` - Factory function `get_adaptor(target)`
|
||||||
|
|
||||||
|
#### CLI Tools
|
||||||
|
- **Multi-platform packaging**: `skill-seekers package output/skill/ --target gemini`
|
||||||
|
- **Multi-platform upload**: `skill-seekers upload skill.zip --target openai`
|
||||||
|
- **Multi-platform enhancement**: `skill-seekers enhance output/skill/ --target gemini --mode api`
|
||||||
|
- **Target parameter**: All packaging tools now accept `--target` flag
|
||||||
|
|
||||||
|
#### MCP Tools
|
||||||
|
- **`enhance_skill`** (NEW) - Standalone AI enhancement tool
|
||||||
|
- Supports local mode (Claude Code Max, no API key)
|
||||||
|
- Supports API mode (platform-specific APIs)
|
||||||
|
- Works with Claude, Gemini, OpenAI
|
||||||
|
- Creates SKILL.md.backup before enhancement
|
||||||
|
|
||||||
|
- **`package_skill`** (UPDATED) - Multi-platform packaging
|
||||||
|
- New `target` parameter (claude, gemini, openai, markdown)
|
||||||
|
- Creates ZIP for Claude/OpenAI/Markdown
|
||||||
|
- Creates tar.gz for Gemini
|
||||||
|
- Shows platform-specific output messages
|
||||||
|
|
||||||
|
- **`upload_skill`** (UPDATED) - Multi-platform upload
|
||||||
|
- New `target` parameter (claude, gemini, openai)
|
||||||
|
- Platform-specific API key validation
|
||||||
|
- Returns skill ID and platform URL
|
||||||
|
- Graceful error for markdown (no upload)
|
||||||
|
|
||||||
|
#### Documentation
|
||||||
|
- **`docs/FEATURE_MATRIX.md`** (NEW) - Comprehensive feature matrix
|
||||||
|
- Platform support comparison table
|
||||||
|
- Skill mode support across platforms
|
||||||
|
- CLI command support matrix
|
||||||
|
- MCP tool support matrix
|
||||||
|
- Platform-specific examples
|
||||||
|
- Verification checklist
|
||||||
|
|
||||||
|
- **`docs/UPLOAD_GUIDE.md`** (REWRITTEN) - Multi-platform upload guide
|
||||||
|
- Complete guide for all 4 platforms
|
||||||
|
- Platform selection table
|
||||||
|
- API key setup instructions
|
||||||
|
- Platform comparison matrices
|
||||||
|
- Complete workflow examples
|
||||||
|
|
||||||
|
- **`docs/ENHANCEMENT.md`** (UPDATED)
|
||||||
|
- Multi-platform enhancement section
|
||||||
|
- Platform-specific model information
|
||||||
|
- Cost comparison across platforms
|
||||||
|
|
||||||
|
- **`docs/MCP_SETUP.md`** (UPDATED)
|
||||||
|
- Added enhance_skill to tool listings
|
||||||
|
- Multi-platform usage examples
|
||||||
|
- Updated tool count (10 → 18 tools)
|
||||||
|
|
||||||
|
- **`src/skill_seekers/mcp/README.md`** (UPDATED)
|
||||||
|
- Corrected tool count (18 tools)
|
||||||
|
- Added enhance_skill documentation
|
||||||
|
- Updated package_skill with target parameter
|
||||||
|
- Updated upload_skill with target parameter
|
||||||
|
|
||||||
|
#### Optional Dependencies
|
||||||
|
- **`[gemini]`** extra: `pip install skill-seekers[gemini]`
|
||||||
|
- google-generativeai>=0.8.3
|
||||||
|
- Required for Gemini enhancement and upload
|
||||||
|
|
||||||
|
- **`[openai]`** extra: `pip install skill-seekers[openai]`
|
||||||
|
- openai>=1.59.6
|
||||||
|
- Required for OpenAI enhancement and upload
|
||||||
|
|
||||||
|
- **`[all-llms]`** extra: `pip install skill-seekers[all-llms]`
|
||||||
|
- Includes both Gemini and OpenAI dependencies
|
||||||
|
|
||||||
|
#### Tests
|
||||||
|
- **`tests/test_adaptors.py`** - Comprehensive adaptor tests
|
||||||
|
- **`tests/test_multi_llm_integration.py`** - E2E multi-platform tests
|
||||||
|
- **`tests/test_install_multiplatform.py`** - Multi-platform install_skill tests
|
||||||
|
- **700 total tests passing** (up from 427 in v2.4.0)
|
||||||
|
|
||||||
|
### Changed
|
||||||
|
|
||||||
|
#### CLI Architecture
|
||||||
|
- **Package command**: Now routes through platform adaptors
|
||||||
|
- **Upload command**: Now supports all 3 upload platforms
|
||||||
|
- **Enhancement command**: Now supports platform-specific models
|
||||||
|
- **Unified workflow**: All commands respect `--target` parameter
|
||||||
|
|
||||||
|
#### MCP Architecture
|
||||||
|
- **Tool modularity**: Cleaner separation with adaptor pattern
|
||||||
|
- **Error handling**: Platform-specific error messages
|
||||||
|
- **API key validation**: Per-platform validation logic
|
||||||
|
- **TextContent fallback**: Graceful degradation when MCP not installed
|
||||||
|
|
||||||
|
#### Documentation
|
||||||
|
- All platform documentation updated for multi-LLM support
|
||||||
|
- Consistent terminology across all docs
|
||||||
|
- Platform comparison tables added
|
||||||
|
- Examples updated to show all platforms
|
||||||
|
|
||||||
|
### Fixed
|
||||||
|
|
||||||
|
- **TextContent import error** in test environment (5 MCP tool files)
|
||||||
|
- Added fallback TextContent class when MCP not installed
|
||||||
|
- Prevents `TypeError: 'NoneType' object is not callable`
|
||||||
|
- Ensures tests pass without MCP library
|
||||||
|
|
||||||
|
- **UTF-8 encoding** issues on Windows (continued from v2.4.0)
|
||||||
|
- All file operations use explicit UTF-8 encoding
|
||||||
|
- CHANGELOG encoding handling improved
|
||||||
|
|
||||||
|
- **API key environment variables** - Clear documentation for all platforms
|
||||||
|
- ANTHROPIC_API_KEY for Claude
|
||||||
|
- GOOGLE_API_KEY for Gemini
|
||||||
|
- OPENAI_API_KEY for OpenAI
|
||||||
|
|
||||||
|
### Other Improvements
|
||||||
|
|
||||||
|
#### Smart Description Generation
|
||||||
|
- Automatically generates skill descriptions from documentation
|
||||||
|
- Analyzes reference files to suggest "When to Use" triggers
|
||||||
|
- Improves SKILL.md quality without manual editing
|
||||||
|
|
||||||
|
#### Smart Summarization
|
||||||
|
- Large skills (500+ lines) automatically summarized
|
||||||
|
- Preserves key examples and patterns
|
||||||
|
- Maintains quality while reducing token usage
|
||||||
|
|
||||||
|
### Deprecation Notice
|
||||||
|
|
||||||
|
None - All changes are backward compatible. Existing v2.4.0 workflows continue to work with default `target='claude'`.
|
||||||
|
|
||||||
|
### Migration Guide
|
||||||
|
|
||||||
|
**For users upgrading from v2.4.0:**
|
||||||
|
|
||||||
|
1. **No changes required** - Default behavior unchanged (targets Claude AI)
|
||||||
|
|
||||||
|
2. **To use other platforms:**
|
||||||
|
```bash
|
||||||
|
# Install platform dependencies
|
||||||
|
pip install skill-seekers[gemini] # For Gemini
|
||||||
|
pip install skill-seekers[openai] # For OpenAI
|
||||||
|
pip install skill-seekers[all-llms] # For all platforms
|
||||||
|
|
||||||
|
# Set API keys
|
||||||
|
export GOOGLE_API_KEY=AIzaSy... # For Gemini
|
||||||
|
export OPENAI_API_KEY=sk-proj-... # For OpenAI
|
||||||
|
|
||||||
|
# Use --target flag
|
||||||
|
skill-seekers package output/react/ --target gemini
|
||||||
|
skill-seekers upload react-gemini.tar.gz --target gemini
|
||||||
|
```
|
||||||
|
|
||||||
|
3. **MCP users** - New tools available:
|
||||||
|
- `enhance_skill` - Standalone enhancement (was only in install_skill)
|
||||||
|
- All packaging tools now accept `target` parameter
|
||||||
|
|
||||||
|
**See full documentation:**
|
||||||
|
- [Multi-Platform Guide](docs/UPLOAD_GUIDE.md)
|
||||||
|
- [Feature Matrix](docs/FEATURE_MATRIX.md)
|
||||||
|
- [Enhancement Guide](docs/ENHANCEMENT.md)
|
||||||
|
|
||||||
|
### Contributors
|
||||||
|
|
||||||
|
- @yusufkaraaslan - Multi-platform architecture, all platform adaptors, comprehensive testing
|
||||||
|
|
||||||
|
### Stats
|
||||||
|
|
||||||
|
- **16 commits** since v2.4.0
|
||||||
|
- **700 tests** (up from 427, +273 new tests)
|
||||||
|
- **4 platforms** supported (was 1)
|
||||||
|
- **18 MCP tools** (up from 17)
|
||||||
|
- **5 documentation guides** updated/created
|
||||||
|
- **29 files changed**, 6,349 insertions(+), 253 deletions(-)
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
## [2.4.0] - 2025-12-25
|
## [2.4.0] - 2025-12-25
|
||||||
|
|
||||||
### 🚀 MCP 2025 Upgrade - Multi-Agent Support & HTTP Transport
|
### 🚀 MCP 2025 Upgrade - Multi-Agent Support & HTTP Transport
|
||||||
|
|||||||
@@ -2,11 +2,11 @@
|
|||||||
|
|
||||||
# Skill Seeker
|
# Skill Seeker
|
||||||
|
|
||||||
[](https://github.com/yusufkaraaslan/Skill_Seekers/releases/tag/v2.4.0)
|
[](https://github.com/yusufkaraaslan/Skill_Seekers/releases/tag/v2.5.0)
|
||||||
[](https://opensource.org/licenses/MIT)
|
[](https://opensource.org/licenses/MIT)
|
||||||
[](https://www.python.org/downloads/)
|
[](https://www.python.org/downloads/)
|
||||||
[](https://modelcontextprotocol.io)
|
[](https://modelcontextprotocol.io)
|
||||||
[](tests/)
|
[](tests/)
|
||||||
[](https://github.com/users/yusufkaraaslan/projects/2)
|
[](https://github.com/users/yusufkaraaslan/projects/2)
|
||||||
[](https://pypi.org/project/skill-seekers/)
|
[](https://pypi.org/project/skill-seekers/)
|
||||||
[](https://pypi.org/project/skill-seekers/)
|
[](https://pypi.org/project/skill-seekers/)
|
||||||
|
|||||||
@@ -2,6 +2,21 @@
|
|||||||
|
|
||||||
This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
|
This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
|
||||||
|
|
||||||
|
## 🎯 Current Status (December 28, 2025)
|
||||||
|
|
||||||
|
**Version:** v2.5.0 (Production Ready - Multi-Platform Feature Parity!)
|
||||||
|
**Active Development:** Multi-platform support complete
|
||||||
|
|
||||||
|
### Recent Updates (December 2025):
|
||||||
|
|
||||||
|
**🎉 MAJOR RELEASE: Multi-Platform Feature Parity! (v2.5.0)**
|
||||||
|
- **🌐 Multi-LLM Support**: Full support for 4 platforms - Claude AI, Google Gemini, OpenAI ChatGPT, Generic Markdown
|
||||||
|
- **🔄 Complete Feature Parity**: All skill modes work with all platforms
|
||||||
|
- **🏗️ Platform Adaptors**: Clean architecture with platform-specific implementations
|
||||||
|
- **✨ 18 MCP Tools**: Enhanced with multi-platform support (package, upload, enhance)
|
||||||
|
- **📚 Comprehensive Documentation**: Complete guides for all platforms
|
||||||
|
- **🧪 Test Coverage**: 700 tests passing, extensive platform compatibility testing
|
||||||
|
|
||||||
## Overview
|
## Overview
|
||||||
|
|
||||||
This is a Python-based documentation scraper that converts ANY documentation website into a Claude skill. It's a single-file tool (`doc_scraper.py`) that scrapes documentation, extracts code patterns, detects programming languages, and generates structured skill files ready for use with Claude.
|
This is a Python-based documentation scraper that converts ANY documentation website into a Claude skill. It's a single-file tool (`doc_scraper.py`) that scrapes documentation, extracts code patterns, detects programming languages, and generates structured skill files ready for use with Claude.
|
||||||
@@ -94,11 +109,47 @@ The LOCAL enhancement option (`--enhance-local` or `enhance_skill_local.py`) ope
|
|||||||
"Package skill at output/react/"
|
"Package skill at output/react/"
|
||||||
```
|
```
|
||||||
|
|
||||||
9 MCP tools available: list_configs, generate_config, validate_config, estimate_pages, scrape_docs, package_skill, upload_skill, split_config, generate_router
|
18 MCP tools available with multi-platform support: list_configs, generate_config, validate_config, fetch_config, estimate_pages, scrape_docs, scrape_github, scrape_pdf, package_skill, upload_skill, enhance_skill (NEW), install_skill, split_config, generate_router, add_config_source, list_config_sources, remove_config_source, submit_config
|
||||||
|
|
||||||
### Test with limited pages (edit config first)
|
### Test with limited pages (edit config first)
|
||||||
Set `"max_pages": 20` in the config file to test with fewer pages.
|
Set `"max_pages": 20` in the config file to test with fewer pages.
|
||||||
|
|
||||||
|
## Multi-Platform Support (v2.5.0+)
|
||||||
|
|
||||||
|
**4 Platforms Fully Supported:**
|
||||||
|
- **Claude AI** (default) - ZIP format, Skills API, MCP integration
|
||||||
|
- **Google Gemini** - tar.gz format, Files API, 1M token context
|
||||||
|
- **OpenAI ChatGPT** - ZIP format, Assistants API, Vector Store
|
||||||
|
- **Generic Markdown** - ZIP format, universal compatibility
|
||||||
|
|
||||||
|
**All skill modes work with all platforms:**
|
||||||
|
- Documentation scraping
|
||||||
|
- GitHub repository analysis
|
||||||
|
- PDF extraction
|
||||||
|
- Unified multi-source
|
||||||
|
- Local repository analysis
|
||||||
|
|
||||||
|
**Use the `--target` parameter for packaging, upload, and enhancement:**
|
||||||
|
```bash
|
||||||
|
# Package for different platforms
|
||||||
|
skill-seekers package output/react/ --target claude # Default
|
||||||
|
skill-seekers package output/react/ --target gemini
|
||||||
|
skill-seekers package output/react/ --target openai
|
||||||
|
skill-seekers package output/react/ --target markdown
|
||||||
|
|
||||||
|
# Upload to platforms (requires API keys)
|
||||||
|
skill-seekers upload output/react.zip --target claude
|
||||||
|
skill-seekers upload output/react-gemini.tar.gz --target gemini
|
||||||
|
skill-seekers upload output/react-openai.zip --target openai
|
||||||
|
|
||||||
|
# Enhance with platform-specific AI
|
||||||
|
skill-seekers enhance output/react/ --target claude # Sonnet 4
|
||||||
|
skill-seekers enhance output/react/ --target gemini --mode api # Gemini 2.0
|
||||||
|
skill-seekers enhance output/react/ --target openai --mode api # GPT-4o
|
||||||
|
```
|
||||||
|
|
||||||
|
See [Multi-Platform Guide](UPLOAD_GUIDE.md) and [Feature Matrix](FEATURE_MATRIX.md) for complete details.
|
||||||
|
|
||||||
## Architecture
|
## Architecture
|
||||||
|
|
||||||
### Single-File Design
|
### Single-File Design
|
||||||
|
|||||||
@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
|
|||||||
|
|
||||||
[project]
|
[project]
|
||||||
name = "skill-seekers"
|
name = "skill-seekers"
|
||||||
version = "2.4.0"
|
version = "2.5.0"
|
||||||
description = "Convert documentation websites, GitHub repositories, and PDFs into Claude AI skills"
|
description = "Convert documentation websites, GitHub repositories, and PDFs into Claude AI skills"
|
||||||
readme = "README.md"
|
readme = "README.md"
|
||||||
requires-python = ">=3.10"
|
requires-python = ">=3.10"
|
||||||
|
|||||||
Reference in New Issue
Block a user