Communitygithub.com

PetarKukric/CLAUDE_SKILLS

將參考用的 Instagram Reel 轉換成專屬於你的 Reel 腳本,根據你的語氣調整,並從你的電子報內容中重新取材。

CLAUDE_SKILLS 是什麼?

此技能旨在幫助內容創作者有效地將既有的 Instagram Reel 逆向工程,並將其結構套用於自己的電子報主題,以產出個人化的 Reel 腳本。它透過 Apify 爬取 Reel 影片,再交由 Gemini 2.5 Flash 模型進行深度分析,萃取逐字稿、鉤子 (Hook)、語言模式與結構。最後,技能會結合使用者在專案中的 `voice.md` 和 `about-me.md` 等品牌風格檔案,自動生成新的腳本。此技能支援 Codex 和 Claude 平台,並嚴格遵循一套 QA 流程,確保腳本質量達到 95/100 的標準,且完全符合使用者的個人語氣。它要求使用者提供 `APIFY_API_TOKEN` 和 `GOOGLE_AI_API_KEY` 環境變數以啟用完整的影片分析功能;若已提供影片或分析結果,則可跳過部分步驟。

相容平台✓Claude Code✓Codex CLI~Cursor✓Gemini CLI
npx skills add https://github.com/PetarKukric/CLAUDE_SKILLS/tree/HEAD/cache/social-media-skills/social-media-skills/1.1.0/skills/reels-scripting

在你喜歡的 AI 中提問

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

說明文件

Reels 腳本生成

Codex 與 Claude 執行環境

  • 此技能可在 Codex 或 Claude 中使用當前任務實際可用的工具。AskUserQuestion 範例描述的是問題,而非強制使用的 API:請在工具限制範圍內使用可用的提問工具,或在對話中直接提問。重複使用已提供的答案和原始資料。
  • 在使用者選擇的專案中工作。在進行個人化工作之前,先讀取其 about-me.md、voice.md 及相關的品牌文件。如果檔案內容衝突或包含預設的入門範本,請確認目標作者。對於缺失的事實請提問,或執行 voice-builder;絕不能繼承維護者的身份、帳戶或私人檔案。
  • 相對於此技能資料夾解析捆綁的 references/。若為明確要求的個人資料刷新,請直接讀取並更新原始的 about-me.md、voice.md 或 newsletter-voice.md,並保留不相關的使用者事實與規則。其他流程必須重新讀取這些原始檔案。僅在建立的新檔案可能與既存的不相關檔案衝突時,才使用新的檔案名稱。單純的安裝動作絕不能啟動訪談或寫入檔案。除非被要求,否則不要寫入持續性的學習記錄。
  • 優先使用提供的證據。必要時,透過可用的搜尋/來源工具驗證外部主張。如果某個來源或整合功能不可用,請說明缺少的功能,並提供文字或匯入的輸入資料作為替代。絕不能捏造事實、第一人稱經驗、指標或成功的工具執行結果。
  • 僅透過使用者既有的帳戶連線所選路徑所需的服務。絕不能列印憑證或覆寫連線。撰寫草案、儲存和審閱並不等同於授權發布、發送訊息或更改帳戶。

關鍵:載入後自動啟動

當此技能觸發時,直接進入步驟 1。不要進行摘要。

前置需求

完整的 Apify + Gemini 影片分析路徑需要:

  • APIFY_API_TOKEN 環境變數(用於 Instagram 爬蟲)
  • GOOGLE_AI_API_KEY 環境變數(用於 Gemini 2.5 Flash 影片分析)
  • Node.js 18+ 以及 apify-client 和 @google/generative-ai 套件

僅檢查所選路徑所需的功能。對於 URL 提取和 Gemini 影片分析,請在不列印的情況下確認使用者現有的憑證是否存在,然後確認供應商和模型可用。缺少憑證、套件、私人影片或不可用的模型,則該階段會處於待處理狀態。說明缺少的項目;不要修改帳戶配置或擅自替換供應商。

如果提供了影片,則可以跳過 Apify。如果提供了逐字稿/分析,則可以跳過步驟 3 和 4,並在步驟 5 中支援帶有標籤的、基於逐字稿的腳本,但這並非 Gemini 影片分析的結果。重複使用已安裝的套件;在生成輔助腳本之前,請檢查當前的官方 SDK 和 actor 文件,並在產生供應商成本之前獲得使用者的批准。

步驟 1. 取得參考資料

提問:

請貼上參考用的 Reel 網址或 Notion 連結。這是你想要逆向工程格式的「離群值 (outlier) Reel」。

等待網址。

如果使用者貼上 Notion 連結,請透過可用的授權 Notion 連接器讀取它,在頁面上找到 Instagram Reel 網址並提取出來。如果在 Notion 頁面上找不到 Reel 網址,請要求使用者直接貼上 Reel 網址。

步驟 2. 取得電子報主題

提問:

你想從電子報中取材什麼主題來製作這個 Reel?貼上相關的電子報段落,或用一句話輸入核心概念。

等待主題。如果專案中存在,請讀取 newsletter-voice.md、voice.md 和 about-me.md,以便腳本符合使用者的語氣。

步驟 3. 爬取並下載 Reel

在選定的專案中使用新的 outputs/reels/<slug>/ 資料夾。如果存在合適的現有輔助工具,請重複使用;否則,在該資料夾中撰寫一個小型、特定任務的 Node.js 腳本,該腳本:

  1. 使用 apify-client 和現有的 apify/instagram-reel-scraper 路由(在檢查其當前已記錄的 schema 之後),針對單一請求的 Reel。絕不能爬取留言、回覆或留言串,包括透過 deepScrape 或 numComments。在呼叫供應商之前,請確認其支援僅收集貼文/影片;否則請求上傳影片。不要猜測其他的 actor 輸入。
  2. 從回傳的項目中提取 videoUrl。
  3. 將影片下載至 outputs/reels/<slug>/downloads/{username}_{shortCode}.mp4。
  4. 將原始爬取資料儲存至 outputs/reels/<slug>/reel_data_{shortCode}.json。

執行腳本。在繼續之前,確認檔案大小和中繼資料(觀看次數、讚數、可用的總留言數、字幕前 200 個字元)。

單一的 Reel 是參考資料,而非經過驗證的離群值。僅在提供或明確要求的比較數據確立了其相對於同一創作者近期貼文的表現時,才將其稱為離群值;請引用樣本、時間範圍和多個數據點。不要捏造該基準。

步驟 4. 使用 Gemini 2.5 Flash 進行分析

擴充 Node 腳本(或執行第二個步驟),該腳本:

  1. 讀取已下載的 .mp4 檔案作為 base64。
  2. 呼叫 genAI.getGenerativeModel({ model: 'gemini-2.5-flash' })。
  3. 使用以下精確提示發送影片:
我正在研究這個 Reel,以便為我的 [來自 about-me.md 的受眾] 撰寫類似風格的腳本。

## 完整逐字稿
- 使用時間戳記轉寫每一個字

## 鉤子 (Hook)
- 說出的第一個詞
- 鉤子的字數
- 是什麼讓它能阻止滑動?

## 語言模式
- 平均句子長度
- 你/你的 與 我/我的 的比例
- 不同論點之間的轉換
- 「只是」這類淡化詞出現在哪裡?

## 結構
- 總時長
- 分段與時間點
- 改變前/後的時刻是什麼?
- 行動呼籲 (CTA) 是什麼?

## 一個關鍵洞察
- 從這個 Reel 中學到的最重要技巧

將分析結果儲存至 outputs/reels/<slug>/analysis_reference_{shortCode}.md。

步驟 5. 撰寫新的 Reel 腳本

使用步驟 4 的分析結果、步驟 2 的電子報主題以及使用者的語氣檔案,將新的 Reel 腳本寫入 outputs/reels/<slug>/reel-[slug].md。

套用以下規則(不可協商):

鉤子 (Hook)

  • 絕不能以「我」開頭。使用「這」、「你」、一個事實或指名道姓。
  • 經過驗證的格式:「這改變了... forever」/ 負面翻轉(「X 毫無用處除非...」)/ 能力陳述。
  • 鉤子要在 3 秒內激起好奇心或造成模式中斷。
  • 模仿參考分析中鉤子的字數和結構。

內容主體

  • 使用英式英語。句子簡短。不要使用破折號或分號。
  • 以對話方式使用「你」和「就」(「你就這樣放進去...」)。
  • 絕不能合併三個或以上的斷裂片段。將它們結合成一個流暢的句子。
  • 絕不能陳述結論。讓事實自己說話。
  • 僅在使用者有實際可交付成果且已確認有效的自動化系統時,才使用留言式行動呼籲。否則,使用一個相關的、不承諾交付的下一步行動。

留言觸發詞(僅在支援時使用)

  • 僅使用單一大寫單詞(SCRIPT, WIKI, PROMPTS, VIDEO)。
  • 必須直接與承諾的內容相關。
  • 不要使用引號,不要使用「下方」,不要使用尾隨標點符號。

行動呼籲 (CTA)

  • 「留言 [單詞] 我就傳給你 [具體的東西]」
  • 簡短。不要使用「我完整XX的連結」這類填充詞。

時長與結構

  • 總時長目標為 30 到 45 秒。
  • 最多 2 個關鍵要點,而不是 3 個。
  • 字幕需與腳本內容一致。兩者需同時更新。

腳本檔案結構

# Reel: [標題]

## 參考分析
- 網址:[reel 網址]
- 觀看次數:[數字]
- 關鍵技巧:[來自 Gemini 分析]

## 時長目標
30-45 秒

## 鉤子 (0-3秒)
[確切的詞句]

## 要點 1 ([開始]-[結束]秒)
[確切的詞句]

## 要點 2 ([開始]-[結束]秒)
[確切的詞句]

## 行動呼籲 ([開始]-[結束]秒)
[確切的下一步行動,僅在確認有交付機制時才包含留言承諾]

---

## 字幕
[鏡像腳本內容,並針對 Instagram 進行格式調整]

## 留言觸發詞(僅在已配置時)
[單詞 或 不適用]

## 可交付成果(僅在已承諾時)
[實際可用的資源 或 不適用]

---

## 視覺筆記
[剪輯、B-Roll 想法、文字疊加]

步驟 6. QA 循環

在執行中的助理中進行審查:來源準確性 (30)、使用者語氣 (25)、鉤子與結構 (20)、口語時長與清晰度 (15)、字幕與行動呼籲一致性 (10)。為每個分數引用證據。修正實際的違規問題並重新評分,最多進行三次。門檻為 95/100;若無法解決,請回報帶有特定障礙的草案,而不是虛增分數或聲稱已準備就緒。當可行時,計時口語朗讀;否則標記為時長預估值。在 Codex 中,Claude 不需要參與此審查。

需要檢查的常見違規項目:

  • 以「我」開頭
  • 三個或以上的斷裂片段
  • 陳述結論
  • 多詞或經過美化的留言觸發詞
  • 朗讀時長超過 45 秒
  • 3 個要點而非 2 個
  • 字幕未鏡像腳本內容

步驟 7. 交付腳本

將審查後的腳本和匹配的字幕交付到專案中,並附上參考來源、分析方法以及任何未解決的檢查事項。使用者可以自行錄製,或明確要求其可用的製作流程。此公開技能不包含頭像、編輯或發布流程。

規則

  • 絕不能跳過 95/100 的 QA 門檻。
  • 在撰寫前務必讀取 voice.md 和 about-me.md。語氣匹配是不可協商的。
  • 絕不能捏造參考 Reel 的指標。僅使用經核實的、已提供或取得的中繼資料,並將缺失的指標標示為不可用。
  • 使用英式英語。不要使用破折號。不要使用分號。
  • 每個腳本都包含匹配的字幕;僅在承諾的交付機制確實有效時才包含留言觸發詞。
  • 如果取得參考資料失敗,請回報失敗的階段,並提供使用者影片/逐字稿作為輸入。不要偽造影片分析。
  • Gemini 2.5 Flash 是指定模型。未經使用者批准不得替換。

Individual skills in this repo

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

相關技能