Communitygithub.com

bounce12340/josh-video-skills

When receiving "make a video / Reel": first determine the video type, route to the appropriate video skill, apply shared house rules, and hand off to the fact-checking editor. Only produces drafts; does not publish.

What is josh-video-skills?

This agent skill, `bounce12340/josh-video-skills`, acts as a video router for Josh's media team, designed to handle requests to create videos or Reels. Its primary function is to classify the incoming video request into a specific type (e.g., interview reel, stock footage reel, artistic motion, product promo) using a decision table, then delegate the actual production to the corresponding specialized skill. Before routing, it enforces a set of shared house rules, including using Traditional Chinese (Taiwan), specific voice guidelines, BGM rules, and formatting constraints (1080x1920 vertical, under 3 minutes, under 45 MB for IG). The skill strictly produces only drafts—it does not publish or post anything. After draft production, it automatically notifies the fact-checking editor to review the materials (script, storyboard, captions, facts), and only reports back to the main bot once the review is complete, providing file paths, duration, size, full script, and any unverifiable facts. This skill is essential for maintaining consistency and quality across all video outputs while leveraging specialized tools for each type of content.

Works with~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/bounce12340/josh-video-skills/tree/HEAD/josh-video-router

Ask in your favorite AI

Open a new chat with this agent skill pre-loaded.

Documentation

josh-video-router: Josh Video Router

Only creates drafts; does not publish. Publishing is always handled by the main bot after Josh confirms. For a full breakdown and reasoning, see <SKILLS_DIR>/ROUTER-PLAN.md.

Step 0: Read the House Rules First

  • Tone and wording: <YOUR_WORKSPACE>/media-team/00-profile/voice.md
  • Animation rules: <YOUR_WORKSPACE>/media-team/00-profile/motion-contract.md
  • Cover images: <YOUR_WORKSPACE>/media-team/covers/README.md

Step 1: Determine the Type (Decision Table)

QuestionYes → Use
Contains a celebrity interview or original speech footage?interview-reel
Voiceover + real news/footage?stock-footage-reel
Thematic montage without narration?OpenMontage documentary-montage (read openmontage-house)
Need to record a webpage or tool operation?screen-record (raw footage) → then stock-footage-reel or OpenMontage screen-demo
Knowledge explainer, Vox style, art style, whiteboard, hand-drawn?huashu-art-motion; only if a style it lacks is needed, use lemo-opuscar; for third-party previews use xilo-opus-video
Price, benchmarks, KPI comparison?huashu templates/data_card_render.py
Product promotion?video-shotcraft (must re-edit to vertical)
Cut long video into shorts, translate/dub, podcast?OpenMontage (read openmontage-house)
None of the above?Stop and ask the main bot; do not pick a skill yourself

Do not use: vox-director, book-sales-video, simon-skills, director output, hbg-classical-poem, kid-papercraft, anything2explainer, or official full-length videos from video-talkcraft (reasoning in ROUTER-PLAN.md).

Step 2: Apply Shared House Rules (Mandatory for Every Video)

  • Use Traditional Chinese (Taiwan) and Taiwanese vocabulary; use "" instead of em-dashes (—).
  • Voiceover: For Chinese, use your own ElevenLabs voice <YOUR_ELEVENLABS_VOICE_ID>; for English, use Sarah Explains. Natural speed, no speed-up. First use estimate_only to check credits.
  • Voiceover follows the subtitles exactly: the finalized subtitle file is the sole source; on-screen subtitles are chunked from the same file.
  • News videos report only the news, without Josh's first-person perspective, unless he requests it.
  • BGM: include whenever possible; if included, mark the track name, source, and license in facts.md; otherwise, do not block delivery.
  • No brand logos on screen; footage must match the real context of the corresponding sentence.
  • Vertical 1080x1920, under 3 minutes; for IG version, use video-pipeline/reel.sh ig to compress to under 45 MB.
  • For videos based on YouTube content, include the original link in all posts and credit the original creator.
  • Do not use paid services or add new API keys; if needed, stop and ask Josh.
  • VoiceStudio rules: do not upload user recordings; do not replicate voices without the person's consent.
  • Do not use Chinese services (Doubao, Volcano Engine, Feishu, WeChat Read, Jimeng, LibTV).

Step 3: Final Touches

  1. reel.sh mix (if BGM is present) → reel.sh qa → reel.sh ig
  2. Deliver script.txt, storyboard.md, ig_caption.txt, threads.txt, facts.md to <YOUR_WORKSPACE>/media-team/03-drafts/<topic>/

Step 4: Hand Off to Fact-Checking Editor

  • Notify the fact-checking editor to review 03-drafts/<topic>/; the report is written in 04-review/<draft-name>-review.md.
  • After approval, report back to the main bot: file path, duration, file size, full script, and any unverifiable facts.

Individual skills in this repo

This repo contains 4 individual skills — each has its own dedicated page.

bounce12340/josh-video-skills

「名人訪談/演講片段」直式 Reel(Fox Hsiao 式「解說穿插原聲」):配音依語言選聲(中文用「<YOUR_VOICE_NAME>」<YOUR_ELEVENLABS_VOICE_ID>;英文用 Sarah Explains)+繁中主字幕的解說段落,中間穿插 15 到 30 秒的名人原聲片段(16:9 置中、上下模糊底、「原聲 姓名|場合|日期」出處標籤、左上「影片/原頻道」),結尾拋問題給觀眾。一份 JSON spec 一路做到成片、720p 預覽、聯絡表、credits.json、封面。觸發語:「名人訪談」、「演講片段」、「訪談 Reel」、「Fox 式」、「解說加原聲」、「interview reel」。

bounce12340/josh-video-skills

用 OpenMontage(開源 AI 影片製作流水線,<SKILLS_DIR>/OpenMontage)做 Josh 的影片時的「本家規則」轉接層。適用:長片剪成多支短片(clip-factory)、真實螢幕錄製教學(screen-demo)、翻譯配音(localization-dub)、Podcast 轉影片(podcast-repurpose)、「照這支參考影片做」(reference video 分析)、無旁白紀錄片蒙太奇(documentary-montage),以及幫 stock-footage-reel 加抓 NASA/國會圖書館/NARA/Archive.org 老片。觸發語:「用 OpenMontage」、「長片切短片」、「照這支 Reel 做」、「翻譯配音」、「螢幕教學影片」。

bounce12340/josh-video-skills

用 Playwright 錄「公開網頁」的操作畫面(捲動、滑過、點連結、高亮重點、章節卡),輸出 1080x1920 直式 mp4,當 Reel 的工具/網站導覽素材。觸發語:「錄一段網頁操作」「網站導覽素材」「螢幕錄影素材」「screen record」。只錄公開頁面,不登入、不發文。

bounce12340/josh-video-skills

「真實素材剪輯」直式短影音(AYi @ayi_ainotes 那種紀錄片風):照口播稿每一句,自動搜尋並下載免費可商用素材(Pexels、Mixkit Free、Wikimedia Commons),加上洋紅調的 1950 到 70 年代 Prelinger 公有領域老片,硬切剪輯,燒上雙語字幕(繁中+英文,重點字金色),左上固定標題,ElevenLabs 配音,暗色合成器配樂,片尾金句卡加出處小字,再用 B 剪報 Vox 樣板出封面。觸發語:「做一支真實素材剪輯」、「stock footage reel」、「AYi 風格」、「素材庫剪輯」。

Related Skills