@vodailoc/kilo-kit-mcp 1.1.0 → 1.2.0

package/skills/ai-media/sora/references/prompting.md

@@ -1,137 +1,137 @@
-# Prompting best practices (Sora)
-
-## Contents
-- [Mindset & tradeoffs](#mindset--tradeoffs)
-- [API-controlled params](#api-controlled-params)
-- [Structure](#structure)
-- [Specificity](#specificity)
-- [Style & visual cues](#style--visual-cues)
-- [Camera & composition](#camera--composition)
-- [Motion & timing](#motion--timing)
-- [Lighting & palette](#lighting--palette)
-- [Character continuity](#character-continuity)
-- [Multi-shot prompts](#multi-shot-prompts)
-- [Ultra-detailed briefs](#ultra-detailed-briefs)
-- [Image input](#image-input)
-- [Constraints & invariants](#constraints--invariants)
-- [Text, dialogue & audio](#text-dialogue--audio)
-- [Avoiding artifacts](#avoiding-artifacts)
-- [Remixing](#remixing)
-- [Iterate deliberately](#iterate-deliberately)
-
-## Mindset & tradeoffs
-- Treat the prompt like a cinematography brief, not a contract.
-- The same prompt can yield different results; rerun for variants.
-- Short prompts give more creative freedom; longer prompts give more control.
-- Shorter clips tend to follow instructions better; consider stitching two 4s clips instead of a single 8s if precision matters.
-
-## API-controlled params
-- Model, size, and seconds are controlled by API params, not prose.
-- Put desired duration in the `seconds` param; the prompt cannot make a clip longer.
-
-## Structure
-- Use short labeled lines; omit sections that do not matter.
-- Keep one main subject and one main action.
-- Put timing in beats or counts if it matters.
-- If you prefer a prose-first template, use:
-```
-<Prose scene description in plain language. Describe subject, setting, time of day, and key visual details.>
-
-Cinematography:
-Camera shot: <framing + angle>
-Mood: <tone>
-
-Actions:
-- <clear action beat>
-- <clear action beat>
-
-Dialogue:
-<short lines if needed>
-```
-
-## Specificity
-- Name the subject and materials (metal, fabric, glass).
-- Use camera language (lens, angle, shot type) for stability.
-- Describe the environment with time of day and atmosphere.
-
-## Style & visual cues
-- Set style early (e.g., "1970s film", "IMAX-scale", "16mm black-and-white").
-- Use visible nouns and verbs, not vague adjectives.
-- Weak: "A beautiful street at night."
-- Strong: "Wet asphalt, zebra crosswalk, neon signs reflecting in puddles."
-
-## Camera & composition
-- Prefer one camera move: dolly, orbit, lateral slide, or locked-off.
-- Straight-on framing is best for UI and text.
-- For close-ups, use longer lenses (85mm+); for wide scenes, 24-35mm.
-- Depth of field is a strong lever: shallow for subject isolation, deep for context.
-- Example framings: wide establishing, medium close-up, aerial wide, low angle.
-- Example camera motions: slow tilt, gentle handheld drift, smooth lateral slide.
-
-## Motion & timing
-- Use short beats: "0-2s", "2-4s", "4-6s".
-- Keep actions sequential, not simultaneous.
-- For 4s clips, limit to 1-2 beats.
-- Describe actions as counts or steps when possible (e.g., "takes four steps, pauses, turns in the final second").
-
-## Lighting & palette
-- Describe light quality and direction (soft window light, hard rim, backlight).
-- Name 3-5 palette anchors to stabilize color across shots.
-- If continuity matters, keep lighting logic consistent across clips.
-
-## Character continuity
-- Keep character descriptors consistent across shots; reuse phrasing.
-- Avoid mixing competing traits that can shift identity or pose.
-
-## Multi-shot prompts
-- You can describe multiple shots in one prompt, but keep each shot block distinct.
-- For each shot, specify one camera setup, one action, one lighting recipe.
-- Treat each shot as a creative unit you can later edit or stitch.
-
-## Ultra-detailed briefs
-- Use when you need a specific, filmic look or strict continuity.
-- Call out format/look, lensing/filters, grade/palette, lighting direction, texture, and sound.
-- If needed, include a short shot list with timing beats.
-
-## Image input
-- Use an input image to lock composition, character design, or set dressing.
-- The input image should match the target size and be jpg/png/webp.
-- The image anchors the first frame; the prompt describes what happens next.
-- If you lack a reference, generate one first and pass it as `input_reference`.
-
-## Constraints & invariants
-- State what must not change: "same shot", "same framing", "keep background".
-- Repeat invariants in every remix to reduce drift.
-
-## Text, dialogue & audio
-- Keep text short and specific; quote exact strings.
-- Specify placement and avoid motion blur.
-- For dialogue, use a dedicated block and keep lines short.
-- Label speakers consistently for multi-character scenes.
-- If silent, you can still add a small ambient sound cue to set rhythm.
-- Sora can generate audio; include an `Audio:` line and a short dialogue block when needed.
-- As a rule of thumb, 4s clips fit 1-2 short lines; 8s clips can handle a few more.
-
-Example:
-```
-Audio: soft ambient café noise, clear warm voiceover
-Dialogue:
-<dialogue>
-- Speaker: "Let's get started."
-</dialogue>
-```
-
-## Avoiding artifacts
-- Avoid multiple actions in 4-8 seconds.
-- Keep camera motion smooth and limited.
-- Add explicit negatives when needed: "avoid flicker", "avoid jitter", "no fast motion".
-
-## Remixing
-- Change one thing at a time: palette, lighting, or action.
-- Keep camera and subject consistent unless the change requests otherwise.
-- If a shot misfires, simplify: freeze the camera, reduce action, clear background, then add complexity back in.
-
-## Iterate deliberately
-- Start simple, then add one constraint per iteration.
-- If results look chaotic, reduce motion and simplify the scene.
-- When a result is close, pin it as a reference and describe only the tweak.
+# Prompting best practices (Sora)
+
+## Contents
+- [Mindset & tradeoffs](#mindset--tradeoffs)
+- [API-controlled params](#api-controlled-params)
+- [Structure](#structure)
+- [Specificity](#specificity)
+- [Style & visual cues](#style--visual-cues)
+- [Camera & composition](#camera--composition)
+- [Motion & timing](#motion--timing)
+- [Lighting & palette](#lighting--palette)
+- [Character continuity](#character-continuity)
+- [Multi-shot prompts](#multi-shot-prompts)
+- [Ultra-detailed briefs](#ultra-detailed-briefs)
+- [Image input](#image-input)
+- [Constraints & invariants](#constraints--invariants)
+- [Text, dialogue & audio](#text-dialogue--audio)
+- [Avoiding artifacts](#avoiding-artifacts)
+- [Remixing](#remixing)
+- [Iterate deliberately](#iterate-deliberately)
+
+## Mindset & tradeoffs
+- Treat the prompt like a cinematography brief, not a contract.
+- The same prompt can yield different results; rerun for variants.
+- Short prompts give more creative freedom; longer prompts give more control.
+- Shorter clips tend to follow instructions better; consider stitching two 4s clips instead of a single 8s if precision matters.
+
+## API-controlled params
+- Model, size, and seconds are controlled by API params, not prose.
+- Put desired duration in the `seconds` param; the prompt cannot make a clip longer.
+
+## Structure
+- Use short labeled lines; omit sections that do not matter.
+- Keep one main subject and one main action.
+- Put timing in beats or counts if it matters.
+- If you prefer a prose-first template, use:
+```
+<Prose scene description in plain language. Describe subject, setting, time of day, and key visual details.>
+
+Cinematography:
+Camera shot: <framing + angle>
+Mood: <tone>
+
+Actions:
+- <clear action beat>
+- <clear action beat>
+
+Dialogue:
+<short lines if needed>
+```
+
+## Specificity
+- Name the subject and materials (metal, fabric, glass).
+- Use camera language (lens, angle, shot type) for stability.
+- Describe the environment with time of day and atmosphere.
+
+## Style & visual cues
+- Set style early (e.g., "1970s film", "IMAX-scale", "16mm black-and-white").
+- Use visible nouns and verbs, not vague adjectives.
+- Weak: "A beautiful street at night."
+- Strong: "Wet asphalt, zebra crosswalk, neon signs reflecting in puddles."
+
+## Camera & composition
+- Prefer one camera move: dolly, orbit, lateral slide, or locked-off.
+- Straight-on framing is best for UI and text.
+- For close-ups, use longer lenses (85mm+); for wide scenes, 24-35mm.
+- Depth of field is a strong lever: shallow for subject isolation, deep for context.
+- Example framings: wide establishing, medium close-up, aerial wide, low angle.
+- Example camera motions: slow tilt, gentle handheld drift, smooth lateral slide.
+
+## Motion & timing
+- Use short beats: "0-2s", "2-4s", "4-6s".
+- Keep actions sequential, not simultaneous.
+- For 4s clips, limit to 1-2 beats.
+- Describe actions as counts or steps when possible (e.g., "takes four steps, pauses, turns in the final second").
+
+## Lighting & palette
+- Describe light quality and direction (soft window light, hard rim, backlight).
+- Name 3-5 palette anchors to stabilize color across shots.
+- If continuity matters, keep lighting logic consistent across clips.
+
+## Character continuity
+- Keep character descriptors consistent across shots; reuse phrasing.
+- Avoid mixing competing traits that can shift identity or pose.
+
+## Multi-shot prompts
+- You can describe multiple shots in one prompt, but keep each shot block distinct.
+- For each shot, specify one camera setup, one action, one lighting recipe.
+- Treat each shot as a creative unit you can later edit or stitch.
+
+## Ultra-detailed briefs
+- Use when you need a specific, filmic look or strict continuity.
+- Call out format/look, lensing/filters, grade/palette, lighting direction, texture, and sound.
+- If needed, include a short shot list with timing beats.
+
+## Image input
+- Use an input image to lock composition, character design, or set dressing.
+- The input image should match the target size and be jpg/png/webp.
+- The image anchors the first frame; the prompt describes what happens next.
+- If you lack a reference, generate one first and pass it as `input_reference`.
+
+## Constraints & invariants
+- State what must not change: "same shot", "same framing", "keep background".
+- Repeat invariants in every remix to reduce drift.
+
+## Text, dialogue & audio
+- Keep text short and specific; quote exact strings.
+- Specify placement and avoid motion blur.
+- For dialogue, use a dedicated block and keep lines short.
+- Label speakers consistently for multi-character scenes.
+- If silent, you can still add a small ambient sound cue to set rhythm.
+- Sora can generate audio; include an `Audio:` line and a short dialogue block when needed.
+- As a rule of thumb, 4s clips fit 1-2 short lines; 8s clips can handle a few more.
+
+Example:
+```
+Audio: soft ambient café noise, clear warm voiceover
+Dialogue:
+<dialogue>
+- Speaker: "Let's get started."
+</dialogue>
+```
+
+## Avoiding artifacts
+- Avoid multiple actions in 4-8 seconds.
+- Keep camera motion smooth and limited.
+- Add explicit negatives when needed: "avoid flicker", "avoid jitter", "no fast motion".
+
+## Remixing
+- Change one thing at a time: palette, lighting, or action.
+- Keep camera and subject consistent unless the change requests otherwise.
+- If a shot misfires, simplify: freeze the camera, reduce action, clear background, then add complexity back in.
+
+## Iterate deliberately
+- Start simple, then add one constraint per iteration.
+- If results look chaotic, reduce motion and simplify the scene.
+- When a result is close, pin it as a reference and describe only the tweak.

package/skills/ai-media/sora/references/sample-prompts.md

@@ -1,95 +1,95 @@
-# Sample prompts (copy/paste)
-
-Use these as starting points. Keep user-provided requirements and constraints; do not invent new creative elements.
-
-For prompting principles (structure, invariants, iteration), see `references/prompting.md`.
-
-## Contents
-- [Product teaser (single shot)](#product-teaser-single-shot)
-- [UI demo (screen recording style)](#ui-demo-screen-recording-style)
-- [Cinematic detail shot](#cinematic-detail-shot)
-- [Social ad (6s with beats)](#social-ad-6s-with-beats)
-- [Motion graphics explainer](#motion-graphics-explainer)
-- [Ambient loop (atmosphere)](#ambient-loop-atmosphere)
-
-## Product teaser (single shot)
-```
-Use case: product teaser
-Primary request: close-up of a matte black wireless speaker on a stone pedestal
-Scene/background: dark studio cyclorama, subtle haze
-Subject: compact speaker with soft fabric texture
-Action: slow 20-degree orbit over 4 seconds
-Camera: 85mm, shallow depth of field, steady dolly
-Lighting/mood: soft key, gentle rim, premium studio feel
-Color palette: charcoal, slate, warm amber accents
-Constraints: no logos, no text
-Avoid: harsh bloom; oversharpening; clutter
-```
-
-## UI demo (screen recording style)
-```
-Use case: UI product demo
-Primary request: a clean mobile budgeting app demo showing a weekly spend chart
-Scene/background: neutral gradient backdrop
-Subject: smartphone UI, centered, screen content crisp and legible
-Action: tap the "Add expense" button, modal opens, amount typed, save
-Camera: locked-off, straight-on, no tilt
-Lighting/mood: soft studio light, minimal reflections
-Color palette: off-white, slate, mint accent
-Text (verbatim): "Add expense", "$24.50", "Groceries"
-Constraints: no brand logos; keep UI text readable; avoid motion blur
-```
-
-## Cinematic detail shot
-```
-Use case: cinematic product detail
-Primary request: macro shot of raindrops sliding across a car hood
-Scene/background: night city bokeh, soft rain mist
-Subject: glossy hood surface with water beads
-Action: slow push-in over 4 seconds
-Camera: 100mm macro, shallow depth of field
-Lighting/mood: moody, high-contrast reflections, soft speculars
-Color palette: deep navy, teal, silver highlights
-Constraints: no logos, no text
-Avoid: flicker; unstable reflections; excessive noise
-```
-
-## Social ad (6s with beats)
-```
-Use case: social ad
-Primary request: minimal coffee subscription ad with three quick beats
-Scene/background: warm kitchen counter, morning light
-Subject: ceramic mug, coffee bag, steam
-Action: beat 1 (0-2s) pour coffee; beat 2 (2-4s) steam rises; beat 3 (4-6s) mug slides to center
-Camera: 50mm, gentle handheld drift
-Lighting/mood: warm, cozy, natural light
-Text (verbatim): "Fresh roast" (top-left), "Weekly delivery" (bottom-right)
-Constraints: no logos; text must be legible; avoid fast motion
-```
-
-## Motion graphics explainer
-```
-Use case: explainer clip
-Primary request: clean motion-graphics animation showing data flowing into a dashboard
-Scene/background: soft gradient background
-Subject: abstract nodes and lines, simple dashboard cards
-Action: nodes connect, data pulses, cards fill with charts
-Camera: locked-off, no depth, flat design
-Lighting/mood: minimal, modern
-Color palette: off-white, graphite, teal, coral accents
-Constraints: no logos; keep shapes simple; avoid heavy texture
-```
-
-## Ambient loop (atmosphere)
-```
-Use case: ambient background loop
-Primary request: fog drifting through a pine forest at dawn
-Scene/background: tall pines, soft fog layers, distant hills
-Subject: drifting fog and light rays
-Action: slow lateral drift, subtle light change
-Camera: wide, locked-off, no tilt
-Lighting/mood: calm, soft dawn light
-Color palette: muted greens, cool gray, pale gold
-Constraints: no text, no logos, no people
-Avoid: fast motion; flicker; abrupt lighting shifts
-```
+# Sample prompts (copy/paste)
+
+Use these as starting points. Keep user-provided requirements and constraints; do not invent new creative elements.
+
+For prompting principles (structure, invariants, iteration), see `references/prompting.md`.
+
+## Contents
+- [Product teaser (single shot)](#product-teaser-single-shot)
+- [UI demo (screen recording style)](#ui-demo-screen-recording-style)
+- [Cinematic detail shot](#cinematic-detail-shot)
+- [Social ad (6s with beats)](#social-ad-6s-with-beats)
+- [Motion graphics explainer](#motion-graphics-explainer)
+- [Ambient loop (atmosphere)](#ambient-loop-atmosphere)
+
+## Product teaser (single shot)
+```
+Use case: product teaser
+Primary request: close-up of a matte black wireless speaker on a stone pedestal
+Scene/background: dark studio cyclorama, subtle haze
+Subject: compact speaker with soft fabric texture
+Action: slow 20-degree orbit over 4 seconds
+Camera: 85mm, shallow depth of field, steady dolly
+Lighting/mood: soft key, gentle rim, premium studio feel
+Color palette: charcoal, slate, warm amber accents
+Constraints: no logos, no text
+Avoid: harsh bloom; oversharpening; clutter
+```
+
+## UI demo (screen recording style)
+```
+Use case: UI product demo
+Primary request: a clean mobile budgeting app demo showing a weekly spend chart
+Scene/background: neutral gradient backdrop
+Subject: smartphone UI, centered, screen content crisp and legible
+Action: tap the "Add expense" button, modal opens, amount typed, save
+Camera: locked-off, straight-on, no tilt
+Lighting/mood: soft studio light, minimal reflections
+Color palette: off-white, slate, mint accent
+Text (verbatim): "Add expense", "$24.50", "Groceries"
+Constraints: no brand logos; keep UI text readable; avoid motion blur
+```
+
+## Cinematic detail shot
+```
+Use case: cinematic product detail
+Primary request: macro shot of raindrops sliding across a car hood
+Scene/background: night city bokeh, soft rain mist
+Subject: glossy hood surface with water beads
+Action: slow push-in over 4 seconds
+Camera: 100mm macro, shallow depth of field
+Lighting/mood: moody, high-contrast reflections, soft speculars
+Color palette: deep navy, teal, silver highlights
+Constraints: no logos, no text
+Avoid: flicker; unstable reflections; excessive noise
+```
+
+## Social ad (6s with beats)
+```
+Use case: social ad
+Primary request: minimal coffee subscription ad with three quick beats
+Scene/background: warm kitchen counter, morning light
+Subject: ceramic mug, coffee bag, steam
+Action: beat 1 (0-2s) pour coffee; beat 2 (2-4s) steam rises; beat 3 (4-6s) mug slides to center
+Camera: 50mm, gentle handheld drift
+Lighting/mood: warm, cozy, natural light
+Text (verbatim): "Fresh roast" (top-left), "Weekly delivery" (bottom-right)
+Constraints: no logos; text must be legible; avoid fast motion
+```
+
+## Motion graphics explainer
+```
+Use case: explainer clip
+Primary request: clean motion-graphics animation showing data flowing into a dashboard
+Scene/background: soft gradient background
+Subject: abstract nodes and lines, simple dashboard cards
+Action: nodes connect, data pulses, cards fill with charts
+Camera: locked-off, no depth, flat design
+Lighting/mood: minimal, modern
+Color palette: off-white, graphite, teal, coral accents
+Constraints: no logos; keep shapes simple; avoid heavy texture
+```
+
+## Ambient loop (atmosphere)
+```
+Use case: ambient background loop
+Primary request: fog drifting through a pine forest at dawn
+Scene/background: tall pines, soft fog layers, distant hills
+Subject: drifting fog and light rays
+Action: slow lateral drift, subtle light change
+Camera: wide, locked-off, no tilt
+Lighting/mood: calm, soft dawn light
+Color palette: muted greens, cool gray, pale gold
+Constraints: no text, no logos, no people
+Avoid: fast motion; flicker; abrupt lighting shifts
+```

package/skills/ai-media/sora/references/social-ads.md

@@ -1,42 +1,42 @@
-# Social ad templates (4-8s)
-
-Short clips work best with clear beats. Use 2-3 beats and keep text minimal.
-
-## Default template
-```
-Use case: social ad
-Primary request: <ad concept>
-Scene/background: <simple backdrop>
-Subject: <product or scene>
-Action: beat 1 (0-2s) <action>; beat 2 (2-4s) <action>; beat 3 (4-6s) <action>
-Camera: <shot type + motion>
-Lighting/mood: <mood>
-Text (verbatim): "<short headline>", "<short subhead>"
-Constraints: no logos; keep text legible; avoid fast motion
-```
-
-## Example: product benefit
-```
-Use case: social ad
-Primary request: a compact humidifier emphasizing quiet operation
-Scene/background: minimal bedroom nightstand
-Subject: matte white humidifier with soft vapor
-Action: beat 1 (0-2s) vapor begins; beat 2 (2-4s) soft glow turns on; beat 3 (4-6s) device slides to center
-Camera: 50mm, gentle push-in
-Lighting/mood: calm, warm night light
-Text (verbatim): "Quiet mist", "Sleep better"
-Constraints: no logos; text must be legible; avoid harsh highlights
-```
-
-## Example: before/after
-```
-Use case: social ad
-Primary request: before/after of a cluttered desk becoming tidy
-Scene/background: home office desk, neutral wall
-Subject: desk surface, organizer tray
-Action: beat 1 (0-2s) cluttered desk; beat 2 (2-4s) quick tidy motion; beat 3 (4-6s) clean desk with organizer
-Camera: top-down, locked-off
-Lighting/mood: soft daylight
-Text (verbatim): "Before", "After"
-Constraints: no logos; keep motion minimal; avoid blur
-```
+# Social ad templates (4-8s)
+
+Short clips work best with clear beats. Use 2-3 beats and keep text minimal.
+
+## Default template
+```
+Use case: social ad
+Primary request: <ad concept>
+Scene/background: <simple backdrop>
+Subject: <product or scene>
+Action: beat 1 (0-2s) <action>; beat 2 (2-4s) <action>; beat 3 (4-6s) <action>
+Camera: <shot type + motion>
+Lighting/mood: <mood>
+Text (verbatim): "<short headline>", "<short subhead>"
+Constraints: no logos; keep text legible; avoid fast motion
+```
+
+## Example: product benefit
+```
+Use case: social ad
+Primary request: a compact humidifier emphasizing quiet operation
+Scene/background: minimal bedroom nightstand
+Subject: matte white humidifier with soft vapor
+Action: beat 1 (0-2s) vapor begins; beat 2 (2-4s) soft glow turns on; beat 3 (4-6s) device slides to center
+Camera: 50mm, gentle push-in
+Lighting/mood: calm, warm night light
+Text (verbatim): "Quiet mist", "Sleep better"
+Constraints: no logos; text must be legible; avoid harsh highlights
+```
+
+## Example: before/after
+```
+Use case: social ad
+Primary request: before/after of a cluttered desk becoming tidy
+Scene/background: home office desk, neutral wall
+Subject: desk surface, organizer tray
+Action: beat 1 (0-2s) cluttered desk; beat 2 (2-4s) quick tidy motion; beat 3 (4-6s) clean desk with organizer
+Camera: top-down, locked-off
+Lighting/mood: soft daylight
+Text (verbatim): "Before", "After"
+Constraints: no logos; keep motion minimal; avoid blur
+```