Add agent skill documentation section to README.md explaining SKILL.md file purpose, prerequisites coverage, safety rules, script catalog structure, and installation instructions for Devin and Claude Code agents, with repository location notes for both SVN and Git versions

Crop-Clips.md

@@ -0,0 +1,189 @@
+# Crop-Clips.ps1
+
+Batch crop videos generated by **LTX-2**, **Kling** and **Wan** to standard resolutions using ffmpeg.
+
+Every non-standard resolution these generators produce is recognised by a single lookup table in the script, so one command handles a folder containing clips from any of them. Resolutions are unique per generator, so there is no ambiguity. Any resolution not listed below is skipped without modification.
+
+Use `-Size` to ignore the table and convert every video to a specific resolution instead — see [Forcing a Size](#forcing-a-size).
+
+## Parameters
+
+- **`-Source`** (optional): Source directory containing video files (default: current directory)
+- **`-Target`** (optional): Target directory for cropped videos (default: current directory)
+- **`-Size`** (optional): Output video size. Possible values: `320p`, `384p`, `480p`, `720p`, `900p`, `1080p`, `HD`, `1440p`, `2K`, `2160p`, `4K`, or a custom `width:height`. When specified it **overrides the resolution table** and converts every video to that size — see [Forcing a Size](#forcing-a-size). Without it, the table below is used.
+
+## Supported Resolutions
+
+### LTX-2
+
+**Landscape:**
+
+- **3744x2112** → **3840x2160**: Scale up to 3840 width, then vertical center crop
+- **2496x1408** → **2560x1440**: Scale up to 2560 width, then vertical center crop
+- **2160x1216** → **1920x1080**: Scale down to 1920 width, then vertical center crop
+- **1920x1088** → **1920x1080**: Center crop (removes 4px from top and bottom)
+- **1920x1056** → **1920x1080**: Scale up to 1080 height, then horizontal center crop
+- **1872x1056** → **1920x1080**: Scale up to 1920 width, then vertical center crop
+- **1600x896** → **1600x900**: Scale to 900 height, then center crop
+- **1312x704** → **1280x720**: Scale up to 720 height, then horizontal center crop
+- **1280x704** → **1280x720**: Scale to 720 height, then center crop
+- **1248x704** → **1280x720**: Scale up to 1280 width, then vertical center crop
+- **832x448** → **854x480**: Scale to 480 height, then center crop
+- **640x384** → **684x384**: Scale to 684 width, then center crop
+- **576x320** → **570x320**: Center crop (removes 3px from left and right)
+
+**Portrait:**
+
+- **2112x3744** → **2160x3840**: Scale up to 3840 height, then horizontal center crop
+- **1408x2496** → **1440x2560**: Scale up to 2560 height, then horizontal center crop
+- **1216x2160** → **1080x1920**: Scale down to 1920 height, then horizontal center crop
+- **1088x1920** → **1080x1920**: Center crop (removes 4px from left and right)
+- **1056x1920** → **1080x1920**: Scale up to 1080 width, then vertical center crop
+- **1056x1872** → **1080x1920**: Scale up to 1920 height, then horizontal center crop
+- **896x1600** → **900x1600**: Scale to 900 width, then center crop
+- **704x1312** → **720x1280**: Scale up to 720 width, then vertical center crop
+- **704x1280** → **720x1280**: Scale to 720 width, then center crop
+- **704x1248** → **720x1280**: Scale up to 1280 height, then horizontal center crop
+- **448x832** → **480x854**: Scale to 480 width, then center crop
+- **384x640** → **384x684**: Scale to 684 height, then center crop
+- **320x576** → **320x570**: Center crop (removes 3px from top and bottom)
+
+### Kling
+
+- **1928x1072** → **1920x1080**: Scale to 1080 height, then center crop width to 1920
+- **1920x1076** → **1920x1080**: Scale to 1080 height, then center crop width to 1920
+- **1920x1072** → **1920x1080**: Scale to 1080 height, then center crop width to 1920
+- **1916x1080** → **1920x1080**: Already 1080 tall, so the 4 missing columns are padded (centered) instead of rescaling
+
+### Wan
+
+- **1928x1076** → **1920x1080**: Scale to 1080 height, then center crop width to 1920
+- **1926x1076** → **1920x1080**: Scale to 1080 height, then center crop width to 1920
+- **1284x716** → **1280x720**: Scale to 720 height, then center crop width to 1280
+
+### Square (1:1)
+
+- **NxN** → **1080x1080**: Any square resolution other than 1080x1080 is scaled up or down to 1080x1080 (no crop needed)
+
+## Forcing a Size
+
+`-Size` bypasses the resolution table entirely. Every video is **cover-scaled** (`force_original_aspect_ratio=increase`, which preserves the pixel aspect ratio and guarantees the frame is fully covered) and then **centre-cropped** to the exact requested size — the same approach as [Clone-Image.ps1](Clone-Image.md). Because the table is not consulted, resolutions that would normally be skipped are converted too.
+
+### Presets
+
+Named presets are the landscape targets this script already produces:
+
+| Preset | Size | Preset | Size |
+| --- | --- | --- | --- |
+| `320p` | 570x320 | `1080p` / `HD` | 1920x1080 |
+| `384p` | 684x384 | `1440p` / `2K` | 2560x1440 |
+| `480p` | 854x480 | `2160p` / `4K` | 3840x2160 |
+| `720p` | 1280x720 | | |
+| `900p` | 1600x900 | | |
+
+Preset names are case-insensitive (`-Size hd` works).
+
+### Portrait sources
+
+Presets are **transposed for portrait sources**, so a 9:16 clip stays 9:16 instead of losing most of the frame to a landscape crop:
+
+| Source | `-Size 1080p` | `-Size 720p` |
+| --- | --- | --- |
+| 1920x1088 (landscape) | 1920x1080 | 1280x720 |
+| 640x480 (landscape) | 1920x1080 | 1280x720 |
+| 512x512 (square) | 1920x1080 | 1280x720 |
+| 1080x1920 (portrait) | 1080x1920 *(already — skipped)* | 720x1280 |
+| 720x1280 (portrait) | 1080x1920 | 720x1280 *(already — skipped)* |
+
+A custom `width:height` is **always used exactly as given** (never transposed), so `-Size 1080:1920` forces portrait output for every video, landscape sources included. Odd custom dimensions are rounded up to the next even number, as `libx264`/`yuv420p` requires even sizes (`-Size 571:321` becomes 572x322).
+
+### Already-correct videos
+
+A video that is already exactly the requested size is left untouched — no re-encode, no generation loss:
+
+```text
+Skipping: 1920x1080.mp4 (already 1920x1080)
+```
+
+An invalid `-Size` value fails immediately, before any file is processed.
+
+## Behavior
+
+- Processes all `.mp4` files in source directory
+- Skips files ending with `.bak.mp4` or `.skip.mp4`
+- Automatically detects resolution and applies appropriate crop filter (or uses `-Size` when given)
+- Preserves original quality and audio
+- **In-place mode** (source and target are the same directory). This is the default when `-Source` and `-Target` are both omitted, because both default to the current directory:
+    - Each original `video.mp4` is copied to `video.bak.mp4`. An existing `.bak.mp4` is replaced.
+    - The cropped result is written to `video.crop.mp4`. Only after that succeeds is the original `video.mp4` deleted and replaced by the cropped file. The `.bak.mp4` backup is kept.
+    - Run with `-WhatIf` first, and do not run it on a folder you have not designated.
+- **Separate target folder**: the source files are not changed. A file with the same name already in the target folder is deleted and replaced.
+- If ffmpeg fails, the partial `.crop.mp4` file is deleted and the script stops with an error
+
+## Examples
+
+**Crop videos in current directory:**
+
+```powershell
+.\Crop-Clips.ps1
+```
+
+**Crop videos from specific source:**
+
+```powershell
+.\Crop-Clips.ps1 -Source "C:\Videos\Input"
+```
+
+**Crop to different target directory:**
+
+```powershell
+.\Crop-Clips.ps1 -Source "C:\Videos\Input" -Target "C:\Videos\Output"
+```
+
+**Force every video to 1080p (table ignored):**
+
+```powershell
+.\Crop-Clips.ps1 -Source "C:\Videos\Input" -Size 1080p
+# Landscape clips -> 1920x1080, portrait clips -> 1080x1920
+```
+
+**Force a small preset:**
+
+```powershell
+.\Crop-Clips.ps1 -Size 480p
+# Landscape clips -> 854x480, portrait clips -> 480x854
+```
+
+**Force a custom size (used verbatim, never transposed):**
+
+```powershell
+.\Crop-Clips.ps1 -Size "1080:1920"
+# Every video becomes 1080x1920, landscape sources included
+```
+
+**Skip specific files:**
+
+```powershell
+# Rename files to skip processing:
+# video.mp4 -> video.skip.mp4
+.\Crop-Clips.ps1
+```
+
+## Safe Execution
+
+This script supports `-WhatIf` and `-Confirm` for safe execution:
+
+- **`-WhatIf`**: Simulate the operation without actually modifying files. Shows what would be cropped.
+- **`-Confirm`**: Prompt for confirmation before processing each video file.
+
+**Simulate without making changes:**
+
+```powershell
+.\Crop-Clips.ps1 -Source "C:\Videos\Input" -Target "C:\Videos\Output" -WhatIf
+```
+
+**Prompt before each file:**
+
+```powershell
+.\Crop-Clips.ps1 -Source "C:\Videos\Input" -Confirm
+```