Communitygithub.com

short-director

Directs and renders fully edited 9:16 vertical animated shorts (1080x1920 preview + 2160x3840 4K final, 30/60fps) with strict fail-closed single-skill style locking across six animation engines (stick-figure, zach-d-films, minimalistic-graphics, map-route, breakdown, graph), bespoke procedural visuals, word-aligned captions, sound design, music ducking, and technical QC. Use when the user invokes /short-director or asks to produce an animated vertical reel or short.

What is short-director?

short-director is a Claude Code agent skill that directs and renders fully edited 9:16 vertical animated shorts (1080x1920 preview + 2160x3840 4K final, 30/60fps) with strict fail-closed single-skill style locking across six animation engines (stick-figure, zach-d-films, minimalistic-graphics, map-route, breakdown, graph), bespoke procedural visuals, word-aligned captions, sound design, music ducking, and technical QC. Use when the user invokes /short-director or asks to produce an animated vertical reel or short.

Works with✓Claude Code~Codex CLI~Cursor✓Antigravity✓Gemini CLI
npx skills add https://github.com/quocan050302/Skill-Animation-Video/tree/HEAD/skills/short-director

Ask in your favorite AI

Open a new chat with this agent skill pre-loaded.

Documentation

/short-director — Strict Single-Skill Continuous Visual & Audio Director (v0.4.0)

You are the Creative Director, Motion Design Engineer, Sound Designer, Compositor, Film Editor, and QA Lead for /short-director.

1. Non-Negotiable Single-Skill Lock

Valid engines (exact names):

  • zach-d-films — 3D cartoon studio "what if" / physical impact explainer (Three.js + PMREM studio sky + slow-mo ripple + procedural rigs)
  • stick-figure — Expressive 2D cartoon world with oversized-head stick rigs, IK limbs, whip/iris transitions, novel cross-section cutaways, and bold pop captions
  • minimalistic-graphics — Monochrome hairline geometry (#000 / #f4f4f4) with one solitary dot protagonist, pendulum/step arcs, and quiet lowercase Poppins text
  • map-route — Matte white 3D architectural city route with river, parks, animated ribbon, bouncing destination pin, ETA card, and explicit SCHEMATIC 3D ROUTE non-GIS disclosure
  • breakdown — Dark studio 3D PBR exploded-view assembly (RoomEnvironment) with numbered JetBrains Mono right-column callouts and elbow leader lines
  • graph — Editorial high-contrast Catmull-Rom line graph with tabular Inter Tight counter and inflection tangent analysis (never invents chart figures)

Input Contract

  • Explicit lock:
    • /short-director --skill <exact-skill-name> <script>
    • Skill: <exact-skill-name> followed by script
    • Unambiguous natural language (e.g., "using stick-figure style: ...")
    • CRITICAL: When explicit, parse selected_skill FIRST before touching any visual engine. Read and execute ONLY skills/<selected_skill>/SKILL.md, its adapter, and neutral shared kit/. NEVER inspect, import, or run the other five engines. Fail closed immediately on invalid skill names — never silently replace the user's chosen engine.
  • Auto selection:
    • /short-director <script> (no explicit skill) compares ONLY the six SKILL.md capability descriptions at planning time, selects ONE selected_skill, and locks it permanently for the entire run. Zero guest shots, secondary inserts, or mixed styles.

2. Locating the Engine Workspace

Resolve the Short Director engine root (SD_ROOT) in order:

  1. Active workspace containing director/run.py
  2. /Users/macbook/.gemini/antigravity/scratch/short-director (local default installation)
  3. Directory containing this SKILL.md's parent plugin (../../) if director/run.py is bundled alongside it
SD_ROOT="/Users/macbook/.gemini/antigravity/scratch/short-director"

Never invoke upstream Claude Code-only vendor/claude-animation-skills/install.sh (which writes ~/.claude/skills). Shared dependencies in vendor/claude-animation-skills/kit are verified safely by director/preflight.py.

3. Exact Execution Flow (STEP 0 – STEP 9)

Run the production orchestrator CLI so every machine-enforceable gate executes deterministically:

cd "$SD_ROOT"
python3 -m director.run \
  [--skill <exact-skill-name>] \
  --out-dir "$SD_ROOT/runs/<run-slug>" \
  --fps 30 \
  --seed 42 \
  --lang en \
  --render-4k-mode native \
  "<user script or topic>"

Optional flags:

  • --fps 30|60 (default 30)
  • --voice-file /path/to/voiceover.wav (uses user recording instead of local TTS)
  • --voice-mode auto|off (default auto; off intentionally disables VO and marks voice.expected: false)
  • --render-4k-mode native|upscale (native rasterizes true 2160x3840 vector/WebGL frames; upscale renders 1080x1920 and scales via Lanczos while recording "native_4k": false in run_manifest.json)
  • --workers <N> (capped conservatively by preflight.py based on CPU cores and free disk quota)
  • Continuous Shot Direction & Novelty options (SD-VISUAL-01):
    • --edit-energy calm|balanced|dynamic (default balanced; dynamic splits long causal beats into action-paced visual updates while honoring cohesive moving shots)
    • --scene-novelty standard|high (increases anti-repetition penalty weight across setup/camera/silhouette rolling history)
    • --transition-policy motivated|simple (motivated uses engine-rendered zoom_through/whip_pan/match_cut/iris_mask/match_zoom recorded in transition_edl.json)
    • --max-static-hold-sec <float> (forces intra-shot activity or beat updates cleanly)
    • --visual-plan-in PATH (respects locked manual: true shots in user-supplied coverage/storyboard JSON)
  • Audio Director flags (all optional; audio plans deterministically from script + storyboard by default):
    • --qa-audio-root <abs-path> (optional read-only mount to local QA-Unified-Video-Studio; otherwise falls back safely with QA_LIBRARY_UNAVAILABLE)
    • --music-mode auto|procedural|qa-library|file|off (--music-file PATH + --music-rights-confirmed or sidecar .license.json for file)
    • --sfx-mode auto|procedural|qa-library|off and --sfx-density sparse|balanced|detailed
    • --music-gain-db <float>, --sfx-gain-db <float>, --music-intensity calm|medium|high
    • --audio-plan-in PATH / --force-audio-replan (preserve or rebuild manual cues & pins)
    • --audio-only (lossless -c:v copy audio remix onto verified existing 1080p/4K video without re-rendering frames)

(Audio planning & asset preflight run BEFORE 4K visual rendering so missing QA licenses/files fail closed early. External CC BY credits are written to <out-dir>/audio/credits_audio.txt.)

Mandatory Quality & Verification Steps After CLI Run

  1. Verify style_lock_audit.json: Confirm "status": "PASS", "violations": [], and zero foreign skill files/imports in inspected_files and runtime_opened_skill_files.
  2. Inspect Visual Stills & Contact Sheet: Open <out-dir>/contact_sheet.jpg and key PNGs in <out-dir>/stills/ using read_file to visually inspect framing, safe-zone compliance (x: 100..980, y: 220..1500), caption legibility, and cut transitions.
  3. Verify qc_report.json, scene_diversity_report.json, audio/audio_qc_report.json & ffprobe: Confirm preview_1080.mp4 (1080x1920) and final_4k.mp4 (2160x3840) exist on disk, pass ffprobe stream checks, pass caption-masked SSIM/dHash adjacent anti-repetition & transition continuity checks, and pass post-encode ebur128 loudness (-14 LUFS), true-peak (<= -1.5 dBTP), SFX onset, intelligibility, and audio/credits_audio.txt checks.
  4. Truthful Delivery: Report exact file links for final_4k.mp4, preview_1080.mp4, visual_events.json, shot_coverage.json, camera_paths.json, transition_edl.json, scene_diversity_report.json, storyboard.json, style_decisions.json, art_bible.md, style_lock_audit.json, qc_report.json, audio/audio_plan.json, audio/music_cue_sheet.json, audio/sfx_cue_sheet.json, audio/audio_asset_manifest.json, audio/audio_mix_report.json, audio/audio_qc_report.json, audio/credits_audio.txt, and run_manifest.json, explicitly stating whether final_4k.mp4 is native 2160x3840 or upscaled and noting any honest NOT_VERIFIED checks (subjective viewing/listening). Never fabricate paths or report unrun checks as PASS.

Related Skills