MM-prompter/README.md

35 lines
1.9 KiB
Markdown

# Moxie Multimedia Prompt Creator
An agent skill that turns a vague prompt plus a total video length (seconds) into a
ready-to-run generation package:
- `segments.txt` — N segment prompts in full-reference (ref2va) format, joined by `|`.
The video creator node splits the total length evenly across segments
(`N = max(1, round(total_seconds / 10))`) and generates them one by one.
- `Image-N.json` — one 16:9 character-sheet text-to-image prompt per character that
has no user-provided image reference, consumed one at a time by a ComfyUI workflow.
- `image-map.txt` — manifest mapping each `<Subject N>` to its image file
(user-provided filename or generated `Image-N.json`).
## Layout
| Path | Purpose |
| --- | --- |
| `SKILL.md` | Skill entry point: triggers, pipeline, output contract, validation checklist |
| `references/ref2va-segment-format.md` | Authoritative per-segment format (sections, labels, shots, audio template) |
| `references/t2i-character-sheet.md` | Character-sheet caption rules and the two-key JSON contract |
| `references/worked-example.md` | Complete end-to-end example, including the audio (singing) variant |
| `scripts/validate_outputs.py` | Optional validator the agent can run on its outputs |
| `segment-guide.md`, `t2i-prompt-rules/` | Source rule documents the skill was adapted from |
## Usage
1. Pull this repo into your agent's skills folder so that `SKILL.md` is discoverable.
2. Give the agent a vague scene prompt and the total video length in seconds, plus
optionally: song lyrics, an audio file mention (e.g. "use midnight.mp3"),
per-character image references, and style hints.
3. The agent writes `segments.txt`, `Image-N.json` for characters lacking references,
and `image-map.txt` into the project folder.
4. Verify before use: `python3 scripts/validate_outputs.py --segments segments.txt
--expected-n <N> [--dir .] [--lyrics-file lyrics.txt]`