evolink-ad-video-generation 1.0.0

package/README.md

@@ -0,0 +1,20 @@
+# Ad Video Generation
+
+Install the Ad Video Generation with Seedance 2 on EvoLink agent skill.
+
+## Install
+
+```bash
+npx evolink-ad-video-generation -y --path ./my-agent-project
+```
+
+The installer writes the skill to `.agents/skills/ad-video-generation/SKILL.md`.
+
+## Agent Use
+
+After installation, use the skill when a user asks for the ad-video-generation EvoLink workflow.
+
+## Links
+
+- GitHub: https://github.com/Evolink-AI/evolink-agent-skills/tree/main/ad-video-generation
+- EvoLink: https://evolink.ai?utm_source=npm&utm_medium=skill&utm_campaign=ad-video-generation

package/README.npm.md

@@ -0,0 +1,20 @@
+# Ad Video Generation
+
+Install the Ad Video Generation with Seedance 2 on EvoLink agent skill.
+
+## Install
+
+```bash
+npx evolink-ad-video-generation -y --path ./my-agent-project
+```
+
+The installer writes the skill to `.agents/skills/ad-video-generation/SKILL.md`.
+
+## Agent Use
+
+After installation, use the skill when a user asks for the ad-video-generation EvoLink workflow.
+
+## Links
+
+- GitHub: https://github.com/Evolink-AI/evolink-agent-skills/tree/main/ad-video-generation
+- EvoLink: https://evolink.ai?utm_source=npm&utm_medium=skill&utm_campaign=ad-video-generation

package/SKILL.md

@@ -0,0 +1,83 @@
+---
+name: ad-video-generation
+displayName: "Ad Video Generation with Seedance 2 on EvoLink"
+description: >
+  Generate short ad videos with Seedance 2 on EvoLink. Use this skill for product ads, launch videos, paid social clips, TikTok or Reels concepts, short marketing videos, and batch creative variants. GPT Image 2 can prepare first frames when needed.
+homepage: "https://evolink.ai?utm_source=skillssh&utm_medium=skill&utm_campaign=ad-video-generation"
+license: MIT
+---
+
+# Ad Video Generation with Seedance 2 on EvoLink
+
+Create short commercial videos from a product, script, image, or campaign idea.
+
+```bash
+npx skills add Evolink-AI/evolink-agent-skills --skill ad-video-generation -g
+```
+
+## When to Use This Skill
+
+Use this skill when the user wants:
+
+- product ad videos
+- TikTok, Reels, or Shorts ads
+- launch campaign videos
+- ecommerce promotion clips
+- short marketing videos
+- multiple video ad variations
+
+Use `product-to-ad` if the user also needs still assets created first.
+
+## Prerequisites
+
+1. EvoLink API access or EvoLink MCP configured.
+2. Product or offer details.
+3. Target platform, aspect ratio, duration, audience, and CTA.
+4. Optional source image or first frame.
+5. Attribution links should use `utm_source=skillssh&utm_medium=skill&utm_campaign=ad-video-generation`.
+
+## Pick the Right Workflow
+
+| User intent | Model path | Why |
+|---|---|---|
+| Text idea to ad video | Seedance 2 text-to-video | Fastest path from campaign idea to video concept. |
+| Product image to ad video | Seedance 2 image-to-video | Strong for commercial clips when a product still exists. |
+| Need a better first frame | GPT Image 2 -> Seedance 2 | Improves video quality by improving the starting image. |
+| Need many variations | Seedance 2 batch prompts | Ads benefit from repeated hook, style, and audience tests. |
+
+## Default Workflow
+
+1. Capture the ad objective, audience, platform, and product promise.
+2. Decide whether the best route is text-to-video, image-to-video, or GPT Image 2 first frame then Seedance 2.
+3. Write a Seedance 2 video prompt with hook, scene, motion, product focus, and CTA direction.
+4. Generate the first ad video.
+5. Suggest batch variants across hook, audience, platform, and visual style.
+
+## Prompting Tips
+
+- Keep the first three seconds clear: product, problem, transformation, or emotional hook.
+- Use one visual concept per clip.
+- Avoid asking the video model to render exact legal or pricing text.
+- Put CTA intent in the prompt, but add exact CTA copy in post-production when needed.
+- For product ads, preserve packaging, logo, and product shape.
+
+## Next Token Loop
+
+After the first ad video, offer:
+
+- three hook variants
+- three platform variants
+- one UGC-style adaptation with `ugc-video-ads`
+- one still image pack with `ad-creative-images`
+
+## Safety and Privacy
+
+Reject or redirect requests for deceptive political ads, fake endorsements, unsafe regulated-product claims, impersonation, or unauthorized use of a person's likeness.
+
+## See Also
+
+- `product-to-ad`
+- `image-to-video`
+- `ugc-video-ads`
+- [EvoLink](https://evolink.ai?utm_source=skillssh&utm_medium=skill&utm_campaign=ad-video-generation)
+

package/bin/cli.js

@@ -0,0 +1,71 @@
+#!/usr/bin/env node
+import fs from "node:fs";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+const packageRoot = path.resolve(__dirname, "..");
+const skill = "ad-video-generation";
+const packageJson = JSON.parse(fs.readFileSync(path.join(packageRoot, "package.json"), "utf8"));
+
+function usage() {
+  console.log(`evolink-ad-video-generation v${packageJson.version}
+
+Install the ${skill} EvoLink agent skill.
+
+Usage:
+  npx evolink-ad-video-generation -y --path ./my-agent-project
+  npx evolink-ad-video-generation --skill
+
+Options:
+  -y, --yes       Accept install prompts.
+  --path <dir>   Install into this project directory. Defaults to cwd.
+  --skill        Print the bundled SKILL.md.
+  --no-open      Accepted for CI compatibility.
+  --version      Print package version.
+  --help         Show this help.
+`);
+}
+
+function parseArgs(argv) {
+  const args = { target: process.cwd(), yes: false, printSkill: false };
+  for (let i = 0; i < argv.length; i += 1) {
+    const arg = argv[i];
+    if (arg === "-y" || arg === "--yes") args.yes = true;
+    else if (arg === "--no-open") continue;
+    else if (arg === "--skill") args.printSkill = true;
+    else if (arg === "--path") {
+      args.target = path.resolve(argv[i + 1] || "");
+      i += 1;
+    } else if (arg === "--version") {
+      console.log(packageJson.version);
+      process.exit(0);
+    } else if (arg === "--help" || arg === "-h") {
+      usage();
+      process.exit(0);
+    } else {
+      console.error(`Unknown argument: ${arg}`);
+      usage();
+      process.exit(2);
+    }
+  }
+  return args;
+}
+
+const args = parseArgs(process.argv.slice(2));
+const skillMarkdown = fs.readFileSync(path.join(packageRoot, "SKILL.md"), "utf8");
+
+if (args.printSkill) {
+  process.stdout.write(skillMarkdown);
+  process.exit(0);
+}
+
+const destination = path.join(args.target, ".agents", "skills", skill);
+fs.mkdirSync(destination, { recursive: true });
+fs.writeFileSync(path.join(destination, "SKILL.md"), skillMarkdown);
+
+console.log(`INSTALLED_SKILL=${skill}`);
+console.log(`INSTALL_PATH=${destination}`);
+console.log("EVOLINK_KEY_URL=https://evolink.ai?utm_source=npm&utm_medium=skill&utm_campaign=" + skill);
+console.log("ENV_VAR_EXPORT=export EVOLINK_API_KEY=<your_evolink_api_key>");
+console.log("AGENT_NEXT_ACTION=Use the installed SKILL.md whenever the user asks for this EvoLink workflow.");

package/package.json

@@ -0,0 +1,39 @@
+{
+  "name": "evolink-ad-video-generation",
+  "version": "1.0.0",
+  "description": "Install the Ad Video Generation with Seedance 2 on EvoLink agent skill.",
+  "type": "module",
+  "license": "MIT",
+  "bin": {
+    "evolink-ad-video-generation": "bin/cli.js"
+  },
+  "files": [
+    "SKILL.md",
+    "bin",
+    "README.md",
+    "README.npm.md"
+  ],
+  "keywords": [
+    "evolink",
+    "agent-skill",
+    "skills",
+    "ai",
+    "ad-video-generation"
+  ],
+  "homepage": "https://github.com/Evolink-AI/evolink-agent-skills/tree/main/ad-video-generation",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Evolink-AI/evolink-agent-skills.git",
+    "directory": "packages/ad-video-generation"
+  },
+  "bugs": {
+    "url": "https://github.com/Evolink-AI/evolink-agent-skills/issues"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "scripts": {
+    "check:node": "node --check bin/cli.js",
+    "smoke:install": "tmp=$(mktemp -d) && node bin/cli.js -y --path \"$tmp\" --no-open && test -f \"$tmp/.agents/skills/ad-video-generation/SKILL.md\""
+  }
+}