diff --git a/README.md b/README.md index 656f8ba..490cf95 100644 --- a/README.md +++ b/README.md @@ -1,3 +1,34 @@ # Moxie Multimedia Prompt Creator -the how to use will be filled in here \ No newline at end of file +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 `` 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 [--dir .] [--lyrics-file lyrics.txt]` diff --git a/SKILL.md b/SKILL.md new file mode 100644 index 0000000..d0f6e2b --- /dev/null +++ b/SKILL.md @@ -0,0 +1,143 @@ +--- +name: mm-prompter +description: Writes multi-segment ref2va video prompts plus T2I character-sheet prompts from a vague scene idea and a total video length in seconds. Use when the user gives a rough video/scene concept (optionally with song lyrics or an audio file name) and wants numbered video-generation segments joined by "|", character sheets as Image-N.json for characters that lack an image reference, and an image-map.txt manifest. +--- + +# MM Prompt Creator + +Turn one vague prompt and one number (total seconds) into a complete, ready-to-run +generation package: + +1. `segments.txt` — N segment prompts in full-reference (ref2va) format, joined by `|`. + The downstream video creator node splits the total length evenly across segments and + generates them one by one. +2. `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. +3. `image-map.txt` — manifest that says which `` maps to which image file. + +Read `references/ref2va-segment-format.md` before drafting the first segment, and +`references/t2i-character-sheet.md` before writing the first JSON. A complete end-to-end +example (including the audio variant) is in `references/worked-example.md`. + +## Inputs + +| Input | Required | Notes | +| --- | --- | --- | +| Vague prompt | yes | Rough scene/idea text from the user | +| Total video length in seconds | yes | Drives segment count | +| Song lyrics | no | Guide pacing only; NEVER appear in any output | +| Audio file mention | no | e.g. "use midnight.mp3" → enables `