---
name: story-repair
description: Use when Alex asks Hermes to repair specific scenes or shots in a video-story project, usually by referencing director's cut labels like scene 2 shot 4 and providing creative repair instructions.
version: 1.0.0
author: Hermes Agent
license: MIT
metadata:
  hermes:
    tags: [story, repair, video-story, directors-cut]
    related_skills: [story, story-yolo, systematic-debugging]
---

# /story-repair — Scene/Shot Repair Director

## Overview

Use this when Alex gives repair notes for an existing `video-story` project. The director's cut overlays `SCENE N · SHOT M`, so Alex can say things like “repair scene 2 shot 4: make the dog face camera and keep the red jacket.”

## Inputs to Extract

- Project ID or URL. If missing, use the most recent video-story project if unambiguous; otherwise ask for the project link/ID.
- Target scene numbers.
- Target shot numbers or scene+shot tuples.
- Repair instruction: visual, continuity, motion, dialogue, pacing, style, safety/NSFW workaround.
- Whether to regenerate frames, video, lipsync, final clean cut, and/or director's cut.

## API

Base:

```bash
BASE=http://localhost:4015
TOKEN="$HERMES_AUTOMATION_TOKEN"
```

Production map:

```bash
curl -sS "$BASE/api/hermes/projects/$PROJECT_ID/production-map" \
  -H "Authorization: Bearer $TOKEN"
```

Repair:

```bash
curl -sS -X POST "$BASE/api/hermes/projects/$PROJECT_ID/repair" \
  -H "Authorization: Bearer $TOKEN" -H 'Content-Type: application/json' \
  -d '{
    "instructions": "...",
    "shots": [{"scene_number": 2, "shot_number": 4}],
    "regenerate_frames": true,
    "regenerate_video": true,
    "lipsync": true,
    "directors_cut": true
  }'
```

Status:

```bash
curl -sS "$BASE/api/hermes/projects/$PROJECT_ID/repair-status" \
  -H "Authorization: Bearer $TOKEN"
```

Director's cut:

```bash
curl -sS -X POST "$BASE/api/hermes/projects/$PROJECT_ID/assemble-directors-cut" \
  -H "Authorization: Bearer $TOKEN"
```

## Repair Strategy

- Fetch the production map first so the repair is anchored in current scenes, shots, characters, sets, props, and references.
- If Alex names only a scene, repair all shots in that scene.
- If Alex names a shot without scene and shot numbers repeat, ask or infer from context.
- Preserve canon: character identity, wardrobe, environment, prop continuity.
- Prefer precise prompt additions over broad style changes.
- For bad motion, simplify action and camera movement rather than overprompting.
- For lip sync failures, regenerate video and lipsync only dialogue shots.
- After repair, produce a new director's cut unless Alex asks for clean final only.

## Response Format

- Repair started: project + target scene/shot list + directive summary.
- While pending: percent/message from repair status.
- Complete: director's cut URL/path + ask for next notes by scene/shot label.

## Verification Checklist

- [ ] Project/targets resolved.
- [ ] Production map checked.
- [ ] Repair API accepted request.
- [ ] Status polled to completion or reported actionable failure.
- [ ] Director's cut updated when requested.