35 lines
1.9 KiB
Markdown
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]`
|