Procedural Fish Render

Automates the full lifecycle of cloning or updating the vibe-motion/procedural-fish repository and rendering its Remotion-based fish animation to video. Handles git operations intelligently (fetch, checkout, pull if the repo exists locally, otherwise fresh clone), then invokes the project's own pnpm render command with sensible defaults: transparent MOV output and a default props preset. You can override the output path or swap in custom render presets if you're iterating on animation parameters. Useful when you want a one-liner to go from repository URL to rendered video without manually managing dependencies or build steps. The script assumes python3 and handles skill directory resolution across common agent environments.

skills.sh installs: 1.1K
GitHub stars: 1.6K
last updated: Aug 21, 2026

View on GitHub

Install

$ npx -y skills add vibe-motion/skills --skill procedural-fish-render --agent claude-code

Installs into .claude/skills of the current project.

Files

Procedural Fish Render

Workflow

Resolve skill_dir and run the helper script:

skill_dir=""
for base in "${AGENTS_HOME:-$HOME/.agents}" "${CLAUDE_HOME:-$HOME/.claude}" "${CODEX_HOME:-$HOME/.codex}"; do
  if [ -d "$base/skills/procedural-fish-render" ]; then
    skill_dir="$base/skills/procedural-fish-render"
    break
  fi
done
[ -n "$skill_dir" ] || { echo "procedural-fish-render skill not found under ~/.agents, ~/.claude, or ~/.codex"; exit 1; }

/usr/local/bin/python3 "$skill_dir/scripts/render_procedural_fish.py"

Optional parameters:

/usr/local/bin/python3 "$skill_dir/scripts/render_procedural_fish.py" \
  --workspace "$(pwd)" \
  --output "out/procedural-fish-custom.mov" \
  --props-file "shared/project/render-presets/default.json"