Skill Updater

Local-modification-preserving clawhub skill updater. Saves changes as diff patch, applies to new versions, reports conflicts clearly. No forced overwrites.

Local-modification-preserving clawhub skill updater.

What It Does

You modified a clawhub-installed skill → clawhub released a new version → Skill-Updater updates while preserving your local changes.

How It Works

text

Step 1: Save modifications
  → Scans skill directory, generates unified diff patch
  → Backs up originals to .skill-updater/originals/

Step 2: clawhub update
  → clawhub update downloads new version files

Step 3: Try to merge
  → patch --dry-run attempts to apply changes to new version
  → Success: written with your changes preserved ✅
  → Fail: show diff, user decides manually

File Structure

text

skill-dir/
├── .skill-updater/
│   ├── mod.patch       # unified diff of your changes
│   └── originals/       # snapshot of original files at install time
└── [skill files]

CLI

bash

# Dry-run: preview which skills have updates and conflicts
python3 git_update.py

# Apply updates
python3 git_update.py --apply

# Update specific skill
python3 git_update.py --apply --skill <slug>

# Show saved modifications
python3 git_update.py --show-patch

# Discard modifications (accept new version, drop your changes)
python3 git_update.py --discard --skill <slug>

Conflict Handling

Situation	Result
Patch applies cleanly	New version + your changes preserved ✅
Same area modified by both	Show diff, user decides
No local modifications	Direct clawhub update ✅
Choose to discard	Delete patch, accept new version

Requirements

• Python 3.8+
• clawhub CLI
• diff (coreutils)
• patch (coreutils)

Before Installing

1. Dry-run first — Always run python3 git_update.py without --apply first to preview
2. Backup — For important skills, manually back up your modifications before using --discard