{
  "path": {
    "schema_version": "1.0.0",
    "path_id": "product-screenshots-to-promo-video",
    "path_version": 1,
    "status": "partial",
    "commercial_ready": false,
    "title": "Product screenshots to a directed promo video",
    "short_title": "Screenshots → promo video",
    "summary": "Use video-shotcraft for shot direction and the official Remotion skills for implementation discipline, then verify the rendered file.",
    "outcome": "A reproducible Remotion project and rendered promo video, with a shot plan and technical verification report.",
    "match_terms": [
      {
        "term": "promo video",
        "weight": 8
      },
      {
        "term": "launch video",
        "weight": 8
      },
      {
        "term": "product video",
        "weight": 7
      },
      {
        "term": "product demo",
        "weight": 6
      },
      {
        "term": "teaser",
        "weight": 6
      },
      {
        "term": "motion video",
        "weight": 6
      },
      {
        "term": "social video",
        "weight": 6
      },
      {
        "term": "remotion",
        "weight": 7
      },
      {
        "term": "screenshots",
        "weight": 4
      },
      {
        "term": "video",
        "weight": 3
      },
      {
        "term": "宣传视频",
        "weight": 8
      },
      {
        "term": "发布视频",
        "weight": 8
      },
      {
        "term": "产品视频",
        "weight": 7
      },
      {
        "term": "宣传片",
        "weight": 8
      },
      {
        "term": "产品演示视频",
        "weight": 8
      },
      {
        "term": "动效视频",
        "weight": 7
      },
      {
        "term": "短视频",
        "weight": 6
      },
      {
        "term": "产品截图",
        "weight": 4
      },
      {
        "term": "视频",
        "weight": 3
      }
    ],
    "supported_agents": [
      "claude-code"
    ],
    "starting_points": [
      "files",
      "idea"
    ],
    "priority_fit": {
      "best-quality": 5,
      "fastest": 3,
      "leanest": 2,
      "most-private": 4
    },
    "required_inputs": [
      "Product screenshots or a product URL",
      "One-sentence product promise",
      "Target duration and aspect ratio"
    ],
    "outputs": [
      "Shot plan",
      "Remotion project",
      "Rendered MP4",
      "Video metadata verification report"
    ],
    "required_output_types": [
      "video/mp4"
    ],
    "nodes": [
      {
        "node_id": "shot-plan",
        "node_type": "skill",
        "stage": "Direct the sequence",
        "tested_ref": "video-shotcraft",
        "purpose": "Turn the product story into deliberate shots, timing, transitions, and a still ending rather than an undirected animation.",
        "input": "Product screenshots, product promise, duration, and aspect ratio",
        "output": "shot-plan.md",
        "verification": "function_verified",
        "instruction": "Follow video-shotcraft's required template-versus-free-form choice, then write a frame-addressed shot plan before implementation.",
        "human_confirmation": true
      },
      {
        "node_id": "implementation",
        "node_type": "skill",
        "stage": "Implement in Remotion",
        "tested_ref": "remotion-skills",
        "purpose": "Translate the approved shot plan into a technically correct, editable Remotion composition.",
        "input": "shot-plan.md and normalized product assets",
        "output": "remotion-project/",
        "verification": "function_verified",
        "instruction": "Use the official timing, animation, asset, and project-structure rules while preserving the shot plan's visual direction.",
        "human_confirmation": false
      },
      {
        "node_id": "render-verification",
        "node_type": "verify",
        "stage": "Render and verify",
        "tested_ref": null,
        "purpose": "Prove that the deliverable exists and meets its mechanical contract before subjective review.",
        "input": "remotion-project/",
        "output": "promo.mp4 and verification.json",
        "verification": "unverified",
        "instruction": "Render with a pinned browser executable, then inspect codec, duration, resolution, frame rate, file size, and playback.",
        "human_confirmation": true
      }
    ],
    "evidence_refs": [
      "video-comparison-2026-07-25"
    ],
    "known_limits": [
      "The published comparison used a fixed typography-and-check brief, not user screenshots.",
      "Only still frames are currently public; the final MP4 is not yet downloadable.",
      "Repeat-run workflow success has not been measured.",
      "Headless environments may need a local chrome-headless-shell and concurrency set to one."
    ],
    "next_test": "Run one fixed six-screenshot product pack through the complete path three times, publish the MP4 and source project, and verify duration, resolution, playback, and repeat success."
  },
  "evidence": [
    {
      "schema_version": "1.0.0",
      "evidence_id": "video-comparison-2026-07-25",
      "evidence_type": "comparison-run",
      "date": "2026-07-25",
      "title": "Same five-second brief rendered with video-shotcraft and Remotion official skills",
      "scope": "Both skill methodologies produced a working 150-frame Remotion scene from the same fixed brief. Setup, render timings, failures, output bytes, and frame 75 were recorded.",
      "not_verified": "A user-supplied screenshot-to-video workflow, repeat-run success rate, public MP4 download, audio, or a fifteen-second final promo.",
      "source_ref": "video-shotcraft-vs-remotion-skills",
      "source_url": "/compare/video-shotcraft-vs-remotion-skills/",
      "environment": {
        "os": "Linux 6.8, arm64, 2 cores",
        "node": "v22.22.3",
        "remotion": "4.0.484"
      },
      "metrics": [
        "video-shotcraft: 13.8s render for 150 frames",
        "Remotion official skills: 13.5s render for 150 frames",
        "Both routes required a local chrome-headless-shell in the constrained environment"
      ],
      "artifacts": [
        {
          "label": "video-shotcraft frame 75",
          "type": "image",
          "path": "/assets/compare/video-shotcraft-frame75.png",
          "alt": "video-shotcraft result: centered typewriter title with a green circular check badge"
        },
        {
          "label": "Remotion official skills frame 75",
          "type": "image",
          "path": "/assets/compare/remotion-skills-frame75.png",
          "alt": "Remotion official skills result: left-aligned title with a green check glyph"
        }
      ]
    }
  ],
  "tested_skills": {
    "video-shotcraft": {
      "skill": "video-shotcraft",
      "repo": "Vincentwei1021/video-shotcraft",
      "stars": 2561,
      "stars_date": "2026-07-29",
      "stars_note": "Dated readings are retained in the comparison record. Stars are discovery context, not the verdict.",
      "commit_hash": "d491544",
      "install_cmd": "npx skills add Vincentwei1021/video-shotcraft -a claude-code -y",
      "env": {
        "os": "macOS arm64",
        "node": "v24.14.0",
        "package manager": "pnpm 11.9.0"
      },
      "install_time_sec": 42.54,
      "install_note": "Fresh skills-CLI install: 51.1MB, 660 files, 104 shot cards, bundled audio, and a Remotion 4.0.484 template.",
      "template_npm_install_sec": 124.79,
      "failures": [
        {
          "step": "pnpm dependency install",
          "error": "pnpm returned ERR_PNPM_IGNORED_BUILDS for esbuild after installing the packages; the subsequent Remotion render still completed.",
          "fix": "Use the template's npm workflow, or approve esbuild's build script when standardizing on pnpm. Do not treat the warning alone as a failed render."
        }
      ],
      "verification_level": "effect_verified",
      "verified_scope": "Fresh current-commit install plus a full five-second 1920x1080 MP4 render with visible motion and an AAC audio track; playback frames and media streams were checked.",
      "not_verified": "Repeated-run consistency, user-supplied product assets, captions, publishing, or a full revision workflow.",
      "verification_evidence": "/alternative/remotion-skills/",
      "min_test": {
        "what": "build and render the shared 150-frame comparison scene from the current bundled template",
        "result": "playable H.264 MP4 with AAC audio; 1920x1080, 30fps, 5.056 seconds",
        "time_sec": 151.64
      },
      "structure": "Bilingual trigger + Chinese-first SKILL.md; 104 shot cards; templates, scripts, and bundled attributed audio; 660 installed files.",
      "notes": "The current default payload is 51.1MB, substantially slimmer than the July 23 build. Its main value remains production direction: composition, timing, easing, and sound choices before rendering.",
      "tested_date": "2026-07-29",
      "skills_installed": 1
    },
    "remotion-skills": {
      "skill": "remotion skills (official, 11-skill pack)",
      "repo": "remotion-dev/skills",
      "stars": 4135,
      "stars_date": "2026-07-29",
      "stars_note": "Stars are discovery context, not the verdict.",
      "commit_hash": "0e444ef",
      "install_cmd": "npx skills add remotion-dev/skills -a claude-code -s '*' -y",
      "env": {
        "os": "macOS arm64",
        "node": "v24.14.0",
        "package manager": "pnpm 11.9.0"
      },
      "install_time_sec": 4.12,
      "failures": [
        {
          "step": "pnpm dependency install",
          "error": "pnpm returned ERR_PNPM_IGNORED_BUILDS for esbuild after installing the packages; the subsequent Remotion render still completed.",
          "fix": "Use the scaffold's npm workflow, or approve esbuild's build script when standardizing on pnpm. Do not treat the warning alone as a failed render."
        }
      ],
      "verification_level": "effect_verified",
      "verified_scope": "All 11 current skills installed, current scaffold created successfully, internal reference routes resolved, and the shared five-second 1920x1080 MP4 rendered with motion and AAC audio.",
      "not_verified": "Repeated-run consistency, user-supplied product assets, captions, publishing, or a full revision workflow.",
      "verification_evidence": "/alternative/remotion-skills/",
      "min_test": {
        "what": "install all 11 skills, scaffold a blank current project, and render the shared 150-frame scene",
        "result": "11 skills installed; playable H.264 MP4 with AAC audio; 1920x1080, 30fps, 5.056 seconds",
        "time_sec": 394.08
      },
      "notes": "The current pack includes 11 top-level skills. The July 25 scaffold and post-install hub-link failures are resolved in this commit. It supplies broad implementation correctness, not a visual direction system.",
      "tested_date": "2026-07-29",
      "skills_installed": 11
    }
  }
}