From 1cec9bc390503cd0af47787adbefe6c879e4521e Mon Sep 17 00:00:00 2001 From: alexion Date: Thu, 27 Aug 2026 19:28:44 -0400 Subject: [PATCH] Document YouTube transcript limits --- skills/ingest-youtube-transcript/SKILL.md | 16 ++++++++++++---- 1 file changed, 12 insertions(+), 4 deletions(-) diff --git a/skills/ingest-youtube-transcript/SKILL.md b/skills/ingest-youtube-transcript/SKILL.md index d5fefa4..d53b2e0 100644 --- a/skills/ingest-youtube-transcript/SKILL.md +++ b/skills/ingest-youtube-transcript/SKILL.md @@ -30,10 +30,18 @@ The command exits non-zero on failure and writes the error to stderr. 1. Run the `fetch_transcript` wrapper provided by this skill for the YouTube URL. 2. Read the returned `title` and `transcript`. 3. Build source understanding from the transcript. -4. Respond to the user's request in chat by default. -5. Create durable output when requested or when active project conventions require it. -6. State the output path when you create durable output. -7. State the scratch location when you create temporary scratch files. +4. Notice when the transcript points to important visible material that transcript text cannot recover. +5. Respond to the user's request in chat by default. +6. Create durable output when requested or when active project conventions require it. +7. State the output path when you create durable output. +8. State the scratch location when you create temporary scratch files. + +## Transcript-only limits + +This skill ingests captions, not the video stream. +It cannot recover on-screen text, diagrams, UI state, slides, prompts, file trees, terminal output, images, or gestures unless they are described in the transcript. +If the transcript refers to visible material that may matter, mention the limitation in the response or source note. +Examples include `as you can see`, `shown here`, `this file`, `this prompt`, `this format`, `on screen`, `look at`, or visible demos of interfaces and documents. ## Durable output