@editframe/create 0.44.0 → 0.45.0

package/dist/index.js

@@ -1,6 +1,5 @@
 #!/usr/bin/env node
 import { getStartCommand, getUserPkgManager, installAgentSkills, installDependencies } from "./utils.js";
-import { getAgentChoices } from "./detectAgent.js";
 import { access, cp, readdir } from "node:fs/promises";
 import path from "node:path";
 import { fileURLToPath } from "node:url";
@@ -18,7 +17,6 @@ ${chalk.bold("Options:")}
   -d, --directory <name>    Project directory name
   --skip-install           Skip dependency installation
   --skip-skills            Skip agent skills installation
-  --agent <name>           Specify AI agent (cursor, claude, vscode, etc.)
   -y, --yes                Skip all prompts, use defaults
   -h, --help               Show this help message
 
@@ -33,7 +31,7 @@ ${chalk.bold("Examples:")}
   npm create @editframe -- react
 
   ${chalk.dim("# Full non-interactive")}
-  npm create @editframe -- react -d my-app --agent cursor -y
+  npm create @editframe -- react -d my-app -y
 
   ${chalk.dim("# Skip auto-installation")}
   npm create @editframe -- react --skip-install --skip-skills
@@ -71,7 +69,6 @@ async function main() {
 				type: "boolean",
 				default: false
 			},
-			agent: { type: "string" },
 			yes: {
 				type: "boolean",
 				short: "y",
@@ -88,7 +85,6 @@ async function main() {
 	const cliDirectory = values.directory;
 	const skipInstall = values.skipInstall;
 	const skipSkills = values.skipSkills;
-	const cliAgent = values.agent;
 	const nonInteractive = values.yes;
 	if (cliTemplate && !templates.includes(cliTemplate)) {
 		process.stderr.write(chalk.red(`Error: Template "${cliTemplate}" does not exist.\n\n`));
@@ -113,22 +109,12 @@ async function main() {
 			value: template
 		}))
 	});
-	if (!skipSkills && !cliAgent && !nonInteractive) {
-		const agentChoices = await getAgentChoices();
-		promptQuestions.push({
-			type: "confirm",
-			name: "installSkills",
-			message: "Install AI agent skills for better coding assistance?",
-			initial: true
-		});
-		promptQuestions.push({
-			type: (_prev, values$1) => values$1.installSkills ? "select" : null,
-			name: "agent",
-			message: "Which AI coding agent are you using?",
-			choices: agentChoices,
-			initial: 0
-		});
-	}
+	if (!skipSkills && !nonInteractive) promptQuestions.push({
+		type: "confirm",
+		name: "installSkills",
+		message: "Install AI agent skills for better coding assistance?",
+		initial: true
+	});
 	const answers = promptQuestions.length > 0 ? await prompts(promptQuestions) : {};
 	if (!cliDirectory && !nonInteractive && !answers.directoryName || !cliTemplate && !nonInteractive && !answers.templateName) {
 		process.stderr.write(chalk.red("\nCancelled\n"));
@@ -136,8 +122,7 @@ async function main() {
 	}
 	const directoryName = cliDirectory || answers.directoryName || "my-project";
 	const templateName = cliTemplate || answers.templateName || templates[0];
-	let selectedAgent = cliAgent || answers.agent;
-	if (!skipSkills && !selectedAgent && nonInteractive) selectedAgent = "cursor";
+	const installSkills = !skipSkills && (nonInteractive || answers.installSkills !== false);
 	const targetDir = path.join(process.cwd(), directoryName);
 	const templateDir = path.join(__dirname, "templates", templateName);
 	if (await checkDirectoryExists(targetDir)) {
@@ -160,10 +145,10 @@ async function main() {
 	let depsInstalled = false;
 	let skillsInstalled = false;
 	if (!skipInstall) depsInstalled = await installDependencies(targetDir);
-	if (!skipSkills && selectedAgent && selectedAgent !== "skip") skillsInstalled = await installAgentSkills(targetDir, selectedAgent);
+	if (installSkills) skillsInstalled = await installAgentSkills(targetDir);
 	process.stderr.write(chalk.green.bold("\n✓ Project created successfully!\n"));
 	if (depsInstalled) process.stderr.write(chalk.green("✓ Dependencies installed\n"));
-	if (skillsInstalled) process.stderr.write(chalk.green(`✓ Agent skills installed (${selectedAgent})\n`));
+	if (skillsInstalled) process.stderr.write(chalk.green("✓ AI agent skills installed\n"));
 	process.stderr.write(chalk.bold("\nYour project is ready! 🎉\n\n"));
 	process.stderr.write(chalk.bold("Next steps:\n"));
 	process.stderr.write(chalk.cyan(`  cd ${directoryName}\n`));
@@ -171,9 +156,12 @@ async function main() {
 	process.stderr.write(chalk.cyan(`  ${getStartCommand(pkgManager)}\n`));
 	if (skillsInstalled) {
 		process.stderr.write(chalk.bold("\nAI Agent Skills installed:\n"));
-		process.stderr.write(chalk.dim("  • elements-composition - HTML/Web Components\n"));
-		process.stderr.write(chalk.dim("  • react-composition - React components\n"));
-		process.stderr.write(chalk.dim("  • motion-design - Animation principles\n"));
+		process.stderr.write(chalk.dim("  • editframe-composition\n"));
+		process.stderr.write(chalk.dim("  • editframe-motion-design\n"));
+		process.stderr.write(chalk.dim("  • editframe-brand-video-generator\n"));
+		process.stderr.write(chalk.dim("  • editframe-editor-gui\n"));
+		process.stderr.write(chalk.dim("  • editframe-vite-plugin\n"));
+		process.stderr.write(chalk.dim("  • editframe-webhooks\n"));
 		process.stderr.write(chalk.bold("\nTry asking your AI agent:\n"));
 		process.stderr.write(chalk.dim("  \"Create a 5-second video with fade-in text\"\n"));
 		process.stderr.write(chalk.dim("  \"Add a waveform visualization\"\n"));

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":["path","promptQuestions: prompts.PromptObject[]","values"],"sources":["../src/index.ts"],"sourcesContent":["#!/usr/bin/env node\n\nimport { access, cp, readdir } from \"node:fs/promises\";\nimport path from \"node:path\";\nimport { fileURLToPath } from \"node:url\";\nimport { parseArgs } from \"node:util\";\nimport chalk from \"chalk\";\nimport prompts from \"prompts\";\nimport {\n  getUserPkgManager,\n  installDependencies,\n  installAgentSkills,\n  getStartCommand,\n} from \"./utils.js\";\nimport { getAgentChoices } from \"./detectAgent.js\";\n\nfunction showHelp(templates: string[]) {\n  const usage = `\n${chalk.bold(\"Usage:\")}\n  npm create @editframe -- [template] [options]\n\n${chalk.bold(\"Options:\")}\n  -d, --directory <name>    Project directory name\n  --skip-install           Skip dependency installation\n  --skip-skills            Skip agent skills installation\n  --agent <name>           Specify AI agent (cursor, claude, vscode, etc.)\n  -y, --yes                Skip all prompts, use defaults\n  -h, --help               Show this help message\n\n${chalk.bold(\"Available Templates:\")}\n${templates.map((t) => `  - ${t}`).join(\"\\n\")}\n\n${chalk.bold(\"Examples:\")}\n  ${chalk.dim(\"# Interactive mode (recommended)\")}\n  npm create @editframe\n\n  ${chalk.dim(\"# Specify template\")}\n  npm create @editframe -- react\n\n  ${chalk.dim(\"# Full non-interactive\")}\n  npm create @editframe -- react -d my-app --agent cursor -y\n\n  ${chalk.dim(\"# Skip auto-installation\")}\n  npm create @editframe -- react --skip-install --skip-skills\n`;\n\n  process.stdout.write(usage);\n}\n\nasync function checkDirectoryExists(path: string) {\n  try {\n    await access(path);\n    return true;\n  } catch (_error) {\n    return false;\n  }\n}\n\nasync function main() {\n  const __dirname = path.dirname(fileURLToPath(import.meta.url));\n\n  // List of available starter templates\n  const templates = await readdir(path.join(__dirname, \"templates\"));\n\n  // Parse command line arguments\n  const { values, positionals } = parseArgs({\n    args: process.argv.slice(2),\n    options: {\n      help: {\n        type: \"boolean\",\n        short: \"h\",\n        default: false,\n      },\n      directory: {\n        type: \"string\",\n        short: \"d\",\n      },\n      skipInstall: {\n        type: \"boolean\",\n        default: false,\n      },\n      skipSkills: {\n        type: \"boolean\",\n        default: false,\n      },\n      agent: {\n        type: \"string\",\n      },\n      yes: {\n        type: \"boolean\",\n        short: \"y\",\n        default: false,\n      },\n    },\n    allowPositionals: true,\n  });\n\n  // Show help if requested\n  if (values.help) {\n    showHelp(templates);\n    process.exit(0);\n  }\n\n  // Extract CLI arguments\n  const cliTemplate = positionals[0];\n  const cliDirectory = values.directory;\n  const skipInstall = values.skipInstall;\n  const skipSkills = values.skipSkills;\n  const cliAgent = values.agent;\n  const nonInteractive = values.yes;\n\n  // Validate template if provided\n  if (cliTemplate && !templates.includes(cliTemplate)) {\n    process.stderr.write(\n      chalk.red(`Error: Template \"${cliTemplate}\" does not exist.\\n\\n`),\n    );\n    process.stderr.write(chalk.bold(\"Available templates:\\n\"));\n    for (const t of templates) {\n      process.stderr.write(`  - ${t}\\n`);\n    }\n    process.stderr.write(\n      chalk.dim(\"\\nRun with --help for more information.\\n\"),\n    );\n    process.exit(1);\n  }\n\n  // Build prompts array - ask ALL questions upfront before any network calls\n  const promptQuestions: prompts.PromptObject[] = [];\n\n  if (!cliDirectory && !nonInteractive) {\n    promptQuestions.push({\n      type: \"text\",\n      name: \"directoryName\",\n      message: \"Enter the name of the directory to generate into:\",\n      initial: \"my-project\",\n    });\n  }\n\n  if (!cliTemplate && !nonInteractive) {\n    promptQuestions.push({\n      type: \"select\",\n      name: \"templateName\",\n      message: \"Choose a starter template:\",\n      choices: templates.map((template) => ({\n        title: template,\n        value: template,\n      })),\n    });\n  }\n\n  // Ask about agent skills upfront (unless skipped via CLI)\n  if (!skipSkills && !cliAgent && !nonInteractive) {\n    // Get agent choices sorted by detection\n    const agentChoices = await getAgentChoices();\n\n    promptQuestions.push({\n      type: \"confirm\",\n      name: \"installSkills\",\n      message: \"Install AI agent skills for better coding assistance?\",\n      initial: true,\n    });\n\n    promptQuestions.push({\n      type: (_prev, values) => (values.installSkills ? \"select\" : null),\n      name: \"agent\",\n      message: \"Which AI coding agent are you using?\",\n      choices: agentChoices,\n      initial: 0,\n    });\n  }\n\n  // Prompt for all missing information at once\n  const answers =\n    promptQuestions.length > 0 ? await prompts(promptQuestions) : {};\n\n  // Handle user cancellation\n  if (\n    (!cliDirectory && !nonInteractive && !answers.directoryName) ||\n    (!cliTemplate && !nonInteractive && !answers.templateName)\n  ) {\n    process.stderr.write(chalk.red(\"\\nCancelled\\n\"));\n    process.exit(1);\n  }\n\n  // Use CLI args or prompted values (with defaults for non-interactive mode)\n  const directoryName = cliDirectory || answers.directoryName || \"my-project\";\n  const templateName = cliTemplate || answers.templateName || templates[0];\n\n  // Determine agent selection from CLI or prompts\n  let selectedAgent = cliAgent || answers.agent;\n\n  // Default to cursor in non-interactive mode if skills not skipped\n  if (!skipSkills && !selectedAgent && nonInteractive) {\n    selectedAgent = \"cursor\";\n  }\n\n  const targetDir = path.join(process.cwd(), directoryName);\n  const templateDir = path.join(__dirname, \"templates\", templateName);\n\n  const exists = await checkDirectoryExists(targetDir);\n\n  if (exists) {\n    process.stderr.write(\n      chalk.yellow(`Directory ${targetDir} already exists.\\n`),\n    );\n    const { overwrite } = await prompts({\n      type: \"confirm\",\n      name: \"overwrite\",\n      message: \"Directory already exists. Do you want to overwrite it?\",\n      initial: false,\n    });\n\n    if (!overwrite) {\n      process.stderr.write(chalk.red(\"Aborting...\\n\"));\n      process.exit(1);\n    }\n  }\n\n  process.stderr.write(`\\nCreating project in directory: ${targetDir}\\n`);\n  process.stderr.write(`Using template: ${templateName}\\n\\n`);\n\n  // Copy the selected template to the target directory\n  await cp(templateDir, targetDir, { recursive: true });\n\n  const pkgManager = getUserPkgManager();\n  let depsInstalled = false;\n  let skillsInstalled = false;\n\n  // All questions have been asked - now do the work\n\n  // Install dependencies unless skipped\n  if (!skipInstall) {\n    depsInstalled = await installDependencies(targetDir);\n  }\n\n  // Install agent skills if an agent was selected\n  if (!skipSkills && selectedAgent && selectedAgent !== \"skip\") {\n    skillsInstalled = await installAgentSkills(targetDir, selectedAgent);\n  }\n\n  // Success message\n  process.stderr.write(chalk.green.bold(\"\\n✓ Project created successfully!\\n\"));\n\n  if (depsInstalled) {\n    process.stderr.write(chalk.green(\"✓ Dependencies installed\\n\"));\n  }\n\n  if (skillsInstalled) {\n    process.stderr.write(\n      chalk.green(`✓ Agent skills installed (${selectedAgent})\\n`),\n    );\n  }\n\n  process.stderr.write(chalk.bold(\"\\nYour project is ready! 🎉\\n\\n\"));\n\n  // Next steps\n  process.stderr.write(chalk.bold(\"Next steps:\\n\"));\n  process.stderr.write(chalk.cyan(`  cd ${directoryName}\\n`));\n\n  if (!depsInstalled) {\n    process.stderr.write(chalk.cyan(`  ${pkgManager} install\\n`));\n  }\n\n  process.stderr.write(chalk.cyan(`  ${getStartCommand(pkgManager)}\\n`));\n\n  // Skills info\n  if (skillsInstalled) {\n    process.stderr.write(chalk.bold(\"\\nAI Agent Skills installed:\\n\"));\n    process.stderr.write(\n      chalk.dim(\"  • elements-composition - HTML/Web Components\\n\"),\n    );\n    process.stderr.write(\n      chalk.dim(\"  • react-composition - React components\\n\"),\n    );\n    process.stderr.write(\n      chalk.dim(\"  • motion-design - Animation principles\\n\"),\n    );\n\n    process.stderr.write(chalk.bold(\"\\nTry asking your AI agent:\\n\"));\n    process.stderr.write(\n      chalk.dim('  \"Create a 5-second video with fade-in text\"\\n'),\n    );\n    process.stderr.write(chalk.dim('  \"Add a waveform visualization\"\\n'));\n    process.stderr.write(\n      chalk.dim('  \"Animate this element with spring physics\"\\n'),\n    );\n  }\n\n  process.stderr.write(\n    chalk.dim(\"\\nDocumentation: https://editframe.com/docs\\n\"),\n  );\n  process.stderr.write(chalk.dim(\"Happy coding! 🎬\\n\\n\"));\n}\n\nmain();\n"],"mappings":"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"}
+{"version":3,"file":"index.js","names":["path","promptQuestions: prompts.PromptObject[]"],"sources":["../src/index.ts"],"sourcesContent":["#!/usr/bin/env node\n\nimport { access, cp, readdir } from \"node:fs/promises\";\nimport path from \"node:path\";\nimport { fileURLToPath } from \"node:url\";\nimport { parseArgs } from \"node:util\";\nimport chalk from \"chalk\";\nimport prompts from \"prompts\";\nimport {\n  getUserPkgManager,\n  installDependencies,\n  installAgentSkills,\n  getStartCommand,\n} from \"./utils.js\";\n\nfunction showHelp(templates: string[]) {\n  const usage = `\n${chalk.bold(\"Usage:\")}\n  npm create @editframe -- [template] [options]\n\n${chalk.bold(\"Options:\")}\n  -d, --directory <name>    Project directory name\n  --skip-install           Skip dependency installation\n  --skip-skills            Skip agent skills installation\n  -y, --yes                Skip all prompts, use defaults\n  -h, --help               Show this help message\n\n${chalk.bold(\"Available Templates:\")}\n${templates.map((t) => `  - ${t}`).join(\"\\n\")}\n\n${chalk.bold(\"Examples:\")}\n  ${chalk.dim(\"# Interactive mode (recommended)\")}\n  npm create @editframe\n\n  ${chalk.dim(\"# Specify template\")}\n  npm create @editframe -- react\n\n  ${chalk.dim(\"# Full non-interactive\")}\n  npm create @editframe -- react -d my-app -y\n\n  ${chalk.dim(\"# Skip auto-installation\")}\n  npm create @editframe -- react --skip-install --skip-skills\n`;\n\n  process.stdout.write(usage);\n}\n\nasync function checkDirectoryExists(path: string) {\n  try {\n    await access(path);\n    return true;\n  } catch (_error) {\n    return false;\n  }\n}\n\nasync function main() {\n  const __dirname = path.dirname(fileURLToPath(import.meta.url));\n\n  // List of available starter templates\n  const templates = await readdir(path.join(__dirname, \"templates\"));\n\n  // Parse command line arguments\n  const { values, positionals } = parseArgs({\n    args: process.argv.slice(2),\n    options: {\n      help: {\n        type: \"boolean\",\n        short: \"h\",\n        default: false,\n      },\n      directory: {\n        type: \"string\",\n        short: \"d\",\n      },\n      skipInstall: {\n        type: \"boolean\",\n        default: false,\n      },\n      skipSkills: {\n        type: \"boolean\",\n        default: false,\n      },\n      yes: {\n        type: \"boolean\",\n        short: \"y\",\n        default: false,\n      },\n    },\n    allowPositionals: true,\n  });\n\n  // Show help if requested\n  if (values.help) {\n    showHelp(templates);\n    process.exit(0);\n  }\n\n  // Extract CLI arguments\n  const cliTemplate = positionals[0];\n  const cliDirectory = values.directory;\n  const skipInstall = values.skipInstall;\n  const skipSkills = values.skipSkills;\n  const nonInteractive = values.yes;\n\n  // Validate template if provided\n  if (cliTemplate && !templates.includes(cliTemplate)) {\n    process.stderr.write(\n      chalk.red(`Error: Template \"${cliTemplate}\" does not exist.\\n\\n`),\n    );\n    process.stderr.write(chalk.bold(\"Available templates:\\n\"));\n    for (const t of templates) {\n      process.stderr.write(`  - ${t}\\n`);\n    }\n    process.stderr.write(\n      chalk.dim(\"\\nRun with --help for more information.\\n\"),\n    );\n    process.exit(1);\n  }\n\n  // Build prompts array - ask ALL questions upfront before any network calls\n  const promptQuestions: prompts.PromptObject[] = [];\n\n  if (!cliDirectory && !nonInteractive) {\n    promptQuestions.push({\n      type: \"text\",\n      name: \"directoryName\",\n      message: \"Enter the name of the directory to generate into:\",\n      initial: \"my-project\",\n    });\n  }\n\n  if (!cliTemplate && !nonInteractive) {\n    promptQuestions.push({\n      type: \"select\",\n      name: \"templateName\",\n      message: \"Choose a starter template:\",\n      choices: templates.map((template) => ({\n        title: template,\n        value: template,\n      })),\n    });\n  }\n\n  // Ask about agent skills upfront (unless skipped via CLI)\n  if (!skipSkills && !nonInteractive) {\n    promptQuestions.push({\n      type: \"confirm\",\n      name: \"installSkills\",\n      message: \"Install AI agent skills for better coding assistance?\",\n      initial: true,\n    });\n  }\n\n  // Prompt for all missing information at once\n  const answers =\n    promptQuestions.length > 0 ? await prompts(promptQuestions) : {};\n\n  // Handle user cancellation\n  if (\n    (!cliDirectory && !nonInteractive && !answers.directoryName) ||\n    (!cliTemplate && !nonInteractive && !answers.templateName)\n  ) {\n    process.stderr.write(chalk.red(\"\\nCancelled\\n\"));\n    process.exit(1);\n  }\n\n  // Use CLI args or prompted values (with defaults for non-interactive mode)\n  const directoryName = cliDirectory || answers.directoryName || \"my-project\";\n  const templateName = cliTemplate || answers.templateName || templates[0];\n\n  // Determine if skills should be installed\n  const installSkills =\n    !skipSkills && (nonInteractive || answers.installSkills !== false);\n\n  const targetDir = path.join(process.cwd(), directoryName);\n  const templateDir = path.join(__dirname, \"templates\", templateName);\n\n  const exists = await checkDirectoryExists(targetDir);\n\n  if (exists) {\n    process.stderr.write(\n      chalk.yellow(`Directory ${targetDir} already exists.\\n`),\n    );\n    const { overwrite } = await prompts({\n      type: \"confirm\",\n      name: \"overwrite\",\n      message: \"Directory already exists. Do you want to overwrite it?\",\n      initial: false,\n    });\n\n    if (!overwrite) {\n      process.stderr.write(chalk.red(\"Aborting...\\n\"));\n      process.exit(1);\n    }\n  }\n\n  process.stderr.write(`\\nCreating project in directory: ${targetDir}\\n`);\n  process.stderr.write(`Using template: ${templateName}\\n\\n`);\n\n  // Copy the selected template to the target directory\n  await cp(templateDir, targetDir, { recursive: true });\n\n  const pkgManager = getUserPkgManager();\n  let depsInstalled = false;\n  let skillsInstalled = false;\n\n  // All questions have been asked - now do the work\n\n  // Install dependencies unless skipped\n  if (!skipInstall) {\n    depsInstalled = await installDependencies(targetDir);\n  }\n\n  // Install agent skills unless skipped\n  if (installSkills) {\n    skillsInstalled = await installAgentSkills(targetDir);\n  }\n\n  // Success message\n  process.stderr.write(chalk.green.bold(\"\\n✓ Project created successfully!\\n\"));\n\n  if (depsInstalled) {\n    process.stderr.write(chalk.green(\"✓ Dependencies installed\\n\"));\n  }\n\n  if (skillsInstalled) {\n    process.stderr.write(chalk.green(\"✓ AI agent skills installed\\n\"));\n  }\n\n  process.stderr.write(chalk.bold(\"\\nYour project is ready! 🎉\\n\\n\"));\n\n  // Next steps\n  process.stderr.write(chalk.bold(\"Next steps:\\n\"));\n  process.stderr.write(chalk.cyan(`  cd ${directoryName}\\n`));\n\n  if (!depsInstalled) {\n    process.stderr.write(chalk.cyan(`  ${pkgManager} install\\n`));\n  }\n\n  process.stderr.write(chalk.cyan(`  ${getStartCommand(pkgManager)}\\n`));\n\n  // Skills info\n  if (skillsInstalled) {\n    process.stderr.write(chalk.bold(\"\\nAI Agent Skills installed:\\n\"));\n    process.stderr.write(chalk.dim(\"  • editframe-composition\\n\"));\n    process.stderr.write(chalk.dim(\"  • editframe-motion-design\\n\"));\n    process.stderr.write(chalk.dim(\"  • editframe-brand-video-generator\\n\"));\n    process.stderr.write(chalk.dim(\"  • editframe-editor-gui\\n\"));\n    process.stderr.write(chalk.dim(\"  • editframe-vite-plugin\\n\"));\n    process.stderr.write(chalk.dim(\"  • editframe-webhooks\\n\"));\n\n    process.stderr.write(chalk.bold(\"\\nTry asking your AI agent:\\n\"));\n    process.stderr.write(\n      chalk.dim('  \"Create a 5-second video with fade-in text\"\\n'),\n    );\n    process.stderr.write(chalk.dim('  \"Add a waveform visualization\"\\n'));\n    process.stderr.write(\n      chalk.dim('  \"Animate this element with spring physics\"\\n'),\n    );\n  }\n\n  process.stderr.write(\n    chalk.dim(\"\\nDocumentation: https://editframe.com/docs\\n\"),\n  );\n  process.stderr.write(chalk.dim(\"Happy coding! 🎬\\n\\n\"));\n}\n\nmain();\n"],"mappings":"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"}

package/dist/skills/editframe-brand-video-generator/README.md

@@ -0,0 +1,155 @@
+# Brand Video Generator Skill
+
+A comprehensive Agent Skill for generating strategic video composition plans from brand websites.
+
+## What It Does
+
+This skill analyzes a brand's website and generates a complete video production plan including:
+
+1. **Brand Analysis**
+   - Visual identity (colors, typography, design language)
+   - Voice and messaging tone
+   - Content hierarchy and key messages
+
+2. **Creative Strategy**
+   - Video objective and target audience
+   - Core message and emotional arc
+   - Visual treatment recommendations
+
+3. **Scene Planning**
+   - Scene-by-scene breakdown with timing
+   - Visual content specifications
+   - Motion and transition recommendations
+
+4. **Asset Requirements**
+   - Visual assets needed
+   - Motion graphics specifications
+   - Audio recommendations
+
+## How It Works
+
+The skill combines all analysis phases into a single workflow:
+
+```
+Website URL → Analysis → Creative Brief → Scene Plan → Asset List → Implementation Guide
+```
+
+Instead of separate skills for each phase (as originally proposed), this unified approach:
+- Provides complete end-to-end planning in one session
+- Maintains context across all phases
+- Delivers a cohesive, actionable plan
+- Can be refined iteratively
+
+## Reference Library
+
+The skill includes extensive reference materials:
+
+### [color-psychology.md](references/color-psychology.md)
+Emotional associations with colors, color combinations, and how to apply them in video. Includes:
+- Primary and secondary color meanings
+- Color combinations by mood
+- Video-specific color usage
+- Brand personality color mapping
+
+### [typography-personalities.md](references/typography-personalities.md)
+What font choices signal about brand personality and how to use them in video. Includes:
+- Font category personalities (serif, sans-serif, display, monospace)
+- Font pairing principles
+- Video-specific typography guidelines
+- Animation styles by font type
+
+### [video-archetypes.md](references/video-archetypes.md)
+Common video patterns and structures by industry and video type. Includes:
+- Industry-specific patterns (SaaS, e-commerce, B2B, finance, etc.)
+- Video type structures (demo, explainer, launch, testimonial, etc.)
+- Length and pacing guidelines
+- Platform-specific considerations
+
+### [emotional-arcs.md](references/emotional-arcs.md)
+Proven narrative structures that guide viewer emotions. Includes:
+- 10 core emotional arc patterns
+- When to use each arc
+- How to pace emotional progression
+- Matching arcs to brand personality
+
+### [transition-styles.md](references/transition-styles.md)
+Types of transitions, their emotional impact, and when to use them. Includes:
+- 13+ transition types with specifications
+- Duration guidelines
+- Brand personality matching
+- Platform considerations
+
+### [visual-metaphors.md](references/visual-metaphors.md)
+How to represent abstract concepts visually. Includes:
+- 15+ common abstract concepts (speed, security, growth, trust, etc.)
+- Visual metaphor options for each
+- Animation and color recommendations
+- Cultural considerations
+
+### [composition-patterns.md](references/composition-patterns.md)
+Common structural patterns for video composition with Editframe Elements. Includes:
+- 14+ composition patterns with code examples
+- Complete video structure templates
+- Best practices for timing, layering, accessibility
+- Quick reference table
+
+## Usage
+
+Provide the skill with:
+- **URL**: Brand website to analyze
+- **Video Type**: launch, product-demo, explainer, brand-awareness, social
+- **Duration Target**: 15s, 30s, 60s, 90s (optional)
+- **Platform**: web, instagram, tiktok, youtube, linkedin (optional)
+
+The skill will generate a comprehensive plan including all phases.
+
+## Example
+
+See [EXAMPLE.md](EXAMPLE.md) for a complete walkthrough using Stripe.com as the example brand, including:
+- Full brand analysis
+- Creative brief
+- Scene-by-scene breakdown
+- Asset manifest
+- Implementation notes
+- Starter Editframe code
+
+## Integration with Other Skills
+
+This skill works alongside:
+- **elements-composition**: Use to implement the video plan with HTML/Web Components
+- **react-composition**: Use to implement with React components
+- **motion-design**: Apply motion principles to the planned animations
+
+## Workflow
+
+Typical workflow:
+1. Use `brand-video-generator` to analyze website and create plan
+2. Review and refine the plan
+3. Gather or create required assets
+4. Use `elements-composition` or `react-composition` to build the video
+5. Apply `motion-design` principles for animations
+6. Iterate and refine
+
+## Future Enhancements
+
+Potential additions (not yet implemented):
+- Industry-specific analysis patterns
+- Competitive analysis integration
+- Automated asset generation suggestions
+- A/B testing recommendations
+- Multi-language considerations
+- Accessibility scoring
+
+## Philosophy
+
+This skill embodies several key principles:
+
+1. **Strategic First**: Start with strategy before execution
+2. **Brand-Aligned**: Every decision should reflect brand personality
+3. **Audience-Focused**: Consider who's watching and why
+4. **Actionable**: Provide specific, implementable recommendations
+5. **Comprehensive**: Cover all aspects from analysis to implementation
+
+## License
+
+MIT

package/dist/skills/editframe-brand-video-generator/SKILL.md

@@ -0,0 +1,207 @@
+---
+name: editframe-brand-video-generator
+title: Brand Video Generator
+description: Generate video compositions from brand websites or descriptions. Produces an inspectable creative brief before generating HTML.
+status: draft
+order: 50
+license: MIT
+metadata:
+  author: editframe
+  version: "4.0"
+---
+
+# Brand Video Generator
+
+Two-pass pipeline. First produce an inspectable brief. Then generate the composition from it.
+
+---
+
+## Step 0 — Fetch the brand (do this first, before anything else)
+
+**If a URL is supplied**: immediately fetch it with WebFetch or your browser tool — before reading any further instructions, before thinking about the brief, before any other action. Extract exact hex codes from the page's CSS. Download or note 3–5 brand assets (logo, product screenshots, key imagery). Do not proceed until you have done this.
+
+**If you cannot access the URL**: stop here. Report the failure and ask whether to proceed from a text description instead.
+
+**If only a text description is supplied**: ask the user for anything critical that's missing — specific product names, hex codes, recognizable visual marks — before generating the brief.
+
+Do not infer colors or visual language from memory or text descriptions of a site. Only exact values from the live page are acceptable.
+
+---
+
+## Input
+
+- **Brand**: URL or text description
+- **Video Type**: `launch` | `product-demo` | `explainer` | `brand-awareness` | `social`
+- **Duration**: `15s` | `30s` | `60s` | `90s` (optional)
+- **Platform**: `web` | `instagram` | `tiktok` | `youtube` | `linkedin` (optional)
+
+---
+
+## Pass 1 — The Brief
+
+Answer these four questions. Output them as a readable document the developer can inspect, correct, or approve before generation begins.
+
+**Do not skip to HTML. The brief is required output.**
+
+---
+
+### 1. Structural truth
+
+One thing true of this brand that is false of any direct competitor.
+
+Not a marketing claim. A material fact: a decision the brand made, a relationship it has, a mechanism it invented. The truth must be structural — if a well-funded competitor could claim the same thing next year, dig deeper.
+
+**Substitute test**: swap the brand name into the statement. Does it still hold? If yes, it's not specific enough.
+
+Output:
+```
+Structural truth: [one sentence]
+Substitute test: [why this fails for Competitor A and Competitor B]
+```
+
+---
+
+### 2. Formal constraint
+
+What the structural truth forces on the video's *mechanics* — not its subject matter.
+
+Structure means timing, motion logic, and compositional form. If the truth is about removal, scenes must subtract elements. If it's about unification, the same visual element must thread through multiple contexts. If it's about community, real faces must appear.
+
+State it as a rule: "Because [truth], this video [does X mechanically]."
+
+Output:
+```
+Formal constraint: [one rule in motion terms]
+Single argument: "This video argues [X] by showing [Y]."
+```
+
+If [Y] could illustrate a different argument, the form isn't embodying the truth yet — rewrite.
+
+---
+
+### 3. Authorial angle
+
+What the video argues that the brand's own marketing does not say.
+
+Complete: *"This video argues [X] which this brand's marketing never says because [Y]."*
+
+If [X] is already on their homepage, the composition is illustration, not argument. Find the interpretation: what tension does this truth create? What does it reveal about the audience? What norm does it contradict?
+
+**Category truth vs. brand angle:** If the authorial angle could be claimed by any direct competitor in the same category, it's a category truth, not an angle. 'Unification beats fragmentation' is true of ALL payment aggregators. A valid angle must reference something only THIS brand can claim:
+- Their specific customer roster or market position
+- Their specific technical decision that shaped the product's architecture
+- Their specific philosophy made visible in a product choice competitors didn't make
+
+**For payments APIs specifically**: 'Unified API' is category-level. Valid angles include: built unified from day one (vs. acquired-and-integrated competitors), developer-first design philosophy (documentation as product), specific mission statements ('increase GDP of the internet'), or the decision to expose primitives rather than hide complexity. State which architectural philosophy the video will argue.
+
+Rewrite until the angle fails the substitute test.
+
+**Category trap**: "fragmentation is bad, unification is good" is a category-level narrative any competitor can use. "This specific brand's unification works because [architectural reason no competitor has]" is a brand angle. If the argument could be the headline of a competitor's ad campaign, dig deeper.
+
+Output:
+```
+Authorial angle: [one sentence]
+Why the brand wouldn't say this: [one sentence]
+```
+
+---
+
+### 4. Felt arc
+
+The emotional journey from frame 1 to the last frame.
+
+Name the emotion at entry and at exit. They must differ. Then define the minimum path — the fewest distinct state changes required to move between them.
+
+Scene budget: `floor(duration_seconds / 10)` maximum. 15s → 2 scenes. 30s → 3. 60s → 6.
+
+Output:
+```
+Entry state: [what the viewer feels at frame 1]
+Exit state:  [what the viewer feels at the last frame]
+Arc:         [entry] → [intermediate state if needed] → [exit]
+Scene budget: [N scenes maximum]
+```
+
+---
+
+### Brief checkpoint
+
+After outputting the brief, pause and ask:
+
+> "Does this brief look right? I'll generate the composition once you confirm, or adjust any section now."
+
+If the user confirms or says to proceed: move to Pass 2.
+If the user corrects any section: revise that section only, then ask again before generating.
+
+---
+
+## Pass 2 — The Composition
+
+Generate HTML from the confirmed brief. Every decision traces back to the brief's formal constraint.
+
+### The single gate
+
+Before placing any element — scene, visual, canvas animation, line of text — ask:
+
+> **Could a direct competitor's marketing team use this exact element unchanged?**
+
+If yes: delete it and find what only this brand could use. Apply recursively.
+
+### Scene rules
+
+- Each scene earns its place by changing the viewer's emotional state. State the transition for every scene: "viewer enters feeling [X], exits feeling [Y]." Information-only scenes get cut.
+- No two adjacent scenes may leave the viewer in the same state.
+- Feature sequences must build causally — if scenes can be reordered without loss, they're a list, not an argument.
+- Prove, don't assert: "unified" is shown by one element appearing in multiple contexts, not by text saying "unified."
+
+### Hard stops
+
+**Colors**: Use exact hex codes from the brief (extracted from CSS or provided). Do not estimate.
+
+**Canvas**:
+- Use `addFrameTask`, never `requestAnimationFrame`. Callback: `(info) => { const { ownCurrentTimeMs, durationMs } = info; }`
+- A canvas without a complete `addFrameTask` script renders nothing — delete the scene rather than ship broken code
+- If approaching output length, cut canvas scenes or replace with CSS animation; a working 3-scene video beats a broken 4-scene one
+- Canvas visual state at second 1 must differ visibly from second 20
+
+**People**: Circles and gradient blobs cannot represent faces. Use real photography or draw recognizable facial features.
+
+**Logo geometry**: Render from the brand's actual geometry. `fillRect()` for clothing or organic forms is prohibited.
+
+**Named products**: At least one specific product name (not a category description) must appear.
+
+### Completeness check
+
+Before outputting:
+- [ ] Scene durations sum to target duration EXACTLY (e.g., 60s request = 60s total)
+- [ ] No canvas element without a complete `addFrameTask` script
+- [ ] Output ends with `</ef-timegroup>`, `</script>`, `</style>` — verify closing tags are present
+- [ ] Every scene passes the substitutability gate
+- [ ] The single argument is traceable through every scene
+- [ ] **Final scene exists**: Composition must include a closing/CTA scene (typically 4-8s) that resolves the arc
+- [ ] **Duration accounting**: List each scene's duration in a comment before output to verify sum: `<!-- Scene 1: 8s, Scene 2: 12s, Scene 3: 24s, Scene 4: 16s = 60s total -->`
+
+**If approaching output length limits:** Stop adding scenes. A complete 45s video is better than a truncated 60s video. Reduce scene count or simplify canvas animations rather than producing incomplete code.
+
+---
+
+## Reference Files
+
+- [references/brand-examples.md](references/brand-examples.md) — Structural truths, false differentiators, visual specificity by category
+- [references/composition-patterns.md](references/composition-patterns.md) — Canvas patterns, frameTask API, visual specificity requirements
+- [references/genre-selection.md](references/genre-selection.md) — Genre palette and fitness checks
+- [references/emotional-arcs.md](references/emotional-arcs.md) — Arc patterns, short-form compression
+- [references/editing.md](references/editing.md) — What to cut
+- [references/visual-metaphors.md](references/visual-metaphors.md) — Visual metaphor library
+- [references/video-archetypes.md](references/video-archetypes.md) — Industry patterns
+- [references/typography-personalities.md](references/typography-personalities.md) — Font personality and timing
+- [references/video-fundamentals.md](references/video-fundamentals.md) — Transitions, arcs, brand basics
+
+### Factual verification requirement
+
+Every statistic, figure, or quantified claim in the brief MUST be:
+1. Directly sourced from the brand's website, press releases, or official communications
+2. Attributed with specific context (what, where, when)
+3. If no verifiable figure exists, state the structural truth qualitatively rather than fabricating a number
+
+**Do not invent statistics.** When in doubt, quote the brand's own language verbatim rather than paraphrasing into invented specifics. The brand's actual tagline is more verifiable and more powerful than a plausible-sounding invented metric.