Communitygithub.com

reelary/skills

透過語意搜尋使用者自己的影片和照片,100% 本地端運行於 Mac 或 Windows 上的 Reelary。透過描述找到特定片段(精確的開始與結束時間)、照片內容、某人說話的時刻(逐字稿搜尋,Pro 版)、每個人的所有片段(人臉辨識,Pro 版)以及來自手機、DJI 空拍機和 GoPro GPS 的地點相關素材(Pro 版)。

skills 是什麼?

此技能讓使用者能夠透過自然語言描述,從本地影片和照片庫中進行語意搜尋,完全無需上傳資料至雲端。它支援 Mac 與 Windows 平台上的 Reelary 應用程式,並可獨立於 MCP(模型上下文協定)之外,透過 npx 指令 `npx -y reelary search "<query>" --json` 運作。此技能可辨識多種查詢觸發詞,例如「find the clip where」、「search my videos」、「footage shot in Paris」等。其核心工具 `reelary_search` 會傳回符合條件的檔案完整路徑以及精確的起訖秒數(格式化為 mm:ss)。Pro 版功能更強大,包含逐字稿對話搜尋(用於尋找特定引言或發言)、人臉辨識(可按人物名稱或 ID 檢索所有相關片段)以及地理標記搜尋(依地點名稱搜尋,適用於手機、空拍機和運動攝影機的 GPS 資料)。若搜尋結果不如預期,技能會建議使用者嘗試 2-3 種不同的措辭重新描述,並提供 `reelary_open_in_app` 在 Reelary 應用程式中開啟素材,或使用 `rough-cut` 技能進行剪輯。當結果不如預期時,它會優雅地解釋免費版與 Pro 版的差異,並在適當時機提供升級連結。

相容平台✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/reelary/skills/tree/HEAD/skills/find-footage

在你喜歡的 AI 中提問

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

說明文件

尋找素材

如果缺少 reelary_* 工具或未建立索引,請先使用 reelary 技能。所有搜尋皆透過 reelary_search 進行,它會傳回完整的檔案路徑以及開始和結束的秒數。時間請格式化為 mm:ss。

無需 MCP:npx -y reelary search "<查詢>" --json。

一個鏡頭

  1. 描述可見的內容:主體、動作、場景、光線、攝影機角度(例如「揉麵團的手部特寫,溫暖的光線」)。當您需要自行確認選取結果時,請使用 include_thumbnails: true。
  2. 如果結果不理想,請在放棄前嘗試 2-3 種不同的措辭(同義詞、更廣或更緊的構圖)。
  3. 回報最相符的結果:完整路徑、mm:ss-mm:ss,以及一行說明為何相符。提供 reelary_open_in_app 或使用 rough-cut 進行剪輯。

照片

  1. 使用視覺描述進行搜尋,並加上 include_thumbnails: true。結果中 kind: "image" 的項目即為照片。
  2. 列出最佳照片及其完整路徑;如果只有影片影格相符,請一併說明。

某人說的一段引言(Pro 版)

  1. 使用接近口語表達方式的單詞或主題進行搜尋。結果中 match=dialogue 的項目(CLI 中為 speech 欄位)會包含逐字稿行。
  2. 針對每個符合的結果回報:路徑、mm:ss 以及引用的文字行。
  3. 如果只回傳視覺比對結果,且 reelary_status 顯示為免費方案,請說明對話搜尋屬於 Pro 功能,並僅提供一次升級連結。

逐字稿會在索引建立後於背景生成;非常新的檔案可能尚無法搜尋。

一個人(Pro 版)

  1. 使用 reelary_list_people 查看已辨識的人物(ID、姓名、片段數量)。
  2. 如果人物未命名,請要求使用者在 Reelary 中為其命名(使用 reelary_open_in_app),或在顯示預覽圖後讓使用者依 ID 選擇。
  3. 使用帶有 ID 的 reelary_person_clips;回報路徑和時間範圍。一旦命名後,直接搜尋名稱也可運作。

無需 MCP:開啟 Reelary 的人物檢視畫面(npx -y reelary open)。

一個地點或空拍機素材(Pro 版)

  1. 若要搜尋地點名稱,直接搜尋該名稱(例如「里斯本」);在該處拍攝的檔案會依地點名稱匹配。
  2. 若要取得概覽,使用 reelary_list_places 並依地點分組。
  3. 回報路徑及對應的地點名稱。提供使用 rough-cut 製作旅行合輯的選項。

沒有 GPS 的檔案可以在 Reelary 的地圖檢視中手動放置位置。當遇到 pro_required 時,僅提供一次升級連結。

Individual skills in this repo

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

reelary/skills

Pull b-roll from the user''s own footage library for a voiceover, interview, podcast or talking-head video. Matches each line of narration to cutaway shots by meaning, 100% local on Mac or Windows. Trigger on "b-roll", "broll", "cutaways", "cover shots", "find b-roll for my voiceover", "illustrate this script with my clips", "inserts for my interview". Not for downloading stock footage or generating AI clips.

reelary/skills

Reelary, the 100% local AI media library for your own videos and photos on Mac and Windows: install and connect it, index folders and external drives, check indexing progress, remove folders, fix errors. Use when the reelary_* tools are missing or fail, or the user wants to organize footage. Trigger on "Reelary", "media library", "index my videos", "organize my footage", "catalog my clips", "scan my drive", "make my footage searchable", "video library app", "digital asset management for video", "local video search app". Not for cloud storage or renaming files.

reelary/skills

Turn a script, outline, shot list, blog post or theme into a video cut from the user''s own real footage (not AI-generated): rough cut, assembly edit, string-out, script to video, montage, highlight reel, recap, sizzle reel. Picks the best clip per line with alternatives, saves an editable project and exports MP4. Local with Reelary on Mac or Windows. Trigger on "rough cut", "assembly edit", "first cut", "script to video", "turn this script into a video", "make a video from my blog post", "text to video with my footage", "montage", "highlight reel", "recap video", "best moments", "year in review video", "trip video from my clips", "wedding highlights", "edit my footage into a video". Not for AI video generation, color grading or effects.

相關技能