Skill: Calibrate from Video Files

When to Use This Skill

Activate this skill when the user has pre-recorded MP4 files and wants to calibrate them via the AMC REST API. Typical prompts:

• "calibrate my videos" / "run AMC on these videos"
• "calibrate from video files"

Drives calibration through the REST API on user-supplied pre-recorded MP4 files, no CLI scripts or Docker bind-mounts required, just a running microservice and your files.

Do not use this skill for live RTSP streams or rtsp://... URLs; route those requests to skills/amc-run-rtsp-calibration/SKILL.md.

Purpose

Guide the agent through project creation, sorted MP4 upload, local asset resolution, UI fallback only when necessary, project verification, calibration, polling, evaluation, and optional VGGT refinement for a user-provided multi-camera dataset.

Prerequisites

• AMC microservice and UI running (follow skills/amc-setup-calibration-stack/SKILL.md)
• You know the microservice URL (use https://<HOST_IP>:<MS_PORT> for remote AMC, or http://localhost:<MS_PORT> on loopback) and UI URL
• Video files locally as contiguous cam_00.mp4, cam_01.mp4, … time-synchronized, ~1920×1080
• Python 3 with requests
• If AMC stores project outputs outside the default projects/ directory, you know the host PROJECTS_DIR

Interaction Model

• The "host's question mechanism" means the runtime's built-in prompt API for short user decisions, such as terminal stdin, an IDE ask tool, or an equivalent interactive dialog.
• If that mechanism is unavailable, ask in chat and wait before any guarded step that requires user confirmation or a missing-file decision.
• For unattended runs, the bundled script requires all non-UI inputs up front and exits before /calibrate unless CONFIRM_CALIBRATION=true is set. RUN_VGGT=true remains a separate opt-in for the optional VGGT step.

Data Privacy