tools-update-cron: sync 2026-08-09 — 37 skill(s) updated

This commit is contained in:
Hermes Agent
2026-08-09 01:01:38 -05:00
parent 94ac068425
commit 004feddf0a
37 changed files with 5386 additions and 760 deletions
+95 -57
View File
@@ -1,7 +1,7 @@
---
name: ai-vid-stock
description: "Manage AI video stock materials on TrueNAS — add, search, list, and remove start frames, audio, character refs, and misc images."
version: 1.0.0
description: "Manage AI video stock materials on TrueNAS — add, search, list, and remove assets across all 12 stock categories plus supplementary folders."
version: 2.0.0
author: Hermes Agent
license: MIT
platforms: [linux]
@@ -23,120 +23,158 @@ Manage stock materials for the LTX video pipeline stored on TrueNAS at `10.0.0.1
| Root path | `ai_vid_stock_material/` |
| Access | `smbclient -N //10.0.0.117/proxmoxBackup` |
## Directory Structure
## Authoritative Inventory
**The README.md on the share is the canonical inventory.** Always consult it first for the current folder list, contents, file counts, and sizes. Download it with:
```bash
smbclient -N //10.0.0.117/proxmoxBackup -c 'cd ai_vid_stock_material; get README.md /tmp/ai_vid_stock_readme.md'
```
ai_vid_stock_material/
├── README.md ← inventory (keep updated)
├── start_frames/ ← first/last frame images for I2V
├── audio/ ← TTS clips, ambient sounds, music
├── character_refs/ ← character reference images for ID LoRA
├── misc_images/ ← unsorted images, potential stock
├── scripts/ ← generation scripts, prompt templates
├── workflows/ ← ComfyUI workflow JSONs
├── outputs/ ← rendered videos (concat finals)
└── docs/ ← plans, state docs, story ideas
```
The README tracks: folder structure, file counts, sizes, reorg history, and stock-search acquisition logs. When adding/removing files, update the README.
## Directory Structure (current as of 2026-07-29)
### 12 Canonical Stock Categories
| # | Folder | Purpose |
|---|--------|---------|
| 01 | `character_sheets/` | Character reference packs — turnarounds, expression sheets, pose variety |
| 02 | `environments_start_frames/` | Location/scene stills for I2V start frames |
| 03 | `end_frames/` | Target/last-frame stills for FLF I2V generation |
| 04 | `props_objects/` | Isolated prop/object reference images |
| 05 | `style_frames/` | Mood/style reference stills (color grade, lighting) |
| 06 | `control_pose_references/` | Pose/depth/canny control images |
| 07 | `motion_reference_clips/` | Short reference video clips for motion-transfer |
| 08 | `storyboard_previs_frames/` | Rough sequential previs frames |
| 09 | `texture_material_plates/` | Texture/material reference plates |
| 10 | `audio_stock/` | TTS clips, ambient sounds, music |
| 11 | `lora_weights_generation_params/` | Trained LoRA weights + generation params |
| 12 | `vehicles_creatures_effects/` | Vehicle/creature/VFX element reference images |
### Supplementary Infra Folders
| Folder | Purpose |
|--------|---------|
| `outputs/` | Rendered LTX video outputs (final concats + per-run subfolders) |
| `workflows/` | ComfyUI workflow JSONs |
| `docs/` | Pipeline planning docs, research notes, story prompt docs |
| `scripts/` | Generation scripts, automation |
| `my_images/` | Operator-supplied source images (input material, not finished stock) |
| `backup_files/` | ComfyUI model/module cold storage (preserves /models/ path) |
| `lora/` | LoRA weight files (.safetensors) for active use — raw weights only |
## Commands
### List all stock materials
All commands use `smbclient -N //10.0.0.117/proxmoxBackup`. The share root is `ai_vid_stock_material/`.
### List all folders
```bash
smbclient -N //10.0.0.117/proxmoxBackup -c 'cd ai_vid_stock_material; ls start_frames/*; ls audio/*; ls character_refs/*; ls misc_images/*; ls scripts/*; ls workflows/*'
smbclient -N //10.0.0.117/proxmoxBackup -c 'cd ai_vid_stock_material; ls'
```
### List a specific category
### List contents of a specific folder
```bash
smbclient -N //10.0.0.117/proxmoxBackup -c 'cd ai_vid_stock_material; ls <category>/*'
smbclient -N //10.0.0.117/proxmoxBackup -c 'cd ai_vid_stock_material; ls <folder>/*'
```
Categories: `start_frames`, `audio`, `character_refs`, `misc_images`, `scripts`, `workflows`
### Search by filename pattern
### Search across all stock categories by filename pattern
```bash
smbclient -N //10.0.0.117/proxmoxBackup -c 'cd ai_vid_stock_material; ls start_frames/*' 2>/dev/null | grep -i "<pattern>"
smbclient -N //10.0.0.117/proxmoxBackup -c 'cd ai_vid_stock_material; ls audio/*' 2>/dev/null | grep -i "<pattern>"
# ... repeat for each category
for dir in character_sheets environments_start_frames end_frames props_objects style_frames control_pose_references motion_reference_clips storyboard_previs_frames texture_material_plates audio_stock lora_weights_generation_params vehicles_creatures_effects lora; do
echo "=== $dir ==="
smbclient -N //10.0.0.117/proxmoxBackup -c "cd ai_vid_stock_material; ls $dir/*" 2>/dev/null | grep -i "<pattern>"
done
```
### Add a file (upload)
```bash
smbclient -N //10.0.0.117/proxmoxBackup -c 'cd ai_vid_stock_material/<category>; put <local_path> <remote_filename>'
```
Example:
```bash
smbclient -N //10.0.0.117/proxmoxBackup -c 'cd ai_vid_stock_material/start_frames; put /tmp/new_frame.png scene_07_start.png'
smbclient -N //10.0.0.117/proxmoxBackup -c 'cd ai_vid_stock_material/<folder>; put <local_path> <remote_filename>'
```
### Add from remote server (e.g., .202 ComfyUI)
```bash
# 1. Download from remote
sshpass -p 'passw0rd' scp [email protected]:~/comfy-ui/input/<filename> /tmp/
# 1. Pull from remote
scp [email protected]:<remote_path> /tmp/<filename>
# 2. Upload to TrueNAS
smbclient -N //10.0.0.117/proxmoxBackup -c 'cd ai_vid_stock_material/<category>; put /tmp/<filename> <filename>'
smbclient -N //10.0.0.117/proxmoxBackup -c 'cd ai_vid_stock_material/<folder>; put /tmp/<filename> <filename>'
```
### Remove a file
```bash
smbclient -N //10.0.0.117/proxmoxBackup -c 'cd ai_vid_stock_material/<category>; rm <filename>'
smbclient -N //10.0.0.117/proxmoxBackup -c 'cd ai_vid_stock_material/<folder>; rm <filename>'
```
### Download a file from stock
### Download a file
```bash
smbclient -N //10.0.0.117/proxmoxBackup -c 'cd ai_vid_stock_material/<category>; get <filename> <local_path>'
smbclient -N //10.0.0.117/proxmoxBackup -c 'cd ai_vid_stock_material/<folder>; get <filename> <local_path>'
```
### Download entire category
### Download entire folder
```bash
mkdir -p /tmp/stock_dl/<category>
cd /tmp/stock_dl/<category>
smbclient -N //10.0.0.117/proxmoxBackup -c "cd ai_vid_stock_material/<category>; prompt OFF; mget *"
mkdir -p /tmp/stock_dl/<folder>
cd /tmp/stock_dl/<folder>
smbclient -N //10.0.0.117/proxmoxBackup -c "cd ai_vid_stock_material/<folder>; prompt OFF; mget *"
```
### Update README inventory after changes
After adding/removing files, update the README.md on TrueNAS:
### Create a new folder
```bash
# Download current README
smbclient -N //10.0.0.117/proxmoxBackup -c 'cd ai_vid_stock_material; get README.md /tmp/README.md'
smbclient -N //10.0.0.117/proxmoxBackup -c 'cd ai_vid_stock_material; mkdir <new_folder>'
```
# Edit /tmp/README.md to reflect changes
### Update README after changes
# Upload updated README
smbclient -N //10.0.0.117/proxmoxBackup -c 'cd ai_vid_stock_material; put /tmp/README.md README.md'
```bash
# Download
smbclient -N //10.0.0.117/proxmoxBackup -c 'cd ai_vid_stock_material; get README.md /tmp/ai_vid_stock_readme.md'
# Edit /tmp/ai_vid_stock_readme.md
# Upload
smbclient -N //10.0.0.117/proxmoxBackup -c 'cd ai_vid_stock_material; put /tmp/ai_vid_stock_readme.md README.md'
```
## Category Guidelines
| Category | What goes here | File types |
|----------|---------------|------------|
| start_frames | First/last frame images for I2V generation | .png, .jpg |
| audio | TTS clips, ambient sounds, music for video | .mp3, .wav |
| character_refs | Reference images for ID LoRA character consistency | .png, .jpg |
| misc_images | Unsorted images, potential stock, inspiration | .png, .jpg |
| scripts | Generation scripts, prompt templates, automation | .py, .sh, .json, .txt |
| workflows | ComfyUI workflow JSONs (exported from UI) | .json |
| Folder | What goes here | File types |
|--------|---------------|------------|
| `character_sheets/` | Character reference packs — turnarounds, expression sheets, pose variety, hero portraits | .png, .jpg |
| `environments_start_frames/` | Location/scene stills used as I2V start frames | .png, .jpg, .jpeg |
| `end_frames/` | Target/last-frame stills for FLF I2V generation | .png, .jpg |
| `props_objects/` | Isolated prop/object reference images for compositing | .png, .jpg |
| `style_frames/` | Mood/style reference stills (color grade, lighting language) | .png, .jpg |
| `control_pose_references/` | Pose/depth/canny control images for guided generation | .png, .jpg |
| `motion_reference_clips/` | Short reference video clips for motion-transfer / IC-LoRA Control | .mp4, .mov, .webm |
| `storyboard_previs_frames/` | Rough sequential previs frames for planning shot flow | .png, .jpg |
| `texture_material_plates/` | Texture/material reference plates (concrete, metal, fabric, etc.) | .png, .jpg |
| `audio_stock/` | TTS clips, ambient sounds, music for video | .mp3, .wav |
| `lora_weights_generation_params/` | Trained LoRA .safetensors + saved generation parameters (prompts/seeds/workflow configs) | .safetensors, .json, .txt |
| `vehicles_creatures_effects/` | Vehicle/creature/VFX element reference images | .png, .jpg |
| `lora/` | Raw LoRA weight files (.safetensors) for active ComfyUI use — drop here, load from here | .safetensors |
| `outputs/` | Rendered LTX video outputs | .mp4 |
| `workflows/` | ComfyUI workflow JSONs exported from UI | .json |
| `docs/` | Pipeline planning docs, research notes, story prompt docs | .md, .txt |
| `scripts/` | Generation scripts, prompt templates, automation | .py, .sh, .json, .txt |
| `my_images/` | Operator-supplied source images — input material, not finished stock | .png, .jpg |
| `backup_files/` | ComfyUI model/module cold storage — preserves full /models/ path | .safetensors, .pt, .ckpt, .gguf |
## Pitfalls
- **SMB path separators are backslashes** — use `cd ai_vid_stock_material\\start_frames` in smbclient, not forward slashes.
- **SMB path separators are backslashes** — use `cd ai_vid_stock_material\\<folder>` in smbclient, not forward slashes. Forward slashes work in the `-c` flag string but backslashes are needed for nested paths in interactive mode.
- **No mount available** — the cifs kernel module is not present on the Hermes host. Use smbclient for all operations. Do not attempt `mount.cifs`.
- **smbclient `mget`/`mput` need `prompt OFF`** — otherwise it prompts for every file.
- **Spaces in filenames** — quote them in smbclient commands.
- **Keep README.md updated** — it's the inventory of record. After any add/remove, update it.
- **TrueNAS guest access** — no credentials needed. If auth errors appear, the share config may have changed.
- **Large files** — smbclient `put`/`get` works for files up to several GB. For bulk transfers, consider using the TrueNAS web UI at `http://10.0.0.117`.
- **`lora/` vs `lora_weights_generation_params/`** — `lora/` is for raw .safetensors weights ready to load. `lora_weights_generation_params/` is for weights WITH their training configs and generation parameters. Don't mix them.
## LTX Pipeline Wiring Bug (2026-07-21)