From 04bb770133e6586df88a65354f45adf52ca42b5d Mon Sep 17 00:00:00 2001 From: Joe Rogero Date: Mon, 16 Feb 2026 12:50:38 -0500 Subject: [PATCH] Add common pitfall to SKILL.md Explicitly mentioning the DVR buffer limit in Pitfalls, so Claude knows to warn the user if it gets this error. --- video-tools/skills/youtube-live-segment/SKILL.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/video-tools/skills/youtube-live-segment/SKILL.md b/video-tools/skills/youtube-live-segment/SKILL.md index c2de531..79898c6 100644 --- a/video-tools/skills/youtube-live-segment/SKILL.md +++ b/video-tools/skills/youtube-live-segment/SKILL.md @@ -145,6 +145,8 @@ For other time zones, ask the user or look up the offset. - **DASH formats cannot be partially downloaded.** Always use HLS (m3u8) formats for this technique. - **yt-dlp `--download-sections` does not work** on live streams with DASH formats. Do not retry it. +- **DVR buffers are typically only 4-6 hours deep.** If the user requests a time outside the buffer, the segments won't exist. There is no + workaround — once content rolls out of the DVR buffer, it's gone from YouTube's servers. - **Segment numbers shift** as the DVR buffer rolls forward on 24/7 streams. Run the script close to when the user requests the clip, not hours later. - **Buffer generously.** The script adds 60 seconds of padding by default. Use `--buffer` to increase if needed. Trimming after download is cheap.