evolink-ugc-video-ads 1.0.0

package/README.md

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

package/README.npm.md

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

package/SKILL.md

@@ -0,0 +1,81 @@
+---
+name: ugc-video-ads
+displayName: "UGC Video Ads with Seedance 2 on EvoLink"
+description: >
+  Generate UGC-style video ad concepts with Seedance 2 on EvoLink. Use this skill for spokesperson-style hooks, testimonial-style ads, creator-style product demos, social proof concepts, and short-form video variants for TikTok, Reels, and Shorts.
+homepage: "https://evolink.ai?utm_source=skillssh&utm_medium=skill&utm_campaign=ugc-video-ads"
+license: MIT
+---
+
+# UGC Video Ads with Seedance 2 on EvoLink
+
+Create creator-style ad video concepts optimized for hooks, spoken-style storytelling, and repeated variation.
+
+```bash
+npx skills add Evolink-AI/evolink-agent-skills --skill ugc-video-ads -g
+```
+
+## When to Use This Skill
+
+Use this skill when the user wants:
+
+- UGC-style product ads
+- testimonial-style video concepts
+- creator-style hooks
+- TikTok, Reels, or Shorts ad variants
+- spokesperson-style product explanation
+- multiple scripts or hooks for the same product
+
+Use `ad-video-generation` for polished commercial ads and `product-demo-video` for product explanation videos.
+
+## Prerequisites
+
+1. EvoLink API access or EvoLink MCP configured.
+2. Product, audience, offer, platform, tone, and allowed claims.
+3. Optional source image, creator reference style, or script.
+4. Attribution links should use `utm_source=skillssh&utm_medium=skill&utm_campaign=ugc-video-ads`.
+
+## Pick the Right Workflow
+
+| User intent | Model path | Why |
+|---|---|---|
+| Hook-driven UGC ad | Seedance 2 text-to-video | Good for short creator-style concept clips. |
+| Product image plus UGC scene | Seedance 2 image-to-video | Preserves product while adding creator-style motion. |
+| Need a cleaner product shot first | GPT Image 2 -> Seedance 2 | Improves product presence before video generation. |
+| Need many hooks | Seedance 2 variants | UGC performance depends on repeated hook testing. |
+
+## Default Workflow
+
+1. Ask for all missing campaign inputs in one message: product, audience, hook angle, platform, duration, and claim limits.
+2. Create three hook options before generation.
+3. Turn the selected hook into a Seedance 2 prompt with scene, creator energy, motion, and product moment.
+4. Generate the first UGC-style video.
+5. Suggest hook, tone, and audience variants.
+
+## Prompting Tips
+
+- Use one human moment: opening the product, reacting to result, showing a use case, or explaining one pain point.
+- Keep claims grounded in user-provided product facts.
+- Avoid requesting a real celebrity, influencer, or exact private person likeness.
+- Separate exact spoken script from visual prompt if the generation path does not guarantee exact speech.
+
+## Next Token Loop
+
+After the first clip, offer:
+
+- five hook variants
+- three tone variants: skeptical, excited, practical
+- one polished ad version with `ad-video-generation`
+- one still image pack with `ad-creative-images`
+
+## Safety and Privacy
+
+Do not create fake testimonials that imply a real person used the product. Do not impersonate known creators or use unauthorized likenesses. Flag unsupported performance claims before generation.
+
+## See Also
+
+- `ad-video-generation`
+- `product-to-ad`
+- `ad-creative-images`
+- [EvoLink](https://evolink.ai?utm_source=skillssh&utm_medium=skill&utm_campaign=ugc-video-ads)
+

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 = "ugc-video-ads";
+const packageJson = JSON.parse(fs.readFileSync(path.join(packageRoot, "package.json"), "utf8"));
+
+function usage() {
+  console.log(`evolink-ugc-video-ads v${packageJson.version}
+
+Install the ${skill} EvoLink agent skill.
+
+Usage:
+  npx evolink-ugc-video-ads -y --path ./my-agent-project
+  npx evolink-ugc-video-ads --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-ugc-video-ads",
+  "version": "1.0.0",
+  "description": "Install the UGC Video Ads with Seedance 2 on EvoLink agent skill.",
+  "type": "module",
+  "license": "MIT",
+  "bin": {
+    "evolink-ugc-video-ads": "bin/cli.js"
+  },
+  "files": [
+    "SKILL.md",
+    "bin",
+    "README.md",
+    "README.npm.md"
+  ],
+  "keywords": [
+    "evolink",
+    "agent-skill",
+    "skills",
+    "ai",
+    "ugc-video-ads"
+  ],
+  "homepage": "https://github.com/Evolink-AI/evolink-agent-skills/tree/main/ugc-video-ads",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Evolink-AI/evolink-agent-skills.git",
+    "directory": "packages/ugc-video-ads"
+  },
+  "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/ugc-video-ads/SKILL.md\""
+  }
+}