Skip to content

v-modal/vmodal_mcp / skills/vmodal-find

vmodal-find

Verified

Find moments in VModal video collections and verify every detail of the query on the actual frames before reporting a match. Use when the user asks to find, search, locate or show something (an object, scene, person, place, "a beautiful shot") in a VModal collection or sub-collection, e.g. "Find a red car. Collection: city" or "a beautiful scene in Kyoto". Requires the vmodal MCP (dev branch, with the `find` tool).

FileKindSize
SKILL.mdskill md6.6 KB
reference.mdmarkdown2.8 KB
scripts/frames_to_png.shexecutablescript2.1 KB

scripts/frames_to_png.sh

View on GitHub
#!/usr/bin/env bash
help='
  Convert VModal frames (WebP, sometimes saved with a .jpg name) to PNG so they can be viewed.
  Prints one line per input: the PNG path, or "FAIL <input>".
  Relative inputs are resolved against $VMODAL_MCP_CWD, the current dir, then $HOME
  (the MCP server saves ztmp/vmodal/... relative to its own working directory).
  Converters tried in order: sips (macOS), dwebp, ffmpeg, magick/convert.

  frames_to_png.sh <out_dir> <frame>...                      # default: imgs_to_png
  frames_to_png.sh imgs_to_png /tmp/vmodal-find ztmp/vmodal/20261006_131804/city/a.webp
  frames_to_png.sh os_resolve ztmp/vmodal/20261006_131804/city/a.webp
'

os_resolve() {
  local help='
    ## Usage:
      frames_to_png.sh os_resolve ztmp/vmodal/20261006_131804/city/a.webp
  '
  local p="$1" base
  if [[ "$p" == /* ]]; then [[ -f "$p" ]] && echo "$p" && return 0; return 1; fi
  for base in "${VMODAL_MCP_CWD:-}" "$PWD" "$HOME"; do
    [[ -n "$base" && -f "$base/$p" ]] && echo "$base/$p" && return 0
  done
  return 1
}

img_to_png() {
  local help='
    ## Usage:
      frames_to_png.sh img_to_png ~/ztmp/vmodal/x/city/a.webp /tmp/vmodal-find/a.png
  '
  local src="$1" dst="$2"
  if command -v sips >/dev/null; then sips -s format png "$src" --out "$dst" >/dev/null 2>&1 && return 0; fi
  if command -v dwebp >/dev/null; then dwebp -quiet "$src" -o "$dst" 2>/dev/null && return 0; fi
  if command -v ffmpeg >/dev/null; then ffmpeg -loglevel error -y -i "$src" "$dst" && return 0; fi
  if command -v magick >/dev/null; then magick "$src" "$dst" && return 0; fi
  if command -v convert >/dev/null; then convert "$src" "$dst" && return 0; fi
  return 1
}

imgs_to_png() {
  local help='
    ## Usage:
      frames_to_png.sh imgs_to_png /tmp/vmodal-find ztmp/vmodal/x/city/a.webp ztmp/vmodal/x/city/b.jpg
  '
  local out="$1" p src dst
  shift
  mkdir -p "$out"
  for p in "$@"; do
    src=$(os_resolve "$p") || { echo "FAIL $p"; continue; }
    dst="$out/$(basename "${src%.*}").png"
    img_to_png "$src" "$dst" && echo "$dst" || echo "FAIL $p"
  done
}

case "${1:-}" in
  ""|-h|--help|help) echo "$help" ;;
  os_resolve|img_to_png|imgs_to_png) "$@" ;;
  *) imgs_to_png "$@" ;;
esac
reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis.Stars: 472kUpdated Claude CodeCodexVerifiedInstall
diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness.Stars: 322kUpdated Claude CodeCodexVerifiedInstall
dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependenciesStars: 322kUpdated Claude CodeCodexVerifiedInstall
executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is availableStars: 322kUpdated Claude CodeCodexVerifiedInstall