Skip to content

Expose storyboard primitive and move watch workflow into skill - #10

Merged
devhims merged 2 commits into
mainfrom
feat/storyboard-primitive
Aug 18, 2026
Merged

Expose storyboard primitive and move watch workflow into skill#10
devhims merged 2 commits into
mainfrom
feat/storyboard-primitive

Conversation

@devhims

@devhims devhims commented Aug 18, 2026

Copy link
Copy Markdown
Owner

Summary

  • expose getStoryboard() as a primitive from the main all-things-youtube entry point
  • add a private packages/youtube-skills module that owns both direct-skill sources, tests, and deterministic bundling
  • move watch-index composition, media resolution, retry transport, range proxying, and FFmpeg frame extraction into the bundled youtube-watch skill
  • remove the public all-things-youtube/watch subpath and prepare the package as 0.4.0
  • mark the committed skill executables as generated for GitHub Linguist without changing their tracked paths or runtime behavior
  • update package and repository documentation for the new interface

Why

The npm package is intended to expose reusable YouTube data primitives such as transcripts and storyboards. Building an agent-oriented evidence index and choosing a particular FFmpeg extraction strategy are opinionated workflow decisions, so they now belong to the youtube-watch skill. Their source lives in a separate private package and consumes all-things-youtube only through its public interface. The skills remain self-contained while the public package presents a smaller, resource-oriented interface.

Impact

This removes the previously published all-things-youtube/watch subpath. Package consumers can use getStoryboard() alongside getTranscript() and compose their preferred visual workflow. The youtube-watch skill retains the existing two-pass storyboard, transcript, and exact-frame experience.

Verification

  • 19 library and 25 private skill unit tests passed
  • TypeScript typecheck and package build passed
  • FFmpeg range-proxy integration passed
  • live package storyboard test passed
  • live youtube-watch index and three-frame extraction passed
  • deterministic skill bundle check and CLI help smoke test passed
  • isolated 0.4.0 tarball install confirmed getStoryboard() is exported and /watch is not exported

@vercel

vercel Bot commented Aug 18, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
video2ctx-web Ready Ready Preview Aug 18, 2026 10:08am

@mintlify

mintlify Bot commented Aug 18, 2026

Copy link
Copy Markdown

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated (UTC)
video2ctx 🟢 Ready View Preview Aug 18, 2026, 10:09 AM

💡 Tip: Enable Workflows to automatically generate PRs for you.

@devhims
devhims marked this pull request as ready for review August 18, 2026 10:39
@devhims
devhims merged commit 7322533 into main Aug 18, 2026
7 checks passed
@devhims
devhims deleted the feat/storyboard-primitive branch August 18, 2026 10:52
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant