diff --git a/README.md b/README.md index 1c111ff..e503701 100644 --- a/README.md +++ b/README.md @@ -25,12 +25,31 @@ An agent skill that helps plan video edits through iterative dialogue — transc ### Install the skill -Copy or clone this repository into your agent's skills directory. For Hermes Agent: +**Option 1: `npx skills add` (recommended)** + +This skill is compatible with the [open agent skills ecosystem](https://www.npmjs.com/package/skills). You can install it directly: ```bash -git clone mygit:nite/video-edit-planner-skill.git ~/.hermes/skills/media/video-edit-planner +# Install globally (available across all projects) +npx skills add git@git.nite07.com:nite/video-edit-planner-skill.git -g -y + +# Install to specific agents +npx skills add git@git.nite07.com:nite/video-edit-planner-skill.git -g -a claude-code -y + +# List available skills without installing +npx skills add git@git.nite07.com:nite/video-edit-planner-skill.git --list ``` +Supports 73+ agent frameworks including Claude Code, Codex, Cursor, OpenCode, and more. + +**Option 2: `git clone` (manual)** + +```bash +git clone git@git.nite07.com:nite/video-edit-planner-skill.git ~/.hermes/skills/media/video-edit-planner +``` + +For Hermes Agent specifically, clone into `~/.hermes/skills/media/`. For other agents, follow their respective skills directory conventions. + ### First use The transcription scripts need a one-time dependency setup: @@ -54,6 +73,26 @@ This creates an isolated venv with `funasr`, `torch`, `torchaudio`. If you've us 8. Iterate — user asks follow-ups, plan is refined ``` +## Stock Material Search (optional) + +When planning edits, users may need stock materials — stickers, GIFs, meme video clips, or B-roll. The skill provides guidance for finding these resources on demand. + +### Material sources + +| Source | URL | Content | Best for | +|---|---|---|---| +| 爱给网 | https://www.aigei.com/ | Chinese meme video clips (热梗, 42K+), free download | Chinese-language creators (B站/抖音) | +| B站素材酷 | https://cool.bilibili.com/ | Bilibili platform-native assets (video, audio, BGM, templates, stickers) | B站 creators; large Chinese meme collection | +| Tenor | https://tenor.com/ | GIFs + stickers, 30+ languages incl. Chinese, free API | Quick GIF/sticker search | +| GIPHY | https://giphy.com/ | Largest GIF library, 30+ languages, sticker channel | English/multilingual GIF search | +| Klipy | https://klipy.com/ | Localized GIF/sticker/clip API, supports Chinese | API-integrated search, localization | + +For Chinese-language users, 爱给网 and B站素材酷 are recommended first. + +### B站素材酷 search + +B站素材酷 has no built-in search. Use the [bcut-resource-search](https://git.nite07.com/nite/bcut-resource-search) Tampermonkey userscript to add search functionality, or let the agent query the API directly. + ## Project Structure ``` diff --git a/README.zh.md b/README.zh.md index ec77c32..40749b1 100644 --- a/README.zh.md +++ b/README.zh.md @@ -25,12 +25,31 @@ ### 安装 skill -将本仓库克隆到你的 agent 的 skills 目录。以 Hermes Agent 为例： +**方式一：`npx skills add`（推荐）** + +本 skill 兼容 [开放 agent skills 生态](https://www.npmjs.com/package/skills)，可以直接安装： ```bash -git clone mygit:nite/video-edit-planner-skill.git ~/.hermes/skills/media/video-edit-planner +# 全局安装（跨项目可用） +npx skills add git@git.nite07.com:nite/video-edit-planner-skill.git -g -y + +# 安装到指定 agent +npx skills add git@git.nite07.com:nite/video-edit-planner-skill.git -g -a claude-code -y + +# 列出可用 skill（不安装） +npx skills add git@git.nite07.com:nite/video-edit-planner-skill.git --list ``` +支持 73+ agent 框架，包括 Claude Code、Codex、Cursor、OpenCode 等。 + +**方式二：`git clone`（手动）** + +```bash +git clone git@git.nite07.com:nite/video-edit-planner-skill.git ~/.hermes/skills/media/video-edit-planner +``` + +Hermes Agent 用户克隆到 `~/.hermes/skills/media/`。其他 agent 请遵循各自的 skills 目录约定。 + ### 首次使用 转录脚本需要一次性依赖安装： @@ -54,6 +73,26 @@ cd ~/.hermes/skills/media/video-edit-planner/scripts/transcription && uv sync 8. 迭代——用户追问，规划逐步细化 ``` +## 素材搜索（可选） + +规划剪辑时，用户可能需要素材——贴纸、GIF、梗图视频片段、B-roll 等。skill 按需提供素材搜索指引。 + +### 素材来源 + +| 来源 | 网址 | 内容 | 适用场景 | +|---|---|---|---| +| 爱给网 | https://www.aigei.com/ | 中文梗图视频片段（热梗，4.2万+），免费下载 | 中文创作者（B站/抖音） | +| B站素材酷 | https://cool.bilibili.com/ | 哔哩哔哩平台素材（视频、音频、BGM、模板、贴纸） | B站创作者；大量中文梗图 | +| Tenor | https://tenor.com/ | GIF + 贴纸，支持 30+ 语言含中文，免费 API | 快速 GIF/贴纸搜索 | +| GIPHY | https://giphy.com/ | 最大 GIF 库，30+ 语言，贴纸频道 | 英文/多语言 GIF 搜索 | +| Klipy | https://klipy.com/ | 本地化 GIF/贴纸/片段 API，支持中文 | API 集成搜索，本地化 | + +中文用户优先推荐爱给网和B站素材酷。 + +### B站素材酷搜索 + +B站素材酷没有内置搜索功能。可以使用 [bcut-resource-search](https://git.nite07.com/nite/bcut-resource-search) 油猴脚本添加搜索功能，或让 agent 直接查询 API。 + ## 目录结构 ``` diff --git a/SKILL.md b/SKILL.md index 6dd0f49..9bb140c 100644 --- a/SKILL.md +++ b/SKILL.md @@ -247,6 +247,45 @@ The user will likely ask follow-ups: "what about this section?", "add a transiti **Completion criteria:** user is satisfied with the plan or explicitly ends the session. +## Finding stock materials (optional, on demand) + +When the user needs editing materials — stickers, GIFs, meme video clips, B-roll — the agent can help search or provide links for the user to search themselves. This section is **only triggered when the user asks for materials**; it is never a mandatory step. + +### Material sources + +| Source | URL | Content | Best for | +|---|---|---|---| +| 爱给网 | https://www.aigei.com/ | Chinese meme video clips (热梗, 4.2万+), free download | Chinese-language creators (B站/抖音) | +| B站素材酷 | https://cool.bilibili.com/ | Bilibili platform-native assets (video, audio, BGM, templates, stickers) | B站 creators; large Chinese meme collection | +| Tenor | https://tenor.com/ | GIFs + stickers, 30+ languages incl. Chinese, free API | Quick GIF/sticker search | +| GIPHY | https://giphy.com/ | Largest GIF library, 30+ languages, sticker channel | English/multilingual GIF search | +| Klipy | https://klipy.com/ | Localized GIF/sticker/clip API, supports Chinese | API-integrated search, localization | + +### Priority by language + +If the user communicates in Chinese, **recommend 爱给网 and B站素材酷 first** — they have the most Chinese-relevant meme and sticker content. For non-Chinese users, Tenor and GIPHY are good defaults. + +### Search strategy + +- **Expand search terms** based on semantic understanding of the user's request. If the user says "I want a clip of someone looking shocked", search terms might include: "惊讶 / 震惊 / 吃惊 / 哇 / wtf / shocked / surprised". Use the user's language as the base, expand with synonyms and internet slang. +- The agent can either **search directly** (using web tools or API calls) or **suggest expanded search terms** for the user to search manually. +- If the user only wants links, provide the source URLs above and let the user search themselves. + +### B站素材酷 special handling + +B站素材酷 (cool.bilibili.com) has no built-in search function. Two options: + +1. **Recommend the userscript**: [bcut-resource-search](https://git.nite07.com/nite/bcut-resource-search) — a Tampermonkey script that adds search to 素材酷, supporting video, sticker/image, music, sound effect, and template categories. +2. **Search via API directly**: the agent can read the userscript's source code to discover the API endpoints and make requests directly (via HTTP tools or curl). Note: the site has CORS restrictions and UA-based access control, so direct API calls may require appropriate headers. If the agent's HTTP tools are blocked, fall back to suggesting the userscript to the user. + +### Anti-bot fallback + +Some material sites may block automated access (anti-bot, Cloudflare, CAPTCHA). If a web request or HTTP tool is blocked: + +1. Try with different headers (User-Agent, Accept-Language) if the tool allows. +2. Fall back to a browser-based tool (e.g., Playwright, Puppeteer, or any browser automation the agent's runtime provides) to access the content. +3. If browser tools are also blocked, inform the user and provide the direct URL for manual search. + ## Long-running operations Before any operation expected to take >1 minute (first-time `uv sync`, transcription of long videos, large frame extraction):