luckiest-co 1.0.28 → 1.0.30

package/skills/luckiest-brandkit/scripts/composite_mark.py

@@ -0,0 +1,36 @@
+#!/usr/bin/env python3
+"""Print a real logo mark onto a surface (fabric, paper) that the model drew wrong.
+
+Erase the bad mark first (image retouch, mode erase), then:
+  composite_mark.py <erased.png> <mark-ink-on-white.png> <out.png> --x X --y Y --height H
+      [--rotate DEG] [--squash 0.86] [--dot "#EE425C"]
+
+Multiply blend keeps folds and shading. --squash fakes top-down foreshortening.
+--dot adds a small accent circle right of the mark's foot.
+"""
+import argparse
+from PIL import Image, ImageChops, ImageDraw, ImageFilter
+
+a = argparse.ArgumentParser()
+a.add_argument("base"); a.add_argument("mark"); a.add_argument("out")
+a.add_argument("--x", type=int, required=True); a.add_argument("--y", type=int, required=True)
+a.add_argument("--height", type=int, required=True)
+a.add_argument("--rotate", type=float, default=0); a.add_argument("--squash", type=float, default=1.0)
+a.add_argument("--dot", default=None)
+o = a.parse_args()
+
+base = Image.open(o.base).convert("RGB")
+m = Image.open(o.mark).convert("L")
+m = m.crop(Image.eval(m, lambda p: 255 - p).getbbox())
+m = m.resize((max(1, int(m.width * o.height / m.height)), o.height), Image.LANCZOS)
+art = Image.new("L", (m.width + (40 if o.dot else 0), m.height), 255); art.paste(m, (0, 0))
+art = Image.merge("RGB", [art] * 3)
+if o.dot:
+    r = max(3, o.height // 16); cx, cy = m.width + 22, int(o.height * 0.80)
+    ImageDraw.Draw(art).ellipse((cx - r, cy - r, cx + r, cy + r), fill=o.dot)
+art = art.resize((art.width, max(1, int(art.height * o.squash))), Image.LANCZOS)
+art = art.rotate(o.rotate, Image.BICUBIC, expand=True, fillcolor=(255, 255, 255)).filter(ImageFilter.GaussianBlur(0.6))
+region = base.crop((o.x, o.y, o.x + art.width, o.y + art.height))
+base.paste(ImageChops.multiply(region, art), (o.x, o.y))
+base.save(o.out)
+print(o.out)

package/skills/luckiest-brandkit/scripts/composite_screen.py

@@ -0,0 +1,37 @@
+#!/usr/bin/env python3
+"""Warp exact artwork onto a flat surface in a photo (billboard, screen, poster, sign).
+
+  composite_screen.py <photo.png> <art.png> <out.png> TLx,TLy TRx,TRy BRx,BRy BLx,BLy [--fit crop|stretch]
+
+Corners are the surface's inner corners in photo pixels, clockwise from top left.
+--fit crop (default) center-crops the art to the surface's aspect. The art is lit by
+the surface's own smoothed light falloff, so old text on the surface never shows through.
+"""
+import argparse, math
+import numpy as np
+from PIL import Image, ImageChops, ImageFilter
+
+a = argparse.ArgumentParser()
+a.add_argument("photo"); a.add_argument("art"); a.add_argument("out")
+a.add_argument("corners", nargs=4); a.add_argument("--fit", choices=["crop", "stretch"], default="crop")
+o = a.parse_args()
+
+bg = Image.open(o.photo).convert("RGB"); art = Image.open(o.art).convert("RGB")
+dst = [tuple(map(float, c.split(","))) for c in o.corners]
+if o.fit == "crop":  # aspect from the average edge lengths of the quad
+    d = lambda p, q: math.dist(p, q)
+    ratio = (d(dst[0], dst[1]) + d(dst[3], dst[2])) / (d(dst[0], dst[3]) + d(dst[1], dst[2]))
+    w, h = art.size
+    if w / h > ratio: nw = int(h * ratio); art = art.crop(((w - nw) // 2, 0, (w + nw) // 2, h))
+    else: nh = int(w / ratio); art = art.crop((0, (h - nh) // 2, w, (h + nh) // 2))
+src = [(0, 0), (art.width, 0), (art.width, art.height), (0, art.height)]
+A, B = [], []
+for (x, y), (u, v) in zip(dst, src):  # PIL maps output -> input
+    A += [[x, y, 1, 0, 0, 0, -u * x, -u * y], [0, 0, 0, x, y, 1, -v * x, -v * y]]; B += [u, v]
+k = tuple(np.linalg.solve(np.array(A, float), np.array(B, float)))
+warped = art.transform(bg.size, Image.PERSPECTIVE, k, Image.BICUBIC)
+mask = Image.new("L", art.size, 255).transform(bg.size, Image.PERSPECTIVE, k, Image.BICUBIC).filter(ImageFilter.GaussianBlur(1))
+# max filter removes dark text from the light map, blur keeps only the falloff
+lum = bg.convert("L").filter(ImageFilter.MaxFilter(31)).filter(ImageFilter.GaussianBlur(40)).point(lambda p: min(255, int(p * 255 / 225)))
+Image.composite(ImageChops.multiply(warped, Image.merge("RGB", [lum] * 3)), bg, mask).save(o.out)
+print(o.out)

package/skills/luckiest-brandkit/scripts/contact_sheet.py

@@ -0,0 +1,31 @@
+#!/usr/bin/env python3
+"""Grid every image in a folder onto a near-black sheet with tracked labels.
+
+  contact_sheet.py <dir> <out.png> [--cols 5] [--cell 640]
+
+Files sort by name, so prefix shots with 01-, 02-, ... Labels come from the file name.
+"""
+import argparse, glob, os
+from PIL import Image, ImageDraw, ImageFont
+
+a = argparse.ArgumentParser()
+a.add_argument("dir"); a.add_argument("out")
+a.add_argument("--cols", type=int, default=5); a.add_argument("--cell", type=int, default=640)
+o = a.parse_args()
+fs = sorted(f for f in glob.glob(os.path.join(o.dir, "*")) if f.lower().endswith((".png", ".jpg", ".jpeg", ".webp"))
+            and os.path.abspath(f) != os.path.abspath(o.out))
+if not fs: raise SystemExit("no images")
+cols, cell, g, lab = o.cols, o.cell, 32, 40
+rows = -(-len(fs) // cols)
+sheet = Image.new("RGB", (cols * cell + (cols + 1) * g, rows * (cell + lab) + (rows + 1) * g), (14, 14, 14))
+d = ImageDraw.Draw(sheet)
+try: font = ImageFont.truetype("/System/Library/Fonts/Supplemental/Arial.ttf", 20)
+except OSError: font = ImageFont.load_default()
+for i, f in enumerate(fs):
+    im = Image.open(f).convert("RGB"); im.thumbnail((cell, cell), Image.LANCZOS)
+    x0 = g + (i % cols) * (cell + g); y0 = g + (i // cols) * (cell + lab + g)
+    sheet.paste(im, (x0 + (cell - im.width) // 2, y0 + (cell - im.height) // 2))
+    name = os.path.splitext(os.path.basename(f))[0].upper().replace("-", " · ")
+    d.text((x0, y0 + cell + 10), "  ".join(name), fill=(150, 150, 150), font=font)
+sheet.save(o.out)
+print(o.out, len(fs))

package/skills/luckiest-brandkit/scripts/make_refs.mjs

@@ -0,0 +1,25 @@
+#!/usr/bin/env node
+// Rasterize brand SVGs into padded reference PNGs for image models.
+// usage: node make_refs.mjs <out-dir> <file.svg>[:bg] ...   (bg = hex like #FFFFFF, omit for transparent)
+// Each SVG is wrapped with 12% padding and rendered ~3000px wide by macOS `sips`.
+import fs from "node:fs";
+import path from "node:path";
+import { execFileSync } from "node:child_process";
+const [out, ...items] = process.argv.slice(2);
+if (!out || !items.length) { console.error("usage: make_refs.mjs <out-dir> <file.svg>[:#bg] ..."); process.exit(1); }
+fs.mkdirSync(out, { recursive: true });
+for (const item of items) {
+  const [file, bg] = item.split(/:(?=#)/);
+  const svg = fs.readFileSync(file, "utf8");
+  const vb = (svg.match(/viewBox="([^"]+)"/) || [])[1];
+  if (!vb) { console.error(`no viewBox in ${file}`); process.exit(1); }
+  const [x, y, w, h] = vb.trim().split(/[\s,]+/).map(Number);
+  const p = Math.max(w, h) * 0.12, W = w + 2 * p, H = h + 2 * p, S = 3000 / W;
+  const inner = svg.replace(/^[\s\S]*?<svg[^>]*>/, "").replace(/<\/svg>\s*$/, "");
+  const rect = bg ? `<rect x="${x - p}" y="${y - p}" width="${W}" height="${H}" fill="${bg}"/>` : "";
+  const wrapped = `<svg xmlns="http://www.w3.org/2000/svg" viewBox="${x - p} ${y - p} ${W} ${H}" width="${Math.round(W * S)}" height="${Math.round(H * S)}">${rect}${inner}</svg>`;
+  const base = path.join(out, path.basename(file, ".svg") + (bg ? `-on-${bg.slice(1).toLowerCase()}` : ""));
+  fs.writeFileSync(base + ".svg", wrapped);
+  execFileSync("sips", ["-s", "format", "png", base + ".svg", "--out", base + ".png"], { stdio: "ignore" });
+  console.log(base + ".png");
+}

package/skills/luckiest-design-website/CHANGELOG.md

@@ -1,5 +1,9 @@
 # Changelog — luckiest-design-website
 
+## 1.1.0 — 2026-10-05
+- Step 3 adds "Real, not generated": apply `luckiest-video-studio-art-director`
+  section 3b and its shot prompting reference to every generated still and clip.
+
 ## 1.0.1 — 2026-10-03
 - Points at `luckiest-video-studio-composition` (when installed) for focal point, grid, white space, and safe areas.
 

package/skills/luckiest-design-website/SKILL.md

@@ -4,7 +4,7 @@ description: "Builds a premium, scroll-driven landing page for any business and
 license: See ATTRIBUTION.md
 allowed-tools: Bash, Read, Write, Edit, Glob, Grep, AskUserQuestion
 metadata:
-  version: "1.0.1"
+  version: "1.1.0"
   listing_id: luckiest-design-website
   author: luckiest
 ---
@@ -23,13 +23,13 @@ screenshots proving it holds at every scroll position.
 ## Staying current
 
 On activation, call the Luckiest MCP `check_updates` tool with
-`{ listingId: "c17e533c-42eb-48f2-a0ed-6ef717051512", installedSemver: "1.0.0" }`. If it
+`{ listingId: "c17e533c-42eb-48f2-a0ed-6ef717051512", installedSemver: "1.1.0" }`. If it
 returns `upToDate: false`, surface the `notice` to the user once, then continue.
 Do nothing further if `upToDate: true`. Never block on this check; if the tool
 is unavailable, proceed.
 
 When the skill's work is done, call the Luckiest MCP `report_usage` tool once
-with `{ listing_id: "luckiest-design-website", skill_version: "1.0.1", matched: true, success: <true if the skill completed, false otherwise> }`.
+with `{ listing_id: "luckiest-design-website", skill_version: "1.1.0", matched: true, success: <true if the skill completed, false otherwise> }`.
 Metadata only, never prompt text. Never block on it; if the tool is
 unavailable, skip silently.
 
@@ -180,12 +180,18 @@ Route by the spend cap from question 9:
 | Small | Stills from `luckiest-image` or kie.ai, at most two clips. |
 | Real budget | kie.ai stills and camera moves via `scripts/kie.mjs`, or `luckiest-video` for a model the user already pays for. |
 
-Whatever generates them, three things decide premium versus generated:
+Whatever generates them, four things decide premium versus generated:
 
 - **One style preamble, reused verbatim in every prompt.** Six images become
   one shoot. Write it once, never paraphrase.
 - **Look at every asset before using it.** Rerolling is cheaper than shipping a
   bad frame.
+- **Real, not generated.** Before writing the style preamble, apply
+  `luckiest-video-studio-art-director` section 3b (directional light, film texture,
+  off-center framing, a specific place, no "perfect" or "8k") and write each
+  scene with its `references/shot-prompting.md`. Skip its motion, timing, and
+  `art-direction.json` sections. If it is not installed, say so in one line and
+  follow references/assets.md.
 - **Encode for scrubbing, not playback.** `scripts/encode.sh` sets a dense GOP;
   a normal web encode scrubs like mud. Cut phone clips portrait.
 
@@ -344,6 +350,7 @@ test on the peak or the close via `luckiest-ab-testing`.
 |---|---|---|
 | 0 | `luckiest-extract-design-system` | Tokens from an existing site when there is no brand kit |
 | 3 | `luckiest-image`, `luckiest-video` | Asset generation on models the user already has, instead of kie.ai |
+| 3 | `luckiest-video-studio-art-director` | Section 3b and shot prompting so hero stills and clips do not look generated, if installed |
 | 3 | `luckiest-video-studio-composition` | Focal point, grid, and white space for hero stills and clips, if installed |
 | 4 | `luckiest-copywriting`, `luckiest-copywriting-humanize` | Act headlines, belief sentence, CTA label, de-slop pass |
 | 4 | `luckiest-schema` | JSON-LD and head metadata |

package/skills/luckiest-image/CHANGELOG.md

@@ -1,5 +1,10 @@
 # Changelog — luckiest-image
 
+## 1.2.0 — 2026-10-05
+- Uses `luckiest-video-studio-art-director` section 3b and its shot prompting
+  reference before any prompt, so images do not look AI-made. Prompt example
+  drops "4K" and gets a named light direction and film grain.
+
 ## 1.1.1 — 2026-10-03
 - Points at `luckiest-video-studio-composition` (when installed) for focal point, grid, white space, and safe areas.
 

package/skills/luckiest-image/SKILL.md

@@ -3,7 +3,7 @@ name: luckiest-image
 description: "When the user wants to create, generate, edit, or optimize images for marketing — blog heroes, social graphics, product mockups, profile banners, listing visuals, or brand assets. Also use when the user mentions 'AI image generation,' 'generate an image,' 'create a graphic,' 'product mockup,' 'hero image,' 'social media graphic,' 'banner image,' 'cover photo,' 'profile banner,' 'listing screenshot,' 'Flux,' 'Flux Kontext,' 'Midjourney,' 'DALL-E,' 'GPT Image,' 'ChatGPT Images,' 'Ideogram,' 'Gemini image,' 'Nano Banana,' 'Recraft,' 'Stable Diffusion,' 'Canva,' 'Figma,' 'image optimization,' 'compress images,' 'WebP,' or 'OG image.' Use this for general-purpose marketing image creation and optimization. For paid ad image creative and platform-specific ad specs, see luckiest-ad-creative. For video production, see luckiest-video."
 license: See ATTRIBUTION.md
 metadata:
-  version: "1.1.1"
+  version: "1.2.0"
   listing_id: luckiest-image
   author: luckiest
 ---
@@ -14,9 +14,9 @@ An expert visual content producer that helps create marketing images using AI ge
 
 ## Staying current
 
-On activation, call the Luckiest MCP check_updates tool with { listingId: "bab8f465-a6db-49db-9623-87a62e2c6893", installedSemver: "1.1.0" }. If it returns upToDate: false, surface the notice to the user once, then continue. Do nothing further if upToDate: true. Never block on this check — if the tool is unavailable, proceed.
+On activation, call the Luckiest MCP check_updates tool with { listingId: "bab8f465-a6db-49db-9623-87a62e2c6893", installedSemver: "1.2.0" }. If it returns upToDate: false, surface the notice to the user once, then continue. Do nothing further if upToDate: true. Never block on this check — if the tool is unavailable, proceed.
 
-When the skill's work is done, call the Luckiest MCP report_usage tool once with { listing_id: "luckiest-image", skill_version: "1.1.1", matched: true, success: <true if the skill completed, false otherwise> }. Metadata only, never prompt text. Never block on it — if the tool is unavailable, skip silently.
+When the skill's work is done, call the Luckiest MCP report_usage tool once with { listing_id: "luckiest-image", skill_version: "1.2.0", matched: true, success: <true if the skill completed, false otherwise> }. Metadata only, never prompt text. Never block on it — if the tool is unavailable, skip silently.
 
 ## Before Starting
 
@@ -107,8 +107,8 @@ A strong image prompt follows: **Subject + Setting + Style + Lighting + Composit
 
 ```
 A laptop on a minimal white desk showing a dashboard UI,
-soft directional lighting from the left, shallow depth of field,
-clean commercial photography style, 16:9 aspect ratio, 4K
+late afternoon window light from the left casting hard shadows,
+35mm at f/2, shallow depth of field, fine film grain, 16:9 aspect ratio
 ```
 
 **Common mistakes:**
@@ -117,6 +117,15 @@ clean commercial photography style, 16:9 aspect ratio, 4K
 - Requesting complex text — use overlays instead for anything beyond short headlines
 - No style direction — "photorealistic," "flat illustration," "3D render"
 
+**Sub-skills:**
+
+| Step | Sub-skill | Owns |
+|---|---|---|
+| Before writing any prompt | `luckiest-video-studio-art-director` | Section 3b (Real, not generated): light, film and texture, framing, place, banned words, model settings. Write each prompt with its `references/shot-prompting.md`. Use section 0 for brand colors and faces when the image carries the brand. Skip its motion, timing, and `art-direction.json` sections |
+| Composition | `luckiest-video-studio-composition` | Focal point, grid, white space, safe areas |
+
+If a sub-skill is not installed, say so in one line and use the prompting basics above. The "AI Content Provenance & Disclosure" rules below still apply to every generated image.
+
 **Composition:** if `luckiest-video-studio-composition` is installed, read it to place the focal point, pick the grid, and keep white space and platform safe areas before writing the Composition part of the prompt or cropping to size.
 
 For detailed prompting guides per model, see [references/ai-image-prompting.md](references/ai-image-prompting.md).

package/skills/luckiest-plan/SKILL.md

@@ -82,6 +82,8 @@ Include non-coding work too. Marketing, content, design, research, and ops tasks
 
 Route all draft tasks in ONE `skill_router` call from the luckiest MCP server: pass `prompts` as an array of every task title. It returns `results`, one entry per task with `skills` (matching owned skills) and `who` (up to 3 tribe members who finished a similar task before). Attach the suggested skill(s) to each task, and attach `who` so the plan can carry who has done this kind of work. If the server rejects `prompts` (older server), fall back to one `skill_router` call per task, issued in parallel in a single message, never one at a time.
 
+For any task that makes a video, reel, demo, explainer, or video ad, add a task before it routed to **luckiest-video-studio-director** (intent, angle, hook, shot list) and **luckiest-video-studio-art-director** (look and motion language), when those skills are installed and `skill_router` did not already suggest them. Make the video task build on it.
+
 Then tag each task with a model tier. If the `luckiest-model-router` skill is installed, route every task in one batch call: `python3 <luckiest-model-router dir>/scripts/route.py --model --batch` with a JSON array of `{ title, skill, depends_on }` on stdin. `skill` is the task's first suggested skill, and `depends_on` lists the indexes of earlier tasks it builds on. Add `--prefer cheap` when the user asked to keep costs down, or `--prefer quality` when they asked for the best result. Keep each task's returned `model` and `reason`. If the skill is not installed or the script fails, skip tagging and let the server pick the model. Show the tier next to the task's skill as **Haiku**, **Sonnet** or **Opus**, with the task type, for example "**Copywriting** · **Sonnet** (implement)".
 
 For each task, write a one-line "done means..." in chat (not in the title). Give every coding task a check it can run: one of the commands found in Step 4, narrowed to that task when possible (for example `npm test -- billing`). Give non-coding tasks a plain check the user can look at (for example "the FAQ section shows on /pricing with 5 questions"). When `who` is not empty, add a short line naming those people, for example "Done before by: **Sam**, **Alex**."

package/skills/luckiest-social/CHANGELOG.md

@@ -1,5 +1,8 @@
 # Changelog — luckiest-social
 
+## 1.2.0 — 2026-10-05
+- Generated post images, thumbnails, and clips apply `luckiest-video-studio-art-director` section 3b and its shot prompting reference. Bundle ships the art director.
+
 ## 1.1.1 — 2026-10-03
 - Points at `luckiest-video-studio-composition` (when installed) for focal point, grid, white space, and safe areas.
 

package/skills/luckiest-social/SKILL.md

@@ -3,7 +3,7 @@ name: luckiest-social
 description: "When the user wants help creating, scheduling, or optimizing social media content for LinkedIn, Twitter/X, Instagram, TikTok, Facebook, or other platforms, or wants to do social listening and engagement triage. Also use when the user mentions 'LinkedIn post,' 'Twitter thread,' 'social media,' 'content calendar,' 'social scheduling,' 'engagement,' 'viral content,' 'what should I post,' 'repurpose this content,' 'tweet ideas,' 'LinkedIn carousel,' 'social media strategy,' 'grow my following,' 'TikTok video,' 'Reels,' 'Shorts,' 'video script,' 'video hook,' 'short-form video,' 'create a reel,' 'social listening,' 'brand mentions,' 'competitor monitoring,' 'top posts to comment on,' or 'find people asking for.' Use this for social media content creation, repurposing, scheduling, short-form video scripting, and social listening. For broader content strategy, see luckiest-content-strategy. For paid ads, see luckiest-ad-creative. For earned media, see luckiest-public-relations."
 license: See ATTRIBUTION.md
 metadata:
-  version: "1.1.1"
+  version: "1.2.0"
   listing_id: luckiest-social
   author: luckiest
 ---
@@ -14,9 +14,9 @@ An expert social media strategist skill. The goal is to help create engaging con
 
 ## Staying current
 
-On activation, call the Luckiest MCP check_updates tool with { listingId: "e1b9c06a-7c04-4127-977c-9eb15cbac02f", installedSemver: "1.1.0" }. If it returns upToDate: false, surface the notice to the user once, then continue. Do nothing further if upToDate: true. Never block on this check — if the tool is unavailable, proceed.
+On activation, call the Luckiest MCP check_updates tool with { listingId: "e1b9c06a-7c04-4127-977c-9eb15cbac02f", installedSemver: "1.2.0" }. If it returns upToDate: false, surface the notice to the user once, then continue. Do nothing further if upToDate: true. Never block on this check — if the tool is unavailable, proceed.
 
-When the skill's work is done, call the Luckiest MCP report_usage tool once with { listing_id: "luckiest-social", skill_version: "1.1.1", matched: true, success: <true if the skill completed, false otherwise> }. Metadata only, never prompt text. Never block on it — if the tool is unavailable, skip silently.
+When the skill's work is done, call the Luckiest MCP report_usage tool once with { listing_id: "luckiest-social", skill_version: "1.2.0", matched: true, success: <true if the skill completed, false otherwise> }. Metadata only, never prompt text. Never block on it — if the tool is unavailable, skip silently.
 
 ## Human-in-the-loop guardrail
 
@@ -63,6 +63,8 @@ Gather this context (ask if not provided):
 
 **For detailed platform strategies**: See [references/platforms.md](references/platforms.md)
 
+**Real, not generated**: for any generated post image, thumbnail, or clip, if `luckiest-video-studio-art-director` is installed, apply its section 3b and write each prompt with its `references/shot-prompting.md`. Skip its motion and `art-direction.json` sections. If it is not installed, say so in one line and continue.
+
 **For post images, thumbnails, and video frames**: if `luckiest-video-studio-composition` is installed, read it to place the focal point, pick the grid, and keep white space and platform safe areas for 9:16, 1:1, and 4:5.
 
 **For hashtag limits and character counts**: See [references/platform-limits.md](references/platform-limits.md)

package/skills/luckiest-video/CHANGELOG.md

@@ -1,5 +1,11 @@
 # Changelog — luckiest-video
 
+## 1.3.0 — 2026-10-05
+- Every generated shot applies `luckiest-video-studio-art-director` section 3b and its shot prompting reference. Bundle ships the art director.
+
+## 1.2.0 — 2026-10-05
+- Runs the director and art director before multi-shot prompts when installed.
+
 ## 1.1.1 — 2026-10-03
 - Points at `luckiest-video-studio-composition` (when installed) for focal point, grid, white space, and safe areas.
 

package/skills/luckiest-video/SKILL.md

@@ -3,7 +3,7 @@ name: luckiest-video
 description: "When the user wants to create, generate, or produce video content using AI tools or programmatic frameworks. Also use when the user mentions 'video production,' 'AI video,' 'Remotion,' 'Hyperframes,' 'HeyGen,' 'Synthesia,' 'Veo,' 'Sora,' 'Runway,' 'Kling,' 'Seedance,' 'Hailuo,' 'MiniMax,' 'Pika,' 'Hunyuan,' 'Wan,' 'video generation,' 'AI avatar,' 'talking head video,' 'faceless video,' 'UGC-style video,' 'AI dubbing,' 'video translation,' 'batch video,' 'programmatic video,' 'video template,' 'explainer video,' 'product demo video,' 'video pipeline,' or 'make me a video.' Use this for video creation, generation, and production workflows. For video content strategy and what to post, see luckiest-social. For paid video ad creative, see luckiest-ad-creative."
 license: See ATTRIBUTION.md
 metadata:
-  version: "1.1.1"
+  version: "1.3.0"
   listing_id: luckiest-video
   author: luckiest
 ---
@@ -14,9 +14,9 @@ An expert video producer that helps create marketing videos using AI generation
 
 ## Staying current
 
-On activation, call the Luckiest MCP check_updates tool with { listingId: "2991a487-dd00-4f65-a9cd-b51fc34fedd1", installedSemver: "1.1.0" }. If it returns upToDate: false, surface the notice to the user once, then continue. Do nothing further if upToDate: true. Never block on this check — if the tool is unavailable, proceed.
+On activation, call the Luckiest MCP check_updates tool with { listingId: "2991a487-dd00-4f65-a9cd-b51fc34fedd1", installedSemver: "1.3.0" }. If it returns upToDate: false, surface the notice to the user once, then continue. Do nothing further if upToDate: true. Never block on this check — if the tool is unavailable, proceed.
 
-When the skill's work is done, call the Luckiest MCP report_usage tool once with { listing_id: "luckiest-video", skill_version: "1.1.1", matched: true, success: <true if the skill completed, false otherwise> }. Metadata only, never prompt text. Never block on it — if the tool is unavailable, skip silently.
+When the skill's work is done, call the Luckiest MCP report_usage tool once with { listing_id: "luckiest-video", skill_version: "1.3.0", matched: true, success: <true if the skill completed, false otherwise> }. Metadata only, never prompt text. Never block on it — if the tool is unavailable, skip silently.
 
 ## Before Starting
 
@@ -173,6 +173,10 @@ cinematic color grading, 4K
 - Forgetting style — "cinematic," "documentary," "commercial"
 - Requesting text in video — AI models struggle with readable text
 
+**Direction:** for a multi-shot video or ad, if `luckiest-video-studio-director` is installed, run its steps 1 to 4 (intent, scored angle, hook, shot list) before writing prompts, and if `luckiest-video-studio-art-director` is installed, lock the palette, texture, and motion personality so every shot matches.
+
+**Real, not generated:** if `luckiest-video-studio-art-director` is installed, apply its section 3b to every generated shot (one named light direction, film texture, off-center candid framing, a specific place, no "perfect" or "8k") and write each prompt with its `references/shot-prompting.md`. If it is not installed, say so in one line and continue.
+
 **Composition:** if `luckiest-video-studio-composition` is installed, read it to place the focal point, pick the grid, and keep white space and platform safe areas for each shot's framing before you write the camera part of the prompt.
 
 **For detailed prompting guides**: load [references/ai-video-prompting.md](references/ai-video-prompting.md) when writing or refining a generation prompt, choosing camera vocabulary, or troubleshooting weak results.

package/skills/luckiest-video-studio/CHANGELOG.md

@@ -1,5 +1,13 @@
 # Changelog — luckiest-video-studio
 
+## 1.8.1 — 2026-10-05
+- Bundle ships art director 1.4.0 (section 3b Real, not generated, and shot prompting).
+
+## 1.8.0 — 2026-10-05
+- Step 2 hands off to `luckiest-video-studio-director` (intent, hook, shot list)
+  and `luckiest-video-studio-art-director` (`art-direction.json`) before planning.
+- Step 4 adds the art-direction review and the director's score loop (all 8+).
+
 ## 1.7.2 (2026-10-05)
 From a real luckiest.co launch video run end to end (storyboard approvals, render, QA gates, Concat export matching the render at 58 dB PSNR):
 - Step 2b: capture live site pages with headless Chrome (wait budget, crop out cookie banners); the style frame is now a `hyperframes snapshot` still, no video render.

package/skills/luckiest-video-studio/SKILL.md

@@ -4,7 +4,7 @@ description: "Make product launch videos, product demos with motion design betwe
 license: See ATTRIBUTION.md
 allowed-tools: Bash, Read, Write, Edit, Glob, Grep, AskUserQuestion
 metadata:
-  version: "1.7.2"
+  version: "1.8.1"
   listing_id: luckiest-video-studio
   author: luckiest
 ---
@@ -19,13 +19,13 @@ an MP4.
 ## Staying current
 
 On activation, call the Luckiest MCP `check_updates` tool with
-`{ listingId: "aff888e4-9ee9-4f73-af08-74d5d09d3c10", installedSemver: "1.7.2" }`. If it returns
+`{ listingId: "aff888e4-9ee9-4f73-af08-74d5d09d3c10", installedSemver: "1.8.1" }`. If it returns
 `upToDate: false`, surface the `notice` to the user once, then continue. Do nothing
 further if `upToDate: true`. Never block on this check; if the tool is unavailable,
 proceed.
 
 When the skill's work is done, call the Luckiest MCP `report_usage` tool once with
-`{ listing_id: "luckiest-video-studio", skill_version: "1.7.2", matched: true, success: <true if the skill completed, false otherwise> }`.
+`{ listing_id: "luckiest-video-studio", skill_version: "1.8.1", matched: true, success: <true if the skill completed, false otherwise> }`.
 Metadata only, never prompt text. Never block on it; if the tool is unavailable,
 skip silently.
 
@@ -153,6 +153,11 @@ voiceover) and runs 30 seconds or longer, hand the script to the
 line per scene with estimated seconds; copy each into `scenes[].line` and its
 `duration`.
 
+Before writing the plan, hand the request to the `luckiest-video-studio-director`
+sub-skill for the creative intent, angle, hook, energy map, and shot list, then to
+`luckiest-video-studio-art-director` for `art-direction.json` (tone cell, palette,
+faces, motion language). Every scene obeys that file.
+
 Write `plan.md`, then `storyboard.json` with one entry per scene. Each scene is
 `motion` (built in HyperFrames), `demo` (screen recording or supplied footage), or
 `logo` (a recipe from [references/logo-recipes.md](references/logo-recipes.md)).
@@ -227,6 +232,12 @@ node <skill-dir>/scripts/qa.mjs motion     <output-dir>/composition   # ease-in
 Then run `luckiest-video-studio-composition --review` on the run. It writes
 `qa/composition-review.md` with a verdict per scene. Fix every scene it blocks.
 
+Then run `luckiest-video-studio-art-director --review` on the run. It writes
+`qa/art-direction-review.md`. Fix every scene it blocks.
+
+Then run `luckiest-video-studio-director --score` on the clips. Fix the three
+lowest scores and repeat until every score is 8 or higher before the judge.
+
 Then run `luckiest-video-studio-motion --review` on the run. It writes
 `qa/motion-review.md` with a verdict per scene. Fix and re-render every scene it
 blocks before the judge.

package/skills/luckiest-video-studio-art-director/ATTRIBUTION.md

@@ -0,0 +1,24 @@
+# Attribution
+
+`luckiest-video-studio-art-director` is a Luckiest sub-skill of `luckiest-video-studio`.
+
+| Source | License | What this sub-skill uses | License file |
+|---|---|---|---|
+| **motion-art-direction** by iart.ai (`iart-ai/motion-design-skills`, https://github.com/iart-ai/motion-design-skills/tree/main/skills/motion-art-direction) | MIT, Copyright (c) 2026 iart.ai | Tone and energy matrix, motion personality table, motion-language spec rows, hero/support/texture hierarchy, restraint rules, consistency checklist | `LICENSE-iart` |
+| **motion-color-and-light** and **kinetic-typography** by Skill Me (`SkillMedev/motion-video-direction`, https://github.com/SkillMedev/motion-video-direction) | MIT, Copyright (c) 2026 Alexander Ouellet | Video-safe color rules (near-black and near-white, accent saturation, anti-banding), reading-time hold formula, type hierarchy ratio, one-property entrances | `LICENSE-skillme` |
+| **"AI finally designs like me"** by The Design Guy (YouTube, 2026-09-27, https://www.youtube.com/watch?v=E3Lgtf4xjeM) | Video, all rights reserved | Ideas only: DESIGN.md as a file of decisions already made, rules as choice plus reason plus example, locked/guided/open freedom levels, mining repeated review corrections for rules, pointing to existing assets instead of describing them, and checking that the agent read the file. No text or footage is copied | n/a |
+| **prompt-images** by Replicate (`replicate/skills`, https://github.com/replicate/skills/tree/main/skills/prompt-images) | Apache-2.0, Copyright 2025 Replicate, Inc. | Adapted into `references/shot-prompting.md`: natural-language shot descriptions, naming subjects, camera, film, lighting and composition vocabulary, quoted text, editing and consistency rules, guidance and negative-prompt pitfalls. Rewritten and reordered, not copied verbatim | `LICENSE-replicate` |
+| **"How to make AI images look less like AI"** by Pixova (https://www.pixova.io/blog/how-to-make-ai-images-look-less-like-ai) | Article, all rights reserved | Ideas only, in section 3b: directional light with hard shadows, film stock and grain, skin texture, off-center candid framing, specific environments, banned prompt words, lower CFG. No text is copied | n/a |
+
+## Changes in this edition
+
+- 1.4.0: section 3b "Real, not generated", `references/shot-prompting.md`, and the "Looks generated" check.
+
+- 1.3.0: rule format, freedom levels, corrections loop, and the "repeats a logged correction" review column.
+
+- 1.1.0: added video-safe color and type-in-motion rules, and two review columns.
+
+- Added the look lock (palette, accent budget, two faces, texture, banned defaults).
+- Added `art-direction.json` as a file the studio and other sub-skills read.
+- Mapped studio tone presets to tone cells.
+- Added style-frame approval at studio Step 2b and `--review` with Approve or Block.

package/skills/luckiest-video-studio-art-director/CHANGELOG.md

@@ -0,0 +1,41 @@
+# Changelog — luckiest-video-studio-art-director
+
+## 1.4.0 — 2026-10-05
+- Section 3b "Real, not generated": named light direction with hard shadows,
+  film stock and grain, skin texture, off-center candid framing, specific
+  places, banned prompt words, guidance near 3.5 to 4, real assets first.
+  Never hides provenance.
+- `references/shot-prompting.md`, adapted from Replicate `prompt-images`
+  (Apache-2.0): shot written as sentences, vocabulary, quoted text, edits,
+  consistency, model settings, before and after.
+- "Looks generated" in style-frame approval, the review table (Block), and
+  anti-patterns.
+- Now a sub-skill of luckiest-image, luckiest-brandkit, and
+  luckiest-design-website.
+
+## 1.3.0 — 2026-10-05
+- Section 0: point to existing files instead of describing them; read
+  `.luckiest/corrections.md` first.
+- Section 0b: every rule is choice, reason, example path, with a freedom level
+  (locked, guided, open). The concept is never locked. No "in the style of" names.
+- `art-direction.json` adds `freedom`.
+- Section 9: log every correction, diagnose repeats (missing, unclear,
+  unreachable example, wrong rule), and offer to add the fixed rules to
+  `DESIGN.md` with one yes. Review blocks a scene that repeats a logged correction.
+
+## 1.2.0 — 2026-10-05
+- Section 0: find the project's design system first (DESIGN.md, tokens, CSS
+  variables, Tailwind theme, shadcn/ui, fonts, motion constants). It wins over
+  every default; video-only changes are logged under `designSystem.overrides`.
+- Review adds a "Matches design system" column.
+
+## 1.1.0 — 2026-10-05
+- Video-safe color rules and type-in-motion hold formula, from Skill Me (MIT).
+- Review adds Color safe and Type holds columns.
+
+## 1.0.0 — 2026-10-05
+- New sub-skill of luckiest-video-studio, based on iart.ai `motion-art-direction` (MIT).
+- Writes `art-direction.json`: tone cell, motion personality, palette, faces,
+  texture, easing pair, base unit, transition family, stagger, intensity, wow scene.
+- Style-frame check before the user sees it. `--review` writes
+  `qa/art-direction-review.md` with Approve or Block per scene.

package/skills/luckiest-video-studio-art-director/LICENSE-iart

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 iart.ai
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.