Agent skill for narrated cinematic films built entirely from code: one continuous camera over photos, maps and cards, timed to the voice. Claude Code, Codex, Cursor, Gemini CLI.
#!/usr/bin/env bash
# Install Cinematic Skill for every coding agent on this machine, without Node.
# (With Node 22.20+, `npx skills add Moh4696/cinematic-skill` does the same.)
#
# curl -fsSL https://raw.githubusercontent.com/Moh4696/cinematic-skill/main/install.sh | bash
#
# Run from the internet, it clones the repo to ~/.cinematic-skill (or updates it) and links the
# skills from there, so `bash ~/.cinematic-skill/install.sh` again (or a git pull) updates them.
# Run from a clone, it links from that clone.
#
# ./install.sh every agent found: Claude Code, Codex, Cursor, Gemini CLI, OpenCode
# ./install.sh --claude --codex only these (also --cursor --gemini --opencode --agents)
# ./install.sh --dir PATH into any skills folder
# ./install.sh --copy copy instead of symlink (Windows, synced folders)
# ./install.sh cinematic-film only this skill, by name
# ./install.sh --list show the skills
# ./install.sh --uninstall remove links and copies this script made
#
# Needs bash and git. Nothing else is installed; the skills' own scripts list what they use.
set -euo pipefail
REPO_URL="https://github.com/Moh4696/cinematic-skill.git"
HOME_CLONE="${CINEMATIC_HOME:-$HOME/.cinematic-skill}"
MARK=".cinematic-skill"
SELF="${BASH_SOURCE[0]:-}"
REPO=""
if [[ -n $SELF && -f $SELF ]]; then REPO="$(cd "$(dirname "$SELF")" && pwd)"; fi
# piped from curl (or run outside a clone): fetch the repo, then run the copy inside it
if [[ -z $REPO || ! -d $REPO/skills ]]; then
command -v git >/dev/null || { echo "git is required" >&2; exit 1; }
if [[ -d $HOME_CLONE/.git ]]; then
echo "updating $HOME_CLONE"
git -C "$HOME_CLONE" pull --ff-only --quiet
else
echo "cloning to $HOME_CLONE"
git clone --depth 1 --quiet "$REPO_URL" "$HOME_CLONE"
fi
exec bash "$HOME_CLONE/install.sh" "$@"
fi
SKILLS_DIR="$REPO/skills"
targets=()
mode=install
copy=0
wanted=()
add_target() { targets+=("$1"); }
while [[ $# -gt 0 ]]; do
case "$1" in
--claude) add_target "$HOME/.claude/skills" ;;
--codex) add_target "${CODEX_HOME:-$HOME/.codex}/skills" ;;
--cursor) add_target "$HOME/.cursor/skills" ;;
--gemini) add_target "$HOME/.gemini/skills" ;;
--opencode) add_target "$HOME/.config/opencode/skills" ;;
--agents) add_target "$HOME/.agents/skills" ;;
--dir) shift; add_target "${1:?--dir needs a path}" ;;
--copy) copy=1 ;;
--list) mode=list ;;
--uninstall) mode=uninstall ;;
-h|--help) awk 'NR>1 { if ($0 !~ /^#/) exit; sub(/^# ?/, ""); print }' "$REPO/install.sh"; exit 0 ;;
-*) echo "unknown flag: $1" >&2; exit 2 ;;
*) wanted+=("$1") ;;
esac
shift
done
# no agent named: every agent whose home folder exists
if [[ ${#targets[@]} -eq 0 ]]; then
[[ -d $HOME/.claude ]] && add_target "$HOME/.claude/skills"
[[ -d ${CODEX_HOME:-$HOME/.codex} ]] && add_target "${CODEX_HOME:-$HOME/.codex}/skills"
[[ -d $HOME/.cursor ]] && add_target "$HOME/.cursor/skills"
[[ -d $HOME/.gemini ]] && add_target "$HOME/.gemini/skills"
# OpenCode also reads ~/.claude/skills; linking both would list every skill twice
[[ -d $HOME/.config/opencode && ! -d $HOME/.claude ]] && add_target "$HOME/.config/opencode/skills"
if [[ ${#targets[@]} -eq 0 ]]; then
echo "no coding agent found; installing to ~/.claude/skills (use --dir for another place)"
add_target "$HOME/.claude/skills"
fi
fi
# frontmatter name: of a SKILL.md, falling back to the folder name
skill_name() {
awk 'NR==1 && $0!="---" { exit } NR>1 && /^---[[:space:]]*$/ { exit }
NR>1 && /^name:/ { sub(/^name:[[:space:]]*/, ""); gsub(/^["'\'']|["'\'']$/, ""); print; exit }' "$1"
}
wants() {
[[ ${#wanted[@]} -eq 0 ]] && return 0
local w; for w in "${wanted[@]}"; do [[ $w == "$1" ]] && return 0; done
return 1
}
# true if PATH is a link into this repo, or a copy this script made
ours() {
local p="$1"
if [[ -L $p ]]; then [[ "$(readlink "$p")" == "$SKILLS_DIR"/* ]]; return; fi
[[ -f $p/$MARK ]]
}
if [[ $mode == uninstall ]]; then
for t in "${targets[@]}"; do
[[ -d $t ]] || continue
for d in "$SKILLS_DIR"/*/; do
n="$(skill_name "$d/SKILL.md")"; n="${n:-$(basename "$d")}"
p="$t/$n"
if [[ -e $p || -L $p ]] && ours "$p"; then rm -rf "$p"; echo "removed $p"; fi
done
done
exit 0
fi
names=()
for d in "$SKILLS_DIR"/*/; do
d="${d%/}"
[[ -f $d/SKILL.md ]] || continue
n="$(skill_name "$d/SKILL.md")"; n="${n:-$(basename "$d")}"
names+=("$n")
wants "$n" || continue
if [[ $mode == list ]]; then printf '%-16s %s\n' "$n" "skills/$(basename "$d")"; continue; fi
for t in "${targets[@]}"; do
mkdir -p "$t"
p="$t/$n"
if [[ -e $p || -L $p ]]; then
if ours "$p"; then rm -rf "$p"
else echo "skip $p (something else is installed there; move it aside first)" >&2; continue; fi
fi
if [[ $copy == 1 ]]; then cp -R "$d" "$p"; touch "$p/$MARK"; echo "copied $p"
else ln -s "$d" "$p"; echo "linked $p"; fi
done
done
if [[ ${#wanted[@]} -gt 0 ]]; then
for w in "${wanted[@]}"; do
found=0; for n in "${names[@]}"; do [[ $n == "$w" ]] && found=1; done
[[ $found == 1 ]] || { echo "no skill named '$w'; available: ${names[*]}" >&2; exit 1; }
done
fi
[[ $mode == list ]] || echo "done. Start a new agent session to load the skills."