docs: Update all documentation for multi-platform feature parity

Complete documentation update to reflect multi-platform support across
all 4 platforms (Claude, Gemini, OpenAI, Markdown).

Changes:
- src/skill_seekers/mcp/README.md:
  * Fixed tool count (10 → 18 tools)
  * Added enhance_skill tool documentation
  * Updated package_skill docs with target parameter
  * Updated upload_skill docs with target parameter
  * Updated tool numbering after adding enhance_skill

- docs/MCP_SETUP.md:
  * Updated packaging tools section (3 → 4 tools)
  * Added enhance_skill to tool lists
  * Added Example 4: Multi-Platform Support
  * Shows target parameter usage for all platforms

- docs/ENHANCEMENT.md:
  * Added comprehensive Multi-Platform Enhancement section
  * Documented Claude (local + API modes)
  * Documented Gemini (API mode, model, format)
  * Documented OpenAI (API mode, model, format)
  * Added platform comparison table
  * Updated See Also links

- docs/UPLOAD_GUIDE.md:
  * Complete rewrite for multi-platform support
  * Detailed guides for all 4 platforms
  * Claude AI: API + manual upload methods
  * Google Gemini: tar.gz format, Files API
  * OpenAI ChatGPT: Vector Store, Assistants API
  * Generic Markdown: Universal export, manual distribution
  * Added platform comparison tables
  * Added troubleshooting for all platforms

All docs now accurately reflect the feature parity implementation.
Users can now find complete information about packaging, uploading,
and enhancing skills for any platform.

Related: Feature parity implementation (commits 891ce2d, 2ec2840)
This commit is contained in:
yusyus
2025-12-28 21:55:07 +03:00
parent 2ec2840396
commit 9806b62a9b
4 changed files with 566 additions and 314 deletions

View File

@@ -73,7 +73,7 @@ You should see a list of preset configurations (Godot, React, Vue, etc.).
## Available Tools
The MCP server exposes 10 tools:
The MCP server exposes 18 tools:
### 1. `generate_config`
Create a new configuration file for any documentation website.
@@ -117,29 +117,66 @@ Scrape docs using configs/react.json
```
### 4. `package_skill`
Package a skill directory into a `.zip` file ready for Claude upload. Automatically uploads if ANTHROPIC_API_KEY is set.
Package skill directory into platform-specific format. Automatically uploads if platform API key is set.
**Parameters:**
- `skill_dir` (required): Path to skill directory (e.g., "output/react/")
- `target` (optional): Target platform - "claude", "gemini", "openai", "markdown" (default: "claude")
- `auto_upload` (optional): Try to upload automatically if API key is available (default: true)
**Example:**
**Platform-specific outputs:**
- Claude/OpenAI/Markdown: `.zip` file
- Gemini: `.tar.gz` file
**Examples:**
```
Package skill at output/react/
Package skill for Claude (default): output/react/
Package skill for Gemini: output/react/ with target gemini
Package skill for OpenAI: output/react/ with target openai
Package skill for Markdown: output/react/ with target markdown
```
### 5. `upload_skill`
Upload a skill .zip file to Claude automatically (requires ANTHROPIC_API_KEY).
Upload skill package to target LLM platform (requires platform-specific API key).
**Parameters:**
- `skill_zip` (required): Path to skill .zip file (e.g., "output/react.zip")
- `skill_zip` (required): Path to skill package (`.zip` or `.tar.gz`)
- `target` (optional): Target platform - "claude", "gemini", "openai" (default: "claude")
**Example:**
**Examples:**
```
Upload output/react.zip using upload_skill
Upload to Claude: output/react.zip
Upload to Gemini: output/react-gemini.tar.gz with target gemini
Upload to OpenAI: output/react-openai.zip with target openai
```
### 6. `list_configs`
**Note:** Requires platform-specific API key (ANTHROPIC_API_KEY, GOOGLE_API_KEY, or OPENAI_API_KEY)
### 6. `enhance_skill`
Enhance SKILL.md with AI using target platform's model. Transforms basic templates into comprehensive guides.
**Parameters:**
- `skill_dir` (required): Path to skill directory (e.g., "output/react/")
- `target` (optional): Target platform - "claude", "gemini", "openai" (default: "claude")
- `mode` (optional): "local" (Claude Code Max, no API key) or "api" (requires API key) (default: "local")
- `api_key` (optional): Platform API key (uses env var if not provided)
**What it does:**
- Transforms basic SKILL.md templates into comprehensive 500+ line guides
- Uses platform-specific AI models (Claude Sonnet 4, Gemini 2.0 Flash, GPT-4o)
- Extracts best examples from references
- Adds platform-specific formatting
**Examples:**
```
Enhance with Claude locally (no API key): output/react/
Enhance with Gemini API: output/react/ with target gemini and mode api
Enhance with OpenAI API: output/react/ with target openai and mode api
```
**Note:** Local mode uses Claude Code Max (requires Claude Code but no API key). API mode requires platform-specific API key.
### 7. `list_configs`
List all available preset configurations.
**Parameters:** None
@@ -149,7 +186,7 @@ List all available preset configurations.
List all available configs
```
### 7. `validate_config`
### 8. `validate_config`
Validate a config file for errors.
**Parameters:**
@@ -160,7 +197,7 @@ Validate a config file for errors.
Validate configs/godot.json
```
### 8. `split_config`
### 9. `split_config`
Split large documentation config into multiple focused skills. For 10K+ page documentation.
**Parameters:**
@@ -180,7 +217,7 @@ Split configs/godot.json using router strategy with 5000 pages per skill
- **router** - Create router/hub skill + specialized sub-skills (RECOMMENDED for 10K+ pages)
- **size** - Split every N pages (for docs without clear categories)
### 9. `generate_router`
### 10. `generate_router`
Generate router/hub skill for split documentation. Creates intelligent routing to sub-skills.
**Parameters:**
@@ -198,7 +235,7 @@ Generate router for configs/godot-*.json
- Creates router SKILL.md with intelligent routing logic
- Users can ask questions naturally, router directs to appropriate sub-skill
### 10. `scrape_pdf`
### 11. `scrape_pdf`
Scrape PDF documentation and build Claude skill. Extracts text, code blocks, images, and tables from PDF files with advanced features.
**Parameters:**