Communitygithub.com

CrissAlvarezH/video-script

根據創作者自己的影片分析數據,撰寫能留住觀眾的短影音腳本。

video-script 是什麼?

這是一個專為短影音創作者設計的 AI 技能,核心價值在於將影片成功與否的關鍵從「運氣」轉變為「可分析的數據決策」。它強調腳本的三個決定性元素:**利害關係**(為何圈外人會在乎)、**開場前兩句**(為何繼續觀看)、以及**證明**(讓觀眾信服的視覺證據)。此技能支援從構思鉤子、撰寫或潤飾腳本(適用於 talking-head 或旁白解說),再到分析已發布影片以提煉教訓的完整流程。它不僅產出腳本,還整合了嚴謹的檢查清單、基於時間線的結構建議(如 0-3 秒鉤子、3-10 秒第二句),以及對影片發布後數據的深度回顧機制,幫助創作者持續優化。支援平台包括 Claude Code、Cursor 等,透過讀取創作者個人設定檔和庫索引來提供個人化建議。

相容平台✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/CrissAlvarezH/ai-reel-gen-app/tree/HEAD/.claude/skills/video-script

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

影片腳本

一支短影音的好壞,很大程度上在拍攝前就已決定,取決於三個選擇:利害關係(除了圈內人,誰有理由在乎)、開場前兩句(為什麼要繼續看下去),以及證明(觀眾看到什麼讓說法顯得真實)。每個選擇都要依據證據:首先是創作者自己的過往影片,其次是平台方的說法,最後才是個人品味。

觀眾觀看是為了尋找一個問題的答案。好奇心讓他們留下,而每個答案都給他們一個離開的理由,因此腳本是在兩者之間取得平衡:儘早提出一個問題,並且在另一個問題準備好之前,不要關閉它。

設定

SKILL_DIR 指的是此技能所在的資料夾。如果 ~/.video-script/profile.md 檔案存在,請讀取它:這個檔案會說明創作者的影片庫、發現記錄檔、平台備註、語調和節奏。在提出任何建議之前,請先讀取發現記錄檔(包括仍在進行的測試)和庫索引,並引用與構想相似的過往影片。如果發現記錄檔的內容與下方的預設值衝突,以發現記錄檔為準:因為它們是針對這個觀眾群體實際測量出來的。

如果沒有個人設定檔,則詢問一次平台、觀眾群體,以及一支表現良好和一支表現不佳的過往影片及其數據。然後主動提議按照庫格式建立設定檔和影片庫。

目標 指的是一支影片的建構目的:觸及(非粉絲的觀看數)、追蹤數、收藏數或分享數。如果要求中沒有指明目標,則預設為觸及並告知對方。

這裡的任務是腳本和回顧已發布的影片;點子則歸 content-ideas 處理。此技能在產出腳本或課程後即告結束:拍攝是創作者的事,剪輯是 video-edit 的事,動畫是 animated-video 的事。

點子

想點子並儲存它們是 content-ideas 的職責。當一個腳本從某個點子開始時,它的筆記已經說明了鉤子、它所提出的問題、保留的內容以及證明:從這些內容開始,並在使用它們之前,對照來源進行檢查。

腳本

用一句話陳述點子,並說明其目標。一個需要兩句話才能說清楚的點子,就代表是兩支影片;詢問要先做哪一支。

在鉤子之前先找出回報點和最有力的證明,然後分兩部分撰寫鉤子:第一部分是用觀眾自己的話語,針對他們的問題,將主題表述為他們想要的結果;第二部分是你所擁有最令人驚訝的真實說法或證明,它會提出一個觀眾能用言語表達的問題。如果說出主題會回答那個問題,就不要指名道姓。以創作者的節奏(來自個人設定檔;預設每秒 3 個口語單詞)進行草稿。有三個時刻與時間緊密相關,它們之間的伸展段落遵循一個規則;其餘部分則讓故事自行發展:

  • 0–3 秒,鉤子:關於觀眾的利害關係或畫面上的內容。資歷背景稍後再放,作為相信的理由;當觀眾想要的結果能提出問題時,它就算是一種利害關係。
  • 3–10 秒,第二句:提高鉤子的利害關係或強化其問題,但不要回答它。最常見的可避免流失發生在這裡,所以背景資訊要往後放。背景資訊是指觀眾只需要為了理解後續某個細節才知道的任何事物(歷史、人物背景、運作原理);測試方式:如果將一句台詞移到 15 秒之後,而前 15 秒並無損失,那它就是背景資訊。
  • 中間段落,答案被保留:回報點不是單一瞬間。說出能關閉鉤子問題的那句台詞,通常是一個觀眾認得的術語:一旦他們聽到,就自認為知道了剩下的內容。在那之前,要鋪陳值得一聽的內容:大多數人搞錯的地方、他們付出的代價、為什麼顯而易見的替代方案行不通。當這句台詞最終說出時,同一口氣就要打開一個新問題,一個關於它、他們沒聽過的事。保留的意思是同時給他們別的東西;一句只有吊胃口或說「看到最後」的台詞不是保留,而是灌水。
  • 結尾:最終回報點,在畫面上展示鉤子的承諾,然後最多一個簡短的行動呼籲。回報點之後的任何內容,都是在對正在離開的觀眾播放。

對於解說片(解釋某事物如何運作),在草稿前請先閱讀解說片指南。

在每一句台詞旁邊,寫下觀眾會看到什麼,以及需要什麼樣的畫面素材(螢幕錄影、文件、真人或產品)。一句沒人能畫出台詞,就是觀眾得在腦中記住的台詞。對於動畫片,這一欄是給 animated-video 的備註,由其負責設計世界觀。

交付腳本,並依照個人設定檔的指示儲存:腳本包含時間、口語台詞和畫面相應內容;畫面素材清單;草稿標題(包含口語台詞無法承載的注意事項和連結,其開頭要提出鉤子的問題而非回答它);預估片長;備用鉤子(當開頭仍未確定時,每個鉤子附帶自己的第二句);以及需要核實的主張及其來源(標記任何你無法開啟的來源)。讓一個全新的代理根據腳本中的措辭,針對每個主張與其來源進行核對:正確的研究仍可能在腳本中被誇大。

當創作者改寫了某些台詞,將風格上的差異沿用到你仍擁有的台詞上。除非被要求編輯,否則保留他們的措辭,並另外指出其中事實上的問題。

檢查清單

在交付腳本之前,請根據以下項目、發現記錄檔和平台備註進行核對:

  • 單一主題。一個列表只有在每一項都能證明該主題時才有其存在價值。
  • 利害關係是以「受誰影響以及他們想要什麼」來界定,並使用非專家能懂的詞彙。工具名稱和行話要在觀眾有理由在乎之後才出現。
  • 從觀眾的角度閱讀:在每一行,問自己「我是否現在就覺得知道答案而想離開?」如果是,且還沒到預定時間,就移動那行台詞或在那裡打開下一個問題。說清楚什麼會關閉鉤子的問題以及何時關閉。
  • 每個主張都已被展示。語音、字幕和畫面提供相同的數字。
  • 鉤子中的每一個承諾都在畫面上得到兌現。
  • 每個句子,單獨閱讀時,都能說清楚「誰對什麼做了什麼」,以及任何結果的去向。用名詞取代省略的受詞和模糊的指涉;保留指涉明確的代名詞。修改會破壞這一點,所以每次修改後都要再檢查一次。
  • 台詞是完整、連貫的句子,使用創作者的語調(個人設定檔中指定的語調指南),容易大聲說出。一句過短到會引發問題(「完整路線」的什麼?)的台詞,其損失遠超過它省下的秒數。
  • 每一行台詞都要推動故事前進(重複前一句或預告接下來要說什麼的台詞則不是),並且在故事允許的範圍內,片長越短越好。

回顧已發布的影片

  • 記錄所有數據:觀看次數、觀看人數、平均觀看時間、追蹤數、互動次數、附有標籤的各項比率、各來源的觀看次數,以及附有持續時間的留存曲線(閱讀洞察)。從截圖中,使用 python3 SKILL_DIR/scripts/retention_curve.py SHOT --duration SECONDS 讀取曲線,並根據曲線下面積計算的平均值與應用程式顯示的數值進行比對。根據縮圖、圖表日期和觀看次數來識別每張截圖屬於哪部影片;當證據不足以判斷時,請提出詢問。
  • 將曲線與最終渲染版本的字幕對齊:對於每一個陡降和平穩區段,記錄在它發生前幾秒說了些什麼以及顯示了什麼。與影片庫進行比較:相同格式的影片,以及每部影片的 3→10 秒流失率。
  • 如果有值得重拍的版本,提出來:指出為了解決發現的問題所需的最小改動,例如新的鉤子、在觀眾離開的地方進行剪輯,或是分析表現較佳的影片做了什麼不同之處以及如何複製。
  • 撰寫該影片的庫條目和索引列,然後更新發現記錄檔:將證據添加到它影響的每個假設中,並且只有在兩部或更多影片意見一致時才更改狀態。在儲存之前,從字幕檔案中取得所有引用的台詞和時間,而不是摘要;僅在有來源的情況下提供發布日期;根據索引,在涵蓋的影片範圍內檢查每一個排名類詞彙(最高、最低、唯一、最佳)。

Individual skills in this repo

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

CrissAlvarezH/animated-video

Make animated videos in code with Remotion (React, SVG, three.js): explainers, character stories, motion graphics, kinetic typography, paper collage and animated infographics, in 2D or 3D, from a script or voiceover, in any aspect ratio. Use when asked to animate a script, make an animated video or Reel, or motion graphics. Not for editing camera footage (video-edit) or AI-generated clips (higgsfield-*).

CrissAlvarezH/new-style

Create a new visual style for the creator's videos in a Reel Studio workspace (styles/<id>/style.json): interview him for its name, feel, colours and what each one means, fonts, motion, where pictures come from, reference links and images, then write the style so it shows in Estilos and new videos can use it. Use when he asks for a new style or presses "Nuevo estilo" on the Estilos page.

CrissAlvarezH/persona-hablando

The "Persona hablando + animaciones" format of a Reel Studio video — the creator talks to camera in his own recording; you transcribe it, agree the cuts with him (pauses, flubs, retakes), cut it, and lay the video's style animations over or between his shots. Use for any video whose format.txt says persona-hablando.

CrissAlvarezH/reel-studio

How a narrated explainer video is made in a Reel Studio workspace, in any visual style — script, pictures, voice, images, build, board, sound, mute test, render — following the creator's settings from the studio (profile, format, voice, image sources). Use for any new or revised video in a project's videos/ (projects/<id>/videos/). The video's style adds its own skill (styles/<id>/SKILL.md) for the look and the Remotion kit; LESSONS.md has what past videos taught.

相關技能