---
name: automovie-editor
description: "AUTOMOVIE cycling video auto-narration and telemetry overlay pipeline skill. Use when the user provides cycling/sports video media and a Garmin FIT telemetry file, and asks to automatically synchronize, write AI narration, synthesize TTS audio, overlay ASS telemetry gauges (speed, heart rate, power, gradient), and render a final video."
---

# AUTOMOVIE Editor Skill

Automate the full end-to-end sports video narration, telemetry overlay, and single-pass FFmpeg rendering pipeline.

## Prerequisites and Local Server

1. Ensure the AUTOMOVIE FastAPI server is running on `http://127.0.0.1:8765`.
2. Ensure both the source video file (`.mp4` / `.mov`) and the Garmin telemetry file (`.fit`) exist on the local file system.

## One-Click Auto Pipeline Workflow

To trigger the end-to-end pipeline automatically via API:

```bash
curl -X POST http://127.0.0.1:8765/api/projects/auto \
  -H "Content-Type: application/json" \
  -d '{
    "video_path": "<path-to-video.mp4>",
    "fit_path": "<path-to-ride.fit>",
    "voice": "zh-TW-YunJheNeural",
    "resolution": "1080p",
    "context": "<optional-context>",
    "dashboard_enabled": true
  }'
```

## Response and Progress Monitoring

The API returns a JSON object containing `id` (Project ID) and `job` (Job ID):
```json
{
  "id": "20260805_194356",
  "job": "2b470832"
}
```

Poll job progress via:
```bash
curl http://127.0.0.1:8765/api/job/<job-id>
```

When `status` reaches `"done"`, the output video is rendered and saved under `app/projects/<pid>/<output.mp4>`, ready for in-page playback at `http://127.0.0.1:8765/api/p/<pid>/output`.
