@slatesvideo/cli 0.1.0 → 0.4.0

package/README.md

@@ -0,0 +1,77 @@
+# @slatesvideo/cli
+
+The `slates` command for the [Slates](https://slates.video) AI video studio. Drive Slates from your terminal, or let Claude Code shell out to it instead of loading 64 tool schemas into context.
+
+## Install
+
+```bash
+npm i -g @slatesvideo/cli
+```
+
+Requires Node.js 18+ and the Slates desktop app ([slates.video](https://slates.video)).
+
+## Commands
+
+| Command | What it does |
+|---|---|
+| `slates login` | Authorize this machine via magic link (or `--token slates_sk_...`) |
+| `slates logout` | Clear the stored cloud token |
+| `slates status` | Show connection state, account, and credit balance |
+| `slates mcp` | Detect installed MCP clients and print the exact config for each; `--write` merges it into Claude Desktop / Cursor configs (with a `.bak` backup) |
+| `slates install-skills` | Install the bundled agent skills into `.claude/skills/<name>/SKILL.md`; `--global` targets `~/.claude/skills` |
+| `slates run <op>` | Invoke any Slates operation by id; `--list` shows all 64 |
+
+## Skills
+
+15 agent skills ship embedded in `@slatesvideo/shared`: workflow recipes (one-prompt film, direct-response ad, storyboard from script, character turnaround, edit-and-iterate, vision feedback loop), per-model prompting guides (Kling V3, Veo 3.1, Seedance 2.0, Nano Banana 2, FLUX.2 Max, Seedream 5 Lite, lip sync, motion transfer), and cost discipline.
+
+`slates install-skills` writes each one to `.claude/skills/<skill-name>/SKILL.md` in your current project, which is the layout Claude Code's skill discovery requires. Use `--global` to install for every project. Restart Claude Code afterward, then ask: "what slates skills do you have?" to verify.
+
+## Using `slates run` (agent-driven)
+
+```bash
+# List every operation
+slates run --list
+
+# Create a project
+slates run slates_create_project --name "neon samurai"
+
+# Estimate before generating (the cost-discipline skill makes agents do this)
+slates run slates_estimate_generation_cost --model kling-v3-standard-5s
+
+# Generate an image into a project
+slates run slates_generate_image --projectId <uuid> --prompt "..." --resolution 1k --aspectRatio 16:9
+
+# Kick off a video in the background, then poll it
+slates run slates_generate_video --projectId <uuid> --model veo-3.1-fast --prompt "..." --aspectRatio 16:9 --duration 8 --background true --confirm true
+slates run slates_get_generation_status --generationId <uuid>
+
+# Assemble + export
+slates run slates_add_clip_to_timeline --projectId <uuid> --assetId <uuid>
+slates run slates_export_video --projectId <uuid> --outputPath "C:\\Videos\\ad.mp4"
+
+# Structured output for scripting
+slates run slates_get_credit_balance --json
+```
+
+> The timeline, export, background-generation, edit-image, and image-reference ops need a Slates desktop on agent API v2 — if an op reports a version error, update Slates (Settings → Check for Updates) and retry.
+
+Notes for agent use:
+
+- Repeated flags or comma lists become arrays: `--ids a,b,c`.
+- `--json` emits `{text, data, images}`. Image entries carry `mimeType` and byte count only, not the binary. Use the MCP server (`@slatesvideo/mcp-server`) when the agent needs to see generated images inline.
+- Generation ops gate on missing `aspectRatio`/`resolution` and on cost over $0.50 (`confirm=true` required), so a scripted run cannot silently overspend.
+
+## First-time setup
+
+1. Install and open the Slates desktop app.
+2. **Settings → Agent Control → enter your email → Send link.** Click the emailed link.
+3. `slates status` should now show your account. (Alternative: `slates login`.)
+
+Credentials live in `~/.slates/agent-connection.json`. No env vars.
+
+## Links
+
+- Website: [slates.video](https://slates.video)
+- Source: [github.com/EricDisero/slates-mcp](https://github.com/EricDisero/slates-mcp)
+- Issues: [github.com/EricDisero/slates-mcp/issues](https://github.com/EricDisero/slates-mcp/issues)

package/dist/commands/install-skills.d.ts

@@ -1,5 +1,5 @@
 interface InstallSkillsOptions {
-    force: boolean;
+    global?: boolean;
 }
 export declare function runInstallSkills(opts: InstallSkillsOptions): void;
 export {};

package/dist/commands/install-skills.js

@@ -1,36 +1,83 @@
-import { join, dirname } from 'node:path';
-import { fileURLToPath } from 'node:url';
-import { existsSync, readdirSync, readFileSync, writeFileSync, mkdirSync, } from 'node:fs';
-// Copy bundled skill markdown files into ./.claude/skills/ in the user's
-// current working directory. Mirrors how Higgsfield ships its CLI: skills
-// are markdown recipes that compose the operation surface. They auto-
-// register with Claude Code skill discovery once they're on disk.
+import { join } from 'node:path';
+import { homedir } from 'node:os';
+import { existsSync, readdirSync, writeFileSync, mkdirSync, rmSync, statSync, } from 'node:fs';
+import { SKILLS } from '@slatesvideo/shared';
+// Install the bundled skill markdown into Claude Code's skill directories.
+//
+// Skill content is embedded in @slatesvideo/shared (generated from
+// packages/shared/skills/*.md at build time), so the install works no matter
+// how the CLI was delivered — global npm install, npx, or a bundled binary.
+//
+// Claude Code discovers skills as DIRECTORIES: .claude/skills/<name>/SKILL.md.
+// A loose .md file dropped straight into .claude/skills/ is silently never
+// loaded. So each bundled skill is written to its own <name>/SKILL.md folder,
+// where <name> comes from the skill's frontmatter `name:` field (falling back
+// to the embedded key, the source filename sans .md). Discovery runs at
+// session start — a restart of Claude Code is required before new skills
+// appear.
+function frontmatterName(markdown, fallback) {
+    if (!markdown.startsWith('---'))
+        return fallback;
+    const end = markdown.indexOf('\n---', 3);
+    if (end === -1)
+        return fallback;
+    const block = markdown.slice(3, end);
+    const m = block.match(/^name:\s*(.+?)\s*$/m);
+    return m ? m[1].trim() : fallback;
+}
 export function runInstallSkills(opts) {
-    const here = dirname(fileURLToPath(import.meta.url));
-    // dist/commands → walk up to package root, then look for /skills.
-    const pkgRoot = join(here, '..', '..');
-    const skillsRoot = join(pkgRoot, 'skills');
-    if (!existsSync(skillsRoot)) {
-        console.error(`Bundled skills not found at ${skillsRoot}`);
+    const skillEntries = Object.entries(SKILLS);
+    if (skillEntries.length === 0) {
+        console.error('No bundled skills found in @slatesvideo/shared — broken build?');
         process.exit(1);
     }
-    const target = join(process.cwd(), '.claude', 'skills');
+    const target = opts.global
+        ? join(homedir(), '.claude', 'skills')
+        : join(process.cwd(), '.claude', 'skills');
     if (!existsSync(target))
         mkdirSync(target, { recursive: true });
-    const files = readdirSync(skillsRoot).filter((f) => f.endsWith('.md'));
-    let copied = 0;
-    let skipped = 0;
-    for (const file of files) {
-        const dest = join(target, file);
-        if (existsSync(dest) && !opts.force) {
-            console.log(`skip   ${file} (already exists, use --force to overwrite)`);
-            skipped++;
-            continue;
+    // Migrate away from the old broken layout: earlier versions of this
+    // command copied loose slates-*.md files flat into the skills root, where
+    // Claude Code never discovers them. Remove them — the same content is
+    // about to be written in the correct <name>/SKILL.md layout. EXACT
+    // filename match only (the embedded key + .md): a slates-* glob would
+    // also delete a user's own files (e.g. slates-notes.md).
+    const legacyFilenames = new Set(skillEntries.map(([key]) => `${key}.md`));
+    const stale = readdirSync(target).filter((f) => {
+        if (!legacyFilenames.has(f))
+            return false;
+        try {
+            return statSync(join(target, f)).isFile();
+        }
+        catch {
+            return false;
+        }
+    });
+    for (const f of stale)
+        rmSync(join(target, f));
+    if (stale.length > 0) {
+        console.log(`Removed ${stale.length} stale flat .md file(s) left by a previous install — ` +
+            `the old flat layout was never picked up by Claude Code. Reinstalling in the correct layout now.`);
+    }
+    let fresh = 0;
+    let updated = 0;
+    for (const [key, content] of skillEntries) {
+        const name = frontmatterName(content, key);
+        const dir = join(target, name);
+        const isUpdate = existsSync(dir);
+        mkdirSync(dir, { recursive: true });
+        writeFileSync(join(dir, 'SKILL.md'), content);
+        if (isUpdate) {
+            updated++;
+            console.log(`update  ${name}`);
+        }
+        else {
+            fresh++;
+            console.log(`install ${name}`);
         }
-        writeFileSync(dest, readFileSync(join(skillsRoot, file)));
-        console.log(`write  ${file}`);
-        copied++;
     }
-    console.log(`\nInstalled ${copied} skill(s), skipped ${skipped}, into ${target}`);
+    const total = fresh + updated;
+    console.log(`\nInstalled ${total} skill(s) (${fresh} new, ${updated} updated) into ${target}`);
+    console.log(`Restart Claude Code, then ask: 'what slates skills do you have?' to verify.`);
 }
 //# sourceMappingURL=install-skills.js.map

package/dist/commands/login.js

@@ -31,6 +31,12 @@ export async function runLogin(opts) {
         process.exit(1);
     }
     console.log(`\nA sign-in link is on its way to ${trimmed}.`);
+    // Newer slates-api versions return a short user code (e.g. XK4-P2N) that
+    // the authorization page asks the user to verify — anti-phishing pairing.
+    // Older servers omit the field; show nothing in that case.
+    if (reqBody.userCode) {
+        console.log(`Confirm this code on the authorization page: ${reqBody.userCode}`);
+    }
     console.log('Click the link, then return here. Waiting (10 min max)...\n');
     const start = Date.now();
     const timeoutMs = 10 * 60 * 1000;

package/dist/commands/mcp.d.ts

@@ -0,0 +1,6 @@
+interface McpOptions {
+    write?: boolean;
+}
+export declare function runMcp(opts: McpOptions): void;
+export {};
+//# sourceMappingURL=mcp.d.ts.map

package/dist/commands/mcp.js

@@ -0,0 +1,146 @@
+import { join, delimiter } from 'node:path';
+import { homedir, platform } from 'node:os';
+import { existsSync, readFileSync, writeFileSync, copyFileSync } from 'node:fs';
+// `slates mcp` — zero-to-configured MCP in one command.
+//
+// Detects installed MCP clients (Claude Code, Claude Desktop, Cursor) and
+// prints the exact config for each one found. With --write, safely merges
+// the "slates" mcpServers entry into Claude Desktop's and Cursor's config
+// files (backing up the original to <file>.bak first). No interactive
+// prompts — flags only.
+const SLATES_ENTRY = {
+    command: 'npx',
+    args: ['-y', '@slatesvideo/mcp-server'],
+};
+const MCP_JSON_SNIPPET = JSON.stringify({ mcpServers: { slates: SLATES_ENTRY } }, null, 2);
+function claudeDesktopConfigPath() {
+    const os = platform();
+    if (os === 'win32') {
+        const appData = process.env.APPDATA ?? join(homedir(), 'AppData', 'Roaming');
+        return join(appData, 'Claude', 'claude_desktop_config.json');
+    }
+    if (os === 'darwin') {
+        return join(homedir(), 'Library', 'Application Support', 'Claude', 'claude_desktop_config.json');
+    }
+    return join(homedir(), '.config', 'Claude', 'claude_desktop_config.json');
+}
+function cursorConfigPath() {
+    return join(homedir(), '.cursor', 'mcp.json');
+}
+function claudeBinaryOnPath() {
+    const pathVar = process.env.PATH ?? '';
+    const exts = platform() === 'win32' ? ['.cmd', '.exe', '.bat', ''] : [''];
+    for (const dir of pathVar.split(delimiter)) {
+        if (!dir)
+            continue;
+        for (const ext of exts) {
+            try {
+                if (existsSync(join(dir, `claude${ext}`)))
+                    return true;
+            }
+            catch {
+                // Unreadable PATH entry — skip.
+            }
+        }
+    }
+    return false;
+}
+// Merge the "slates" key into an existing mcpServers JSON config file.
+// Touches ONLY mcpServers.slates; everything else in the file is preserved.
+// The original is backed up to <file>.bak before writing.
+function mergeIntoConfig(file, label) {
+    let config = {};
+    try {
+        const text = readFileSync(file, 'utf8');
+        config = text.trim().length > 0 ? JSON.parse(text) : {};
+    }
+    catch (err) {
+        console.error(`  Could not parse ${label} config at ${file}: ${err instanceof Error ? err.message : String(err)}`);
+        console.error('  Not writing — fix the JSON (or merge the snippet above by hand).');
+        return false;
+    }
+    copyFileSync(file, `${file}.bak`);
+    const servers = config.mcpServers && typeof config.mcpServers === 'object'
+        ? config.mcpServers
+        : {};
+    servers.slates = SLATES_ENTRY;
+    config.mcpServers = servers;
+    writeFileSync(file, JSON.stringify(config, null, 2) + '\n');
+    console.log(`  Wrote "slates" into ${file} (backup at ${file}.bak)`);
+    return true;
+}
+function printClaudeCodeSection() {
+    console.log('\n── Claude Code ──');
+    console.log('  Run this in your terminal:');
+    console.log('\n    claude mcp add slates -- npx -y @slatesvideo/mcp-server\n');
+}
+function printClaudeDesktopSection(file, detected) {
+    console.log('\n── Claude Desktop ──');
+    console.log(`  Config file: ${file}${detected ? '' : ' (not found — create it)'}`);
+    console.log('  Merge this into the file (or run `slates mcp --write`):\n');
+    console.log(indent(MCP_JSON_SNIPPET, 4));
+}
+function printCursorSection(file, detected) {
+    console.log('\n── Cursor ──');
+    console.log(`  Config file: ${file}${detected ? '' : ' (not found — create it)'}`);
+    console.log('  Merge this into the file (or run `slates mcp --write`):\n');
+    console.log(indent(MCP_JSON_SNIPPET, 4));
+}
+function indent(text, spaces) {
+    const pad = ' '.repeat(spaces);
+    return text
+        .split('\n')
+        .map((l) => pad + l)
+        .join('\n');
+}
+export function runMcp(opts) {
+    const desktopFile = claudeDesktopConfigPath();
+    const cursorFile = cursorConfigPath();
+    const hasClaudeCode = claudeBinaryOnPath();
+    const hasClaudeDesktop = existsSync(desktopFile);
+    const hasCursor = existsSync(cursorFile);
+    const anyDetected = hasClaudeCode || hasClaudeDesktop || hasCursor;
+    if (anyDetected) {
+        const found = [];
+        if (hasClaudeCode)
+            found.push('Claude Code');
+        if (hasClaudeDesktop)
+            found.push('Claude Desktop');
+        if (hasCursor)
+            found.push('Cursor');
+        console.log(`Detected: ${found.join(', ')}`);
+    }
+    else {
+        console.log('No MCP client detected — showing setup for all three.');
+    }
+    if (hasClaudeCode || !anyDetected)
+        printClaudeCodeSection();
+    if (hasClaudeDesktop || !anyDetected)
+        printClaudeDesktopSection(desktopFile, hasClaudeDesktop);
+    if (hasCursor || !anyDetected)
+        printCursorSection(cursorFile, hasCursor);
+    if (opts.write) {
+        console.log('\n── Writing configs ──');
+        let wrote = 0;
+        if (hasClaudeDesktop) {
+            if (mergeIntoConfig(desktopFile, 'Claude Desktop'))
+                wrote++;
+        }
+        if (hasCursor) {
+            if (mergeIntoConfig(cursorFile, 'Cursor'))
+                wrote++;
+        }
+        if (!hasClaudeDesktop && !hasCursor) {
+            console.log('  Nothing to write — no Claude Desktop or Cursor config file found.');
+            console.log('  (--write only edits existing config files; Claude Code uses the one-liner above.)');
+        }
+        else if (wrote > 0) {
+            console.log('  Restart the client(s) to pick up the new server.');
+        }
+    }
+    console.log('\n── Next steps ──');
+    console.log('  1. Connect your account: open Slates → Settings → Agent Control → Send link');
+    console.log('     (or run `slates login`)');
+    console.log('  2. Install the agent skills: `slates install-skills`');
+}
+//# sourceMappingURL=mcp.js.map

package/dist/commands/op.js

@@ -87,7 +87,7 @@ export async function runOp(opts) {
     console.log(result.text);
     if (result.images && result.images.length > 0) {
         console.log(`\nReturned ${result.images.length} inline image(s).`);
-        console.log('(use --json to get the full payload, or use the MCP server for vision-aware tools)');
+        console.log('(--json reports image metadata only, not the bytes — use the MCP server for vision-aware tools)');
     }
 }
 function coerceForSchema(schema, raw) {
@@ -97,19 +97,81 @@ function coerceForSchema(schema, raw) {
     const shape = typeof zodObj._def.shape === 'function'
         ? zodObj._def.shape()
         : zodObj.shape ?? {};
+    // Unwrap ZodOptional / ZodDefault / ZodNullable / ZodEffects / ZodReadonly
+    // to find the leaf type. `z.number().optional()` reports typeName
+    // 'ZodOptional' with `_def.innerType` pointing at the ZodNumber.
+    const wrappers = new Set([
+        'ZodOptional',
+        'ZodDefault',
+        'ZodNullable',
+        'ZodReadonly',
+        'ZodEffects',
+        'ZodCatch',
+        'ZodBranded',
+    ]);
+    const unwrap = (t) => {
+        let cur = t;
+        let depth = 0;
+        while (cur?._def?.typeName && wrappers.has(cur._def.typeName) && depth < 8) {
+            cur = cur._def.innerType ?? cur._def.schema;
+            depth++;
+        }
+        return cur;
+    };
+    // Does the declared type allow null anywhere in its wrapper chain?
+    // (e.g. z.string().uuid().nullable() — so `--folderId null` → null.)
+    const isNullable = (t) => {
+        let cur = t;
+        let depth = 0;
+        while (cur?._def?.typeName && depth < 8) {
+            if (cur._def.typeName === 'ZodNullable')
+                return true;
+            if (wrappers.has(cur._def.typeName)) {
+                cur = cur._def.innerType ?? cur._def.schema;
+                depth++;
+                continue;
+            }
+            break;
+        }
+        return false;
+    };
+    const coerceScalar = (fieldType, value) => {
+        if (fieldType === 'ZodNumber') {
+            const n = Number(value);
+            return Number.isFinite(n) ? n : value;
+        }
+        if (fieldType === 'ZodBoolean')
+            return value === 'true' || value === '1';
+        return value;
+    };
     const out = {};
     for (const [key, value] of Object.entries(raw)) {
-        const fieldType = (shape[key]?._def?.typeName ?? '');
+        const declared = shape[key];
+        const leaf = unwrap(declared);
+        const fieldType = (leaf?._def?.typeName ?? '');
+        // `--folderId null` (or a bare `--folderId` → true is NOT null) → JS null
+        // for fields that actually allow null. Enables "move to project root",
+        // "clear character turnaround", etc. from the CLI.
+        if (value === 'null' && isNullable(declared)) {
+            out[key] = null;
+            continue;
+        }
+        // Array fields: a single `--ids X` produced a bare string; repeated
+        // `--ids X --ids Y` produced an array. Accept either, plus comma-split
+        // (`--ids a,b,c`). Coerce each element to the array's element type.
+        if (fieldType === 'ZodArray') {
+            const elemType = (leaf?._def?.type?._def?.typeName ?? '');
+            const arr = Array.isArray(value)
+                ? value
+                : typeof value === 'string'
+                    ? value.split(',').map((s) => s.trim()).filter((s) => s.length > 0)
+                    : [value];
+            out[key] = arr.map((v) => (typeof v === 'string' ? coerceScalar(elemType, v) : v));
+            continue;
+        }
         if (typeof value === 'string') {
-            if (fieldType === 'ZodNumber') {
-                const n = Number(value);
-                out[key] = Number.isFinite(n) ? n : value;
-                continue;
-            }
-            if (fieldType === 'ZodBoolean') {
-                out[key] = value === 'true' || value === '1';
-                continue;
-            }
+            out[key] = coerceScalar(fieldType, value);
+            continue;
         }
         out[key] = value;
     }

package/dist/index.js

@@ -1,36 +1,42 @@
 #!/usr/bin/env node
 import { Command } from 'commander';
+import { readFileSync } from 'node:fs';
+import { join, dirname } from 'node:path';
+import { fileURLToPath } from 'node:url';
 import { readConnection, setCloudToken, clearCloudToken } from '@slatesvideo/shared';
 import { runLogin } from './commands/login.js';
 import { runLogout } from './commands/logout.js';
 import { runStatus } from './commands/status.js';
 import { runOp } from './commands/op.js';
 import { runInstallSkills } from './commands/install-skills.js';
+import { runMcp } from './commands/mcp.js';
 import { ALL_OPERATIONS } from '@slatesvideo/shared';
 // Slates CLI. The CLI mirrors the MCP tool surface as commands so Claude
-// Code can shell out to them and skip the cost of loading 20+ tool
-// schemas into its context window. Skills (in packages/skills) tell the
-// agent how to compose them.
+// Code can shell out to them instead of loading every tool schema into
+// its context window. Bundled skills (embedded in @slatesvideo/shared,
+// installed via `slates install-skills`) tell the agent how to compose
+// the operations into recipes.
 //
 // First-time use:
-//   1. Open Slates desktop → Settings → Agent Control → toggle on.
-//   2. Run `slates login` — sends a magic link to your account email.
-//   3. Click the link in your email.
-//   4. The CLI auto-detects the connection and writes the cloud token
-//      into ~/.slates/agent-connection.json. The desktop app's local
-//      port + token are already there from step 1.
+//   1. Open Slates desktop → Settings → Agent Control → Send link.
+//   2. Click the link in your email (or run `slates login`).
+//   3. The connection is written to ~/.slates/agent-connection.json —
+//      cloud token + the desktop app's local port + token.
 //
 // Inside Claude Code:
-//   `/slates run slates_create_project --name "neon samurai"`
-//   `/slates run slates_generate_image --prompt "..." --resolution 2k`
+//   slates run slates_create_project --name "neon samurai"
+//   slates run slates_generate_image --prompt "..." --resolution 1k --aspectRatio 16:9
 //
-// Or import @slatesvideo/skills/*.md into .claude/skills/ for higher-
-// level recipes.
+// Run `slates install-skills` to copy the bundled skills into
+// .claude/skills/<name>/SKILL.md for higher-level recipes.
+// Version comes from this package's own package.json (dist/index.js → ../package.json)
+// so the CLI never drifts from the published version.
+const pkg = JSON.parse(readFileSync(join(dirname(fileURLToPath(import.meta.url)), '..', 'package.json'), 'utf8'));
 const program = new Command();
 program
     .name('slates')
     .description('Slates CLI — drive AI Video Creation Studio from your terminal.')
-    .version('0.1.0')
+    .version(pkg.version)
     .enablePositionalOptions();
 program
     .command('login')
@@ -47,16 +53,21 @@ program
     .command('status')
     .description('Show the current Slates connection status.')
     .action(() => runStatus());
+program
+    .command('mcp')
+    .description('Detect installed MCP clients and print (or write) the Slates MCP config for each.')
+    .option('--write', 'Merge the "slates" entry into detected Claude Desktop / Cursor config files (backs up to .bak first)', false)
+    .action((opts) => runMcp(opts));
 program
     .command('install-skills')
-    .description('Copy the bundled skills into your local .claude/skills directory.')
-    .option('--force', 'Overwrite existing skill files', false)
+    .description('Install the bundled skills into .claude/skills/<name>/SKILL.md (Claude Code layout).')
+    .option('--global', 'Install into ~/.claude/skills instead of the current project', false)
     .action((opts) => runInstallSkills(opts));
-const runCmd = program
+program
     .command('run')
     .description('Invoke a Slates operation by id (use `slates run --list` to see them).')
     .option('--list', 'List all available operations', false)
-    .option('--json', 'Emit raw JSON response instead of formatted text', false)
+    .option('--json', 'Emit structured JSON ({text, data, images: [{mimeType, bytes}]}). Image binary is omitted — use the MCP server for inline image payloads.', false)
     .allowUnknownOption()
     .passThroughOptions()
     .argument('[opId]', 'Operation id, e.g. slates_create_project')
@@ -99,6 +110,12 @@ program
     clearCloudToken();
     console.log('Cloud token cleared.');
 });
+// Bare `slates` with no args: print help and exit 0 (commander's default
+// help-on-missing-command exits 1, which reads as an error to scripts).
+if (process.argv.length <= 2) {
+    program.outputHelp();
+    process.exit(0);
+}
 program.parseAsync(process.argv).catch((err) => {
     console.error(err instanceof Error ? err.message : String(err));
     process.exit(1);

package/package.json

@@ -1,23 +1,54 @@
 {
   "name": "@slatesvideo/cli",
-  "version": "0.1.0",
-  "description": "Slates CLI — drive Slates from your terminal or Claude Code via shell-out.",
-  "license": "UNLICENSED",
+  "version": "0.4.0",
+  "description": "Slates CLI: drive the Slates AI video studio from your terminal or let Claude Code shell out to it. Includes the bundled agent skills and an MCP client configurator.",
+  "license": "MIT",
   "type": "module",
   "bin": {
-    "slates": "./dist/index.js"
+    "slates": "dist/index.js"
   },
   "main": "./dist/index.js",
-  "files": ["dist", "skills", "README.md"],
+  "files": [
+    "dist",
+    "!dist/**/*.map",
+    "README.md"
+  ],
   "scripts": {
     "build": "tsc",
     "start": "node dist/index.js",
-    "typecheck": "tsc --noEmit"
+    "typecheck": "tsc --noEmit",
+    "prepublishOnly": "npm run build"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/EricDisero/slates-mcp.git",
+    "directory": "packages/cli"
+  },
+  "homepage": "https://slates.video",
+  "bugs": {
+    "url": "https://github.com/EricDisero/slates-mcp/issues"
+  },
+  "keywords": [
+    "slates",
+    "cli",
+    "mcp",
+    "model-context-protocol",
+    "ai-video",
+    "video-generation",
+    "image-generation",
+    "claude",
+    "claude-code",
+    "agent-skills",
+    "veo",
+    "kling",
+    "seedance"
+  ],
+  "engines": {
+    "node": ">=18"
   },
   "dependencies": {
-    "@slatesvideo/shared": "0.1.0",
+    "@slatesvideo/shared": "0.4.0",
     "commander": "^12.1.0",
-    "open": "^10.0.0",
     "zod": "^3.23.0"
   },
   "devDependencies": {

package/dist/commands/install-skills.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"install-skills.d.ts","sourceRoot":"","sources":["../../src/commands/install-skills.ts"],"names":[],"mappings":"AAUA,UAAU,oBAAoB;IAC5B,KAAK,EAAE,OAAO,CAAA;CACf;AAOD,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,oBAAoB,GAAG,IAAI,CA8BjE"}

package/dist/commands/install-skills.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"install-skills.js","sourceRoot":"","sources":["../../src/commands/install-skills.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AACzC,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAA;AACxC,OAAO,EACL,UAAU,EACV,WAAW,EACX,YAAY,EACZ,aAAa,EACb,SAAS,GACV,MAAM,SAAS,CAAA;AAMhB,yEAAyE;AACzE,0EAA0E;AAC1E,sEAAsE;AACtE,kEAAkE;AAElE,MAAM,UAAU,gBAAgB,CAAC,IAA0B;IACzD,MAAM,IAAI,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAA;IACpD,kEAAkE;IAClE,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,CAAA;IACtC,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAA;IAE1C,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;QAC5B,OAAO,CAAC,KAAK,CAAC,+BAA+B,UAAU,EAAE,CAAC,CAAA;QAC1D,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;IACjB,CAAC;IAED,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,QAAQ,CAAC,CAAA;IACvD,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC;QAAE,SAAS,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAA;IAE/D,MAAM,KAAK,GAAG,WAAW,CAAC,UAAU,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAA;IACtE,IAAI,MAAM,GAAG,CAAC,CAAA;IACd,IAAI,OAAO,GAAG,CAAC,CAAA;IACf,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,CAAA;QAC/B,IAAI,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC;YACpC,OAAO,CAAC,GAAG,CAAC,UAAU,IAAI,6CAA6C,CAAC,CAAA;YACxE,OAAO,EAAE,CAAA;YACT,SAAQ;QACV,CAAC;QACD,aAAa,CAAC,IAAI,EAAE,YAAY,CAAC,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC,CAAC,CAAA;QACzD,OAAO,CAAC,GAAG,CAAC,UAAU,IAAI,EAAE,CAAC,CAAA;QAC7B,MAAM,EAAE,CAAA;IACV,CAAC;IAED,OAAO,CAAC,GAAG,CAAC,eAAe,MAAM,sBAAsB,OAAO,UAAU,MAAM,EAAE,CAAC,CAAA;AACnF,CAAC"}

package/dist/commands/login.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"login.d.ts","sourceRoot":"","sources":["../../src/commands/login.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,YAAY;IAC3B,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAED,wBAAsB,QAAQ,CAAC,IAAI,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAiEhE"}

package/dist/commands/login.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"login.js","sourceRoot":"","sources":["../../src/commands/login.ts"],"names":[],"mappings":"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"}

package/dist/commands/logout.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"logout.d.ts","sourceRoot":"","sources":["../../src/commands/logout.ts"],"names":[],"mappings":"AAEA,wBAAgB,SAAS,IAAI,IAAI,CAGhC"}

package/dist/commands/logout.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"logout.js","sourceRoot":"","sources":["../../src/commands/logout.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAA;AAErD,MAAM,UAAU,SAAS;IACvB,eAAe,EAAE,CAAA;IACjB,OAAO,CAAC,GAAG,CAAC,sBAAsB,CAAC,CAAA;AACrC,CAAC"}

package/dist/commands/op.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"op.d.ts","sourceRoot":"","sources":["../../src/commands/op.ts"],"names":[],"mappings":"AAEA,UAAU,YAAY;IACpB,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,EAAE,CAAA;IACjB,IAAI,EAAE,OAAO,CAAA;CACd;AAsDD,wBAAsB,KAAK,CAAC,IAAI,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CA+C7D"}

package/dist/commands/op.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"op.js","sourceRoot":"","sources":["../../src/commands/op.ts"],"names":[],"mappings":"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"}

package/dist/commands/status.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"status.d.ts","sourceRoot":"","sources":["../../src/commands/status.ts"],"names":[],"mappings":"AAGA,wBAAsB,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC,CAmC/C"}

package/dist/commands/status.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"status.js","sourceRoot":"","sources":["../../src/commands/status.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAA;AAG5F,MAAM,CAAC,KAAK,UAAU,SAAS;IAC7B,MAAM,CAAC,GAAG,cAAc,EAAE,CAAA;IAC1B,OAAO,CAAC,GAAG,CAAC,kCAAkC,CAAC,CAAA;IAC/C,OAAO,CAAC,GAAG,CAAC,sBAAsB,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,8BAA8B,EAAE,CAAC,CAAA;IAC/F,OAAO,CAAC,GAAG,CACT,sBACE,CAAC,CAAC,OAAO,CAAC,OAAO;QACf,CAAC,CAAC,wBAAwB,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE;QAC1C,CAAC,CAAC,mDACN,EAAE,CACH,CAAA;IAED,IAAI,CAAC,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;QAClB,IAAI,CAAC;YACH,MAAM,KAAK,GAAG,IAAI,iBAAiB,EAAE,CAAA;YACrC,MAAM,EAAE,GAAG,MAAM,KAAK,CAAC,GAAG,CAAiB,eAAe,CAAC,CAAA;YAC3D,OAAO,CAAC,GAAG,CAAC,wBAAwB,EAAE,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC,CAAA;YACpD,OAAO,CAAC,GAAG,CAAC,sBAAsB,EAAE,CAAC,IAAI,CAAC,cAAc,EAAE,CAAC,CAAA;YAC3D,OAAO,CAAC,GAAG,CAAC,sBAAsB,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAA;YACjD,OAAO,CAAC,GAAG,CAAC,uBAAuB,EAAE,CAAC,IAAI,CAAC,sBAAsB,EAAE,CAAC,CAAA;YACpE,OAAO,CAAC,GAAG,CAAC,sBAAsB,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;QAC3D,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,CAAC,IAAI,CAAC,yBAAyB,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAA;QAC3F,CAAC;IACH,CAAC;IAED,IAAI,CAAC,CAAC,OAAO,CAAC,OAAO,IAAI,CAAC,CAAC,OAAO,CAAC,IAAI,IAAI,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;QAC3D,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,IAAI,mBAAmB,EAAE,CAAA;YACzC,MAAM,CAAC,GAAG,MAAM,OAAO,CAAC,OAAO,EAAE,CAAA;YACjC,OAAO,CAAC,GAAG,CAAC,wBAAwB,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAA;QAC5D,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,CAAC,IAAI,CAAC,0BAA0B,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,CAAA;QACrF,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}

package/dist/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/util/prompt.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"prompt.d.ts","sourceRoot":"","sources":["../../src/util/prompt.ts"],"names":[],"mappings":"AAEA,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAQ7D"}

package/dist/util/prompt.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"prompt.js","sourceRoot":"","sources":["../../src/util/prompt.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAA;AAE/C,MAAM,UAAU,WAAW,CAAC,QAAgB;IAC1C,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;QAC7B,MAAM,EAAE,GAAG,eAAe,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC,CAAA;QAC5E,EAAE,CAAC,QAAQ,CAAC,QAAQ,EAAE,CAAC,MAAM,EAAE,EAAE;YAC/B,EAAE,CAAC,KAAK,EAAE,CAAA;YACV,OAAO,CAAC,MAAM,CAAC,CAAA;QACjB,CAAC,CAAC,CAAA;IACJ,CAAC,CAAC,CAAA;AACJ,CAAC"}

package/skills/slates-character-turnaround.md

@@ -1,53 +0,0 @@
----
-name: slates-character-turnaround
-description: Build a Slates character from a reference image — generate the turnaround sheet and expression sheet, bind both to the character's slots so the user sees the character card update live. Use when the user wants to "create a character", "build a character from this image", "generate a turnaround for X", or starts any storyboard-flow that needs consistent character references.
----
-
-# Character turnaround — Slates workflow
-
-Slates stores characters with two image slots: turnaround (full-body multi-angle) and expression sheet (face emotions). The whole storyboard generation pipeline pulls these via `@character` mentions for visual consistency. Building them well = consistent character across every frame.
-
-## Workflow
-
-### 1. Get the reference
-The user has either:
-- Pasted/uploaded an image of the character (real person, drawing, AI render).
-- Described the character in text only.
-
-If image: upload it as a reference (`slates_upload_reference_image`).
-If text only: skip step 2 and generate the turnaround from prompt-only (less consistent — warn the user).
-
-### 2. Create the character record
-`slates_create_character` with:
-- `name` (ask if not given)
-- `style` — match the project's overall style (`realistic`, `anime`, `pixar`, `comic-book`).
-- `description` — 1-2 sentences, *visual* only ("tall, dark hair, scar over left eye"), not personality.
-
-### 3. Generate the turnaround sheet
-- Use `slates_generate_image` with a prompt like:
-  > "Character turnaround sheet: 5 angles (front, 3/4 left, profile left, 3/4 right, back). Neutral pose. Even studio lighting. White background. {character description}"
-- Pass the reference image URL/ID as a reference.
-- Resolution: **2k** (default). 4k only if the user specifies.
-- Estimate cost first.
-
-When the result returns inline:
-- Evaluate against the reference. Is it the same character?
-- If wrong angle count / inconsistent: refine prompt with explicit angle list, regenerate once.
-- When right: bind via `slates_set_character_turnaround_asset` (the user sees the character card update).
-
-### 4. Generate the expression sheet
-- Prompt:
-  > "Expression sheet: 6 expressions (neutral, happy, angry, sad, surprised, determined). Same character, same lighting as the turnaround. {character description}"
-- Pass BOTH the original reference AND the just-generated turnaround as references for max consistency.
-- Same model, same resolution.
-- On success bind via `slates_set_character_expression_asset`.
-
-### 5. Hand back
-> "Character {name} ready. Turnaround + expressions bound. Use `@{name}` in any prompt to attach these references."
-
-## Anti-patterns
-
-- **Don't** generate turnaround and expressions in one prompt. Slates expects them as two separate assets in two separate slots.
-- **Don't** skip binding. The slots are what the storyboard pipeline reads — an unbound asset doesn't help downstream.
-- **Don't** invent character details. Stick to what's in the reference image and the user's description.
-- **Don't** use 4k unless asked — wastes credits, no quality gain at sheet scale.

package/skills/slates-direct-response-ad.md

@@ -1,62 +0,0 @@
----
-name: slates-direct-response-ad
-description: Build a 30-second hyper-motion direct-response ad in Slates from a product image and brief. Composes upload → storyboard → frame gen → motion gen → timeline → export. Use when the user drops a product image and asks for "an ad", "a promo video", "a TikTok ad", "an Instagram ad", a launch video, or any short-form direct-response video built around a product.
----
-
-# Direct-response ad — Slates workflow
-
-You are building a 30-second hyper-motion direct-response ad. The user has handed you a product image (or product URL) and a short brief. Slates desktop is open on the second monitor; the user watches it populate as you work.
-
-**Hard rules**
-
-- Always estimate cost before generating. Use `slates_estimate_generation_cost` and surface the total.
-- All MCP/CLI generation routes through Slates Credits, period. BYOK is desktop-UI only by design — don't suggest "use your own keys" workarounds.
-- Default model: `nano-banana-2-2k`. For close-up product hero frames step up to `4k` only if the user asks.
-- Hyper-motion = punchy cuts, 4 frames in 30 seconds, ~7s each. Don't over-storyboard.
-
-## Workflow
-
-### 1. Set up the project
-- Create a project named for the product (`slates_create_project`).
-- If the user gave a product image as a file path, upload it (`slates_upload_reference_image`).
-- If they pasted base64 / a data URL, use the same op with `dataUrl`.
-
-### 2. Generate the storyboard frames
-Build exactly 4 frames in this order:
-
-| # | Beat | Visual goal |
-|---|------|-------------|
-| 1 | Hook | Hyper-close-up of the product, dramatic light, motion blur edge |
-| 2 | Lifestyle | Real person using/wearing/holding the product, eye contact |
-| 3 | Problem→solution | The before/after moment that justifies the buy |
-| 4 | CTA | Clean product hero with mental room for an overlaid CTA in editing |
-
-For each frame:
-1. Draft a tight 1-2 sentence prompt (visual only — no copy text in the image).
-2. Reference the product upload's URL or asset ID for visual fidelity.
-3. Call `slates_generate_image` with that prompt + reference. **You see the result inline — evaluate it.**
-4. If it's wrong: refine prompt, regenerate. If it's right: bind it as a frame in the storyboard (`slates_add_frame`).
-
-### 3. Build the storyboard
-- `slates_create_storyboard` named "30s ad — v1".
-- Default scene already exists. Add 3 more scenes ("Hook", "Lifestyle", "Problem-Solution", "CTA") via `slates_add_scene`, or just add all 4 frames to the default scene.
-- For each generated image, add a frame referencing the asset id (`slates_add_frame`).
-
-### 4. Hand back to the user
-- Surface estimated total credits spent.
-- Tell the user the storyboard is ready and they can either:
-  - **In Slates desktop:** click each frame to generate motion (the existing UI handles motion generation).
-  - **Continue here:** ask you to keep going.
-
-If they say keep going, generate motion for each frame using the highest-confidence model the budget allows (Veo 3.1 Fast 8s by default). Then call the export op.
-
-## Anti-patterns
-
-- **Don't** generate text overlays in the image. Slates renders captions/CTAs at the editor stage.
-- **Don't** burn credits on slot-machine prompting. If the first generation is off, refine the prompt; don't just regenerate.
-- **Don't** skip the cost estimate. Confirm with the user above $0.50.
-- **Don't** invent visual specifics about the product (colors, textures, angles) that aren't in the reference image. Reference-anchored prompts only.
-
-## Voice
-
-The ad lives or dies on the hook frame. Tight, sensory, no fluff. Match the user's brand. Default tone is "scroll-stopping" not "informative."

package/skills/slates-edit-and-iterate.md

@@ -1,46 +0,0 @@
----
-name: slates-edit-and-iterate
-description: Iterate on an existing Slates asset — re-evaluate, refine prompt, regenerate or edit. Use when the user has an existing generated image in Slates and wants to "tweak it", "change one thing", "make it warmer", "remove the second person", or any other surgical refinement instead of full regeneration.
----
-
-# Edit and iterate — Slates workflow
-
-The user already has a generated image in Slates and wants to refine it. The vision-feedback-loop skill defines the general pattern; this skill is the specific recipe for "I have asset X, here's what's wrong with it."
-
-## Workflow
-
-### 1. Pull the current asset back into context
-- The user references an asset by id, frame number, or "the latest one."
-- Resolve to an asset id (`slates_list_assets` if needed).
-- `slates_get_asset_image` with that id to load it inline. **You see the image.**
-
-### 2. Identify the delta
-The user's request is one of:
-- **Surgical** — "remove the second figure", "make the sword red", "swap the background to a bamboo forest".
-- **Aesthetic** — "warmer light", "more dramatic", "softer focus".
-- **Compositional** — "wider shot", "lower angle", "centered subject".
-- **Wholesale** — "actually let's try a totally different look."
-
-### 3. Pick the right tool
-| Delta type | Approach |
-|---|---|
-| Surgical | `slates_edit_image` with a focused edit prompt + the original as the source. |
-| Aesthetic / compositional | `slates_generate_image` with the original as a reference + a refined prompt. Don't re-roll from scratch. |
-| Wholesale | New prompt, no reference, fresh generation. Treat as a new brief. |
-
-### 4. Generate, evaluate, decide
-- Estimate cost first.
-- After generation, the result is inline. Compare side-by-side with the original (`slates_get_asset_image` again).
-- If the delta is correct: bind to the same slot (frame, character turnaround, etc.) the original was bound to.
-- If the delta missed: one focused refinement, then regenerate. Cap at 3 tries.
-
-### 5. Hand back
-- "Asset updated. Frame 3 now uses {new_asset_id}."
-- Always note what changed and what didn't, so the user can see the surgery worked: "Lighting shifted to warmer, composition unchanged."
-
-## Anti-patterns
-
-- **Don't** delete the original asset until the user confirms the new one. Slates keeps both; the user picks.
-- **Don't** mix surgical and wholesale changes in one regeneration. The user said "make it warmer" — don't also reframe the shot.
-- **Don't** re-generate when `edit_image` would work. Edits preserve composition and identity; full regen rolls the dice.
-- **Don't** chain >3 iterations without checking in. If three tries didn't land, the brief is wrong, not the model.

package/skills/slates-storyboard-from-script.md

@@ -1,49 +0,0 @@
----
-name: slates-storyboard-from-script
-description: Turn a script or treatment into a Slates storyboard with scenes and frames. Use when the user has a script, treatment, shot list, or scene-by-scene description and wants to materialize it as a Slates storyboard, optionally generating frame images per shot.
----
-
-# Storyboard from script — Slates workflow
-
-The user has a script, treatment, or shot list. You're turning it into a Slates storyboard with scene → frame structure, optionally generating images for each frame.
-
-## Workflow
-
-### 1. Parse the script
-Read the user's script. Decide:
-
-- **Scene count** — usually 1 scene per location/setting change. Don't fragment into one-frame scenes.
-- **Frames per scene** — match the shot list. Default is 3-6 frames per scene unless the script specifies more.
-- **Shot labels** — pull them from the script (e.g., "Wide", "Close-up", "Over-the-shoulder").
-
-If the user hasn't named the storyboard, suggest one based on the project tone.
-
-### 2. Materialize the structure first (no generation yet)
-- `slates_create_storyboard` with the chosen name.
-- For each scene: `slates_add_scene` with a descriptive name and order.
-- For each frame: write a *visual-only* prompt (image, not action), the shot label, and any director notes. **Don't generate yet.**
-
-Surface the planned structure back to the user as a tight summary:
-> Storyboard "X" • 4 scenes • 12 frames total
->   Scene 1: Forest opening (3 frames)
->   Scene 2: Confrontation (4 frames)
->   ...
-
-Ask: **"Generate frame images now? (y/N)"**
-
-### 3. Generate frames if requested
-For each frame:
-- Estimate cost (`slates_estimate_generation_cost`, `count = total frames`). Confirm with user if total > $0.50.
-- Generate sequentially, with character/environment/style references attached when present in the project (`slates_list_characters`, `slates_list_environments`).
-- Each result returns inline. Evaluate. If wrong, refine prompt + regenerate (charge once, not multiple).
-- Bind to the frame via `slates_add_frame`.
-
-### 4. Hand back
-- Total frames generated, total credits spent, storyboard id.
-- Suggest next steps: motion generation (in Slates UI), or `slates_get_storyboard_with_frames` to review.
-
-## Anti-patterns
-
-- **Don't** auto-generate without asking. Generation is the expensive step. Always confirm first.
-- **Don't** invent shot details the script doesn't mention. If the script says "they argue," ask what the shot looks like, don't fabricate "she clenches her fists in a wide shot."
-- **Don't** mix scene structure and frame generation in one pass — building the skeleton first lets the user catch errors before spending credits.

package/skills/slates-vision-feedback-loop.md

@@ -1,42 +0,0 @@
----
-name: slates-vision-feedback-loop
-description: Lower-level utility skill for any Slates workflow that needs to "generate, look at the result, refine, regenerate." Defines the standard inline-vision pattern. Other Slates skills compose this. Use when generating images and you need to confirm they match the brief before moving on, or when the user asks to "iterate" on an image.
----
-
-# Vision feedback loop — Slates utility skill
-
-Slates returns generated images inline as base64. You see the actual pixels. Use that — don't trust prompt-following blindly.
-
-## The pattern
-
-1. **Generate.** Call `slates_generate_image` with a prompt. The result is in your context as an image content block.
-2. **Evaluate against the brief.** What did the user actually want? Are the elements right? Composition? Lighting? Subject identity?
-3. **One of three outcomes:**
-   - **Right** → save it (bind to a frame, character slot, etc.) and move on.
-   - **Close, but adjustable** → refine the prompt with a specific delta ("wider shot", "warmer light", "remove the second figure"), regenerate **once**.
-   - **Wrong direction** → ask the user before regenerating. Don't burn credits on prompt-thrashing.
-
-## Refinement rules
-
-- **One specific delta per regeneration.** Don't change five things at once — you won't know what helped.
-- **Anchor with references.** If the result drifted from the user's intent, attach the *previous best* generation as a reference image alongside the original brief.
-- **Use `slates_get_asset_image`** to pull a previously-generated image back into context if you need to compare against a fresh generation.
-- **Use `slates_edit_image`** (when available) for surgical tweaks instead of full regeneration when 90% of the image is right.
-
-## Cost discipline
-
-- Track total credits spent across the loop. Surface to the user every 3 iterations.
-- Stop after 3 failed iterations on the same prompt — escalate to the user with what you tried and what's not working. The slot machine never converges.
-- For high-cost generations (`> $0.50`), confirm before *every* attempt, not just the first.
-
-## When to break the loop
-
-- The user said "good enough" or "ship it." Stop iterating.
-- You've burned >5 generations on one frame. Hand back and ask.
-- The user changes brief mid-loop. Treat it as a new brief, not a continuation.
-
-## Voice when narrating to the user
-
-Tight, observational, no editorializing.
-- ✅ "Frame 2 has the wrong lighting direction — back-lit instead of side. Regenerating with side light."
-- ❌ "I notice that the lighting in frame 2 isn't quite what we were going for. I'll go ahead and try again with a different approach."