nite/video-edit-planner-skill
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

feat: add stock material search section + npx skills add install

Browse Source 
- SKILL.md: new 'Finding stock materials' section (on-demand, not mandatory)
  - 5 material sources: 爱给网, B站素材酷, Tenor, GIPHY, Klipy
  - Language-based priority (Chinese users → 爱给网 + B站素材酷)
  - Semantic search term expansion guidance
  - B站素材酷: bcut-resource-search userscript or direct API
  - Anti-bot fallback: browser-based tools
- README.md + README.zh.md: add 'npx skills add' install method
  - Compatible with open agent skills ecosystem (73+ frameworks)
  - git clone as fallback option
  - New 'Stock Material Search' section
This commit is contained in:
nite
2026-07-14 12:00:39 +08:00
parent f8ecbadf1d
commit b60931913b
3 changed files with 121 additions and 4 deletions
Download Patch File Download Diff File Expand all files Collapse all files
README.md
+41 -2
View File
@@ -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
```
README.zh.md
+41 -2
View File
@@ -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。
## 目录结构
```
SKILL.md
+39
View File
@@ -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):