README.md
Safe MCP Skill Version Manager - Detect updates, parallel testing, smart merge
Skill Vision Control (SVC)
Safe MCP Skill Version Manager - Detect updates, parallel testing, smart merge, confirm before replace
Features
- 🔍 Update Detection - Automatically detect new versions from GitHub/npm
- 🛡️ Security Scanning - Auto scan before download (Sentinel integration)
- 📦 Version Management - Keep multiple versions, switch anytime
- 🔀 Smart Merge - Merge official updates with your custom changes
- 🧪 A/B Testing - Test new versions before switching
- ⏰ Scheduled Checks - Automatic weekly/monthly update checks
- 🔔 Notifications - Desktop notifications for updates
- 🤖 MCP Server - Let AI manage your skills
Installation
npm install -g skill-vision-control
Or with yarn:
yarn global add skill-vision-control
Quick Start
# Add a skill to manage
svc add weather --source github:username/weather-mcp
# Check for updates
svc check
# Download new version (keeps old version)
svc download weather
# Test and switch
svc switch weather --version v1.1.0
# Or if you have custom changes, merge them
svc merge weather
Commands
Skill Management
| Command | Description |
|---|---|
svc add <name> --source <url> |
Register a skill (github:user/repo or npm:package) |
svc list |
List all managed skills |
svc info <name> |
Show detailed information |
svc remove <name> |
Remove a skill |
Version Control
| Command | Description |
|---|---|
svc check [name] |
Check for updates |
svc download <name> |
Download new version (keep old) |
svc versions <name> |
List all local versions |
svc switch <name> -v <version> |
Switch to specific version |
svc rollback <name> |
Rollback to previous version |
svc confirm <name> |
Confirm current version |
svc cleanup <name> --keep <n> |
Clean old versions |
Custom Modifications
| Command | Description |
|---|---|
svc fork <name> |
Create custom branch for modifications |
svc save <name> -c "comment" |
Save your modifications |
svc diff <name> |
View differences from official |
svc merge <name> |
Merge official update with your changes |
svc conflicts <name> |
View merge conflicts |
svc resolve <name> -f <file> -u <choice> |
Resolve conflicts |
Schedule
| Command | Description |
|---|---|
svc schedule set -i <days> |
Set check interval (1/7/14/30 days) |
svc schedule show |
Show current schedule |
svc schedule enable |
Enable scheduled checks |
svc schedule disable |
Disable scheduled checks |
svc schedule run |
Manually trigger check |
Security Scanning
| Command | Description |
|---|---|
svc scan |
Scan any skill directory for security issues |
svc audit [name] |
Audit installed skill(s) |
svc download <name> --skip-security |
Download without security scan (not recommended) |
Workflow Examples
Basic Update Flow
# 1. Check for updates
svc check
# Output: weather: v1.0.0 → v1.1.0 available
# 2. Download (old version preserved)
svc download weather
# 3. Test new version
svc switch weather -v v1.1.0 -t official
# 4. If good, confirm; if not, rollback
svc confirm weather
# or
svc rollback weather
Security Audit Before Install
# Scan a skill before installing
svc scan ~/Downloads/some-mcp-skill
# Output:
# 🛡️ Sentinel Security Scan Report
# ══════════════════════════════════════════════════
# Risk Level: MEDIUM
# Recommendation: REVIEW
#
# ⚠️ SUSPICIOUS: 3 items found
# - src/api.ts:15 - Network request (axios)
# - src/config.ts:8 - Environment variable access
# Audit all installed skills
svc audit
# Audit specific skill with details
svc audit weather -v
Custom Changes + Update
# 1. Create custom branch
svc fork weather
# 2. Make your modifications...
# 3. Save changes
svc save weather -c "Added Chinese language support"
# 4. Later, when update available
svc check
# Output: ⚠️ You have custom changes. Use "svc merge"
# 5. Download and merge
svc download weather
svc merge weather
# 6. If conflicts exist
svc conflicts weather
svc resolve weather -f src/config.ts -u custom
# 7. Test merged version
svc switch weather -v v1.1.0-merged -t merged
# 8. Confirm
svc confirm weather
Using as MCP Server
Add to your MCP configuration:
{
"mcpServers": {
"skill-vision-control": {
"command": "svc",
"args": ["serve"]
}
}
}
Available MCP tools:
svc_list_skills- List all managed skillssvc_get_skill_info- Get skill detailssvc_check_updates- Check for updatessvc_get_versions- Get local versionssvc_switch_version- Switch versi
Tools (5)
svc_list_skillsList all managed skillssvc_get_skill_infoGet skill detailssvc_check_updatesCheck for updatessvc_get_versionsGet local versionssvc_switch_versionSwitch versionConfiguration
claude_desktop_config.json
{
"mcpServers": {
"skill-vision-control": {
"command": "svc",
"args": ["serve"]
}
}
}Try it
→List all the MCP skills currently managed by SVC.
→Check if there are any updates available for my installed skills.
→Show me the detailed information and version history for the weather skill.
→Switch the weather skill to version v1.1.0 for testing.
→Get a list of all local versions available for the search-mcp skill.