video-editing 1.3.1

package/LICENSE

@@ -0,0 +1,29 @@
+ClipReady video-editing License
+
+Copyright (c) 2026 Itay Elgazar. All rights reserved.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software, the accompanying skill files, and associated documentation
+(the "Software"), to install and use the Software, including for commercial
+purposes, subject to the following conditions:
+
+1. No redistribution. You may not publish, sublicense, sell, rent, lease, or
+   otherwise distribute the Software or any portion of it, except that
+   installing the Software through official distribution channels (npm, the
+   official GitHub repository) is permitted.
+
+2. No modification or derivative works. You may not modify, adapt, translate,
+   or create derivative works based on the Software, and you may not reverse
+   engineer, decompile, or disassemble it except to the extent permitted by
+   applicable law.
+
+3. Notices. You may not remove or alter any copyright, license, or attribution
+   notices contained in the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHOR OR COPYRIGHT HOLDER BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,83 @@
+# video-editing
+
+Standalone CLI for turning a raw talking-head recording into a tight, clean
+vertical (9:16) cut. It transcribes the clip, screens it for retakes, lets you
+author an EDL (the cut), renders a preview/final, and **content-verifies** the
+result by re-transcribing every join to catch retakes left in.
+
+You decide the cut (which takes to keep); the CLI does all the execution
+(probe, transcribe, screen, render, QC). No `video-use` repo or other tools needed.
+
+## Requirements
+
+- **Node ≥ 20**
+- **ffmpeg** and **ffprobe** on your PATH (`brew install ffmpeg`)
+- An **ElevenLabs API key** (for transcription)
+
+## Install
+
+```bash
+npm install -g video-editing            # or: pnpm add -g video-editing
+video-editing --help
+```
+
+The companion agent skill:
+
+```bash
+npx skills add ItayElgazar/clipready --skill video-editing
+```
+
+Set your ElevenLabs key once (stored in `~/.config/video-editing/.env`):
+
+```bash
+video-editing config set-key sk_your_key_here
+# or export ELEVENLABS_API_KEY=sk_... in your shell
+```
+
+## Workflow
+
+```bash
+# 1. create a job (probes the clip; prints the job dir)
+video-editing init-job --source "/path/to/clip.mp4"     # → ~/Downloads/edit/job_clip
+
+# 2. transcribe + screen (writes flags.txt, takes_packed.md, word_dump.txt, coverage.json)
+video-editing transcribe --job-dir ~/Downloads/edit/job_clip
+
+# 3. SCREEN: read flags.txt (retakes hide in over-long tokens & repeated phrases),
+#    then author <job>/edl.json — KEEP-range segments in source seconds.
+#    (`video-editing cut-bad-retakes --job-dir <job>` scaffolds an authoring prompt.)
+
+# 4. render the preview (vertical 1080x1920, loudness-normalized)
+video-editing render --job-dir ~/Downloads/edit/job_clip --mode preview
+
+# 5. CONTENT-VERIFY: re-transcribes joins, flags duplicated phrases (retake left in) + dead air
+video-editing verify --job-dir ~/Downloads/edit/job_clip            # add --full for whole-preview
+
+# 6. fix edl.json as needed, re-render, re-verify, then:
+video-editing render --job-dir ~/Downloads/edit/job_clip --mode final
+```
+
+## EDL format
+
+`<job>/edl.json` — KEEP segments in **source** seconds; the gaps between them are the cuts:
+
+```json
+{
+  "version": 1,
+  "sources": {"SRC": "<job>/vertical_src.mp4"},
+  "grade": "none",
+  "ranges": [
+    {"source": "SRC", "start": 11.35, "end": 14.12, "beat": "HOOK", "quote": "…", "reason": "…"}
+  ],
+  "overlays": [],
+  "total_duration_s": 0
+}
+```
+
+A retake range must **end at the last clean word before the abandoned attempt**.
+
+## Commands
+
+`init-job`, `transcribe`, `cut-silences`, `cut-bad-retakes`, `render` (`--mode preview|draft|final`),
+`verify` (`--full`, `--window`, `--gap`), `inspect`/`timeline` (`--join <i>` or `--start/--end`),
+`status`, `review`, `config`. Run `video-editing <cmd> --help` for flags.