feat(A1.7): Add install_skill MCP tool for one-command workflow automation
Implements complete end-to-end skill installation in a single command: fetch_config → scrape_docs → enhance_skill_local → package_skill → upload_skill Changes: - MCP Tool: Added install_skill_tool() to server.py (~300 lines) - Input validation (config_name XOR config_path) - 5-phase orchestration with error handling - Dry-run mode for workflow preview - Mandatory AI enhancement (30-60 sec, 3/10→9/10 quality boost) - Auto-upload to Claude (if ANTHROPIC_API_KEY set) - CLI Integration: New install command - Created install_skill.py CLI wrapper (~150 lines) - Updated main.py with install subcommand - Added entry point to pyproject.toml - Testing: Comprehensive test suite - Created test_install_skill.py with 13 tests - Tests cover validation, dry-run, orchestration, error handling - All tests passing (13/13) - Documentation: Updated all user-facing docs - CLAUDE.md: Added MCP tool (10 tools total) and CLI examples - README.md: Added prominent one-command workflow section - FLEXIBLE_ROADMAP.md: Marked A1.7 as complete Features: - Zero friction: One command instead of 5 separate steps - Quality guaranteed: Mandatory enhancement ensures 9/10 quality - Complete automation: From config to uploaded skill - Intelligent: Auto-detects config type (name vs path) - Flexible: Dry-run, unlimited, no-upload modes - Well-tested: 13 unit tests with mocking Usage: skill-seekers install --config react skill-seekers install --config configs/custom.json --no-upload skill-seekers install --config django --unlimited skill-seekers install --config react --dry-run Closes #204 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
This commit is contained in:
52
CLAUDE.md
52
CLAUDE.md
@@ -67,14 +67,15 @@ This file provides guidance to Claude Code (claude.ai/code) when working with co
|
||||
|
||||
## 🔌 MCP Integration Available
|
||||
|
||||
**This repository includes a fully tested MCP server with 9 tools:**
|
||||
**This repository includes a fully tested MCP server with 10 tools:**
|
||||
- `mcp__skill-seeker__list_configs` - List all available preset configurations
|
||||
- `mcp__skill-seeker__generate_config` - Generate a new config file for any docs site
|
||||
- `mcp__skill-seeker__validate_config` - Validate a config file structure
|
||||
- `mcp__skill-seeker__estimate_pages` - Estimate page count before scraping
|
||||
- `mcp__skill-seeker__scrape_docs` - Scrape and build a skill
|
||||
- `mcp__skill-seeker__package_skill` - Package skill into .zip file (with auto-upload)
|
||||
- `mcp__skill-seeker__upload_skill` - Upload .zip to Claude (NEW)
|
||||
- `mcp__skill-seeker__upload_skill` - Upload .zip to Claude
|
||||
- `mcp__skill-seeker__install_skill` - **NEW!** Complete one-command workflow (fetch → scrape → enhance → package → upload)
|
||||
- `mcp__skill-seeker__split_config` - Split large documentation configs
|
||||
- `mcp__skill-seeker__generate_router` - Generate router/hub skills
|
||||
|
||||
@@ -188,6 +189,53 @@ skill-seekers package output/godot/
|
||||
# Result: godot.zip ready to upload to Claude
|
||||
```
|
||||
|
||||
### **NEW!** One-Command Install Workflow (v2.1.1)
|
||||
|
||||
The fastest way to install a skill - complete automation from config to uploaded skill:
|
||||
|
||||
```bash
|
||||
# Install React skill from official configs (auto-uploads to Claude)
|
||||
skill-seekers install --config react
|
||||
# Time: 20-45 minutes total (scraping 20-40 min + enhancement 60 sec + upload 5 sec)
|
||||
|
||||
# Install from local config file
|
||||
skill-seekers install --config configs/custom.json
|
||||
|
||||
# Install without uploading (package only)
|
||||
skill-seekers install --config django --no-upload
|
||||
|
||||
# Unlimited scraping (no page limits - WARNING: can take hours)
|
||||
skill-seekers install --config godot --unlimited
|
||||
|
||||
# Preview workflow without executing
|
||||
skill-seekers install --config react --dry-run
|
||||
|
||||
# Custom output directory
|
||||
skill-seekers install --config vue --destination /tmp/skills
|
||||
```
|
||||
|
||||
**What it does automatically:**
|
||||
1. ✅ Fetches config from API (if config name provided)
|
||||
2. ✅ Scrapes documentation
|
||||
3. ✅ **AI Enhancement (MANDATORY)** - 30-60 sec, quality boost from 3/10 → 9/10
|
||||
4. ✅ Packages skill to .zip
|
||||
5. ✅ Uploads to Claude (if ANTHROPIC_API_KEY set)
|
||||
|
||||
**Why use this:**
|
||||
- **Zero friction** - One command instead of 5 separate steps
|
||||
- **Quality guaranteed** - Enhancement is mandatory, ensures professional output
|
||||
- **Complete automation** - From config name to uploaded skill
|
||||
- **Time savings** - Fully automated workflow
|
||||
|
||||
**Phases executed:**
|
||||
```
|
||||
📥 PHASE 1: Fetch Config (if config name provided)
|
||||
📖 PHASE 2: Scrape Documentation
|
||||
✨ PHASE 3: AI Enhancement (MANDATORY - no skip option)
|
||||
📦 PHASE 4: Package Skill
|
||||
☁️ PHASE 5: Upload to Claude (optional)
|
||||
```
|
||||
|
||||
### Interactive Mode
|
||||
|
||||
```bash
|
||||
|
||||
Reference in New Issue
Block a user