refine: README simplification + Fun-ASR-Nano as explicit default
README (EN + ZH): - npx skills add: use HTTPS URL instead of SSH - Remove 'First use' uv sync section (agent handles setup, not user) - Remove 'Stock Material Search' section (workflow detail, belongs in SKILL.md) - Keep README focused on overview + workflow, not implementation details - Fun-ASR-Nano marked as default in Features SKILL.md: - Step 4: explicitly state Fun-ASR-Nano as recommended default model
This commit is contained in:
@@ -6,7 +6,7 @@ An agent skill that helps plan video edits through iterative dialogue — transc
|
||||
|
||||
## Features
|
||||
|
||||
- **Audio transcription** — bundled [funasr-script](https://github.com/modelscope/FunASR) with Fun-ASR-Nano (high quality, Chinese-optimized) and SenseVoice (fast preview) models
|
||||
- **Audio transcription** — bundled [funasr-script](https://github.com/modelscope/FunASR) with Fun-ASR-Nano (default, high quality, Chinese-optimized) and SenseVoice (fast preview) models
|
||||
- **On-demand frame extraction** — ffmpeg-based clip cutting (`-c copy`) + scene-change detection + uniform sampling, with hardware acceleration (CUDA/NVDEC preferred)
|
||||
- **Artifact indexing** — SQLite database tracks all transcriptions, clips, and frames to avoid duplicate processing across sessions
|
||||
- **Vision analysis guidance** — binary-search-style frame sampling strategy; works with any vision-capable model the agent's runtime provides
|
||||
@@ -31,13 +31,13 @@ This skill is compatible with the [open agent skills ecosystem](https://www.npmj
|
||||
|
||||
```bash
|
||||
# Install globally (available across all projects)
|
||||
npx skills add git@git.nite07.com:nite/video-edit-planner-skill.git -g -y
|
||||
npx skills add https://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
|
||||
npx skills add https://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
|
||||
npx skills add https://git.nite07.com/nite/video-edit-planner-skill.git --list
|
||||
```
|
||||
|
||||
Supports 73+ agent frameworks including Claude Code, Codex, Cursor, OpenCode, and more.
|
||||
@@ -45,21 +45,11 @@ Supports 73+ agent frameworks including Claude Code, Codex, Cursor, OpenCode, an
|
||||
**Option 2: `git clone` (manual)**
|
||||
|
||||
```bash
|
||||
git clone git@git.nite07.com:nite/video-edit-planner-skill.git ~/.hermes/skills/media/video-edit-planner
|
||||
git clone https://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:
|
||||
|
||||
```bash
|
||||
cd ~/.hermes/skills/media/video-edit-planner/scripts/transcription && uv sync
|
||||
```
|
||||
|
||||
This creates an isolated venv with `funasr`, `torch`, `torchaudio`. If you've used these packages via uv before, the cache is reused — first-time cost is only the link step.
|
||||
|
||||
## Workflow
|
||||
|
||||
```
|
||||
@@ -73,26 +63,6 @@ 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
|
||||
|
||||
```
|
||||
@@ -105,7 +75,7 @@ video-edit-planner/
|
||||
│ │ ├── pyproject.toml
|
||||
│ │ ├── uv.lock
|
||||
│ │ ├── funasr_common.py # Shared: ffprobe, audio extraction, model runner
|
||||
│ │ ├── funasr_nano.py # Fun-ASR-Nano entry point (high quality)
|
||||
│ │ ├── funasr_nano.py # Fun-ASR-Nano entry point (default, high quality)
|
||||
│ │ ├── funasr_fast.py # SenseVoice entry point (fast preview)
|
||||
│ │ └── funasr_regular.py # Paraformer entry point (comparison)
|
||||
│ ├── frames/
|
||||
|
||||
Reference in New Issue
Block a user