evolink-image-to-video 1.0.0

package/README.md

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

package/README.npm.md

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

package/SKILL.md

@@ -0,0 +1,81 @@
+---
+name: image-to-video
+displayName: "Image-to-Video with Seedance 2 on EvoLink"
+description: >
+  Turn still images into short videos with Seedance 2 on EvoLink. Use this skill when the user has a product image, character image, poster, ad image, or edited GPT Image 2 asset and wants motion, camera movement, or a short commercial clip.
+homepage: "https://evolink.ai?utm_source=skillssh&utm_medium=skill&utm_campaign=image-to-video"
+license: MIT
+---
+
+# Image-to-Video with Seedance 2 on EvoLink
+
+Animate a still image into a short video. This is the main handoff from GPT Image 2 image assets into Seedance 2 video generation.
+
+```bash
+npx skills add Evolink-AI/evolink-agent-skills --skill image-to-video -g
+```
+
+## When to Use This Skill
+
+Use this skill when the user wants to:
+
+- animate a product image
+- turn an ad image into a short video
+- make a poster, character, or scene move
+- add camera motion to a still visual
+- create a video from a GPT Image 2 output
+- test multiple motion directions from the same source image
+
+Use `product-image-generation` or `image-edit` first if the source image is low quality or not campaign-ready.
+
+## Prerequisites
+
+1. EvoLink API access or EvoLink MCP configured.
+2. One source image URL or local image available to the agent.
+3. Desired duration, aspect ratio, motion style, and output use case.
+4. Attribution links should use `utm_source=skillssh&utm_medium=skill&utm_campaign=image-to-video`.
+
+## Pick the Right Workflow
+
+| User intent | Model path | Why |
+|---|---|---|
+| Product reveal from one image | Seedance 2 image-to-video | Best first video path when the image is already strong. |
+| Ad image to paid social clip | Seedance 2 image-to-video | Turns a static creative into motion for Reels, Shorts, or TikTok. |
+| Weak source image | GPT Image 2 edit -> Seedance 2 | Improve the source frame before spending video tokens. |
+| Need multiple motion tests | Seedance 2 variants | Reuse one image with different camera and action prompts. |
+
+## Default Workflow
+
+1. Inspect the image and identify the subject that must stay stable.
+2. Ask for all missing requirements in one message: duration, platform, aspect ratio, motion, and style.
+3. Write a Seedance 2 prompt focused on motion, camera, scene change, and preservation.
+4. Generate the first clip.
+5. Suggest two iteration directions: motion variant and commercial variant.
+
+## Prompting Tips
+
+- Lead with motion: camera push-in, orbit, product rotation, hand interaction, walk cycle, light sweep.
+- Do not redescribe every visible object. Focus on what changes over time.
+- Preserve identity explicitly: product label unchanged, face stable, packaging shape unchanged.
+- Use one primary action per clip.
+- Keep text overlays out of the generation prompt unless the user accepts text artifacts.
+
+## Next Token Loop
+
+After the first clip, offer:
+
+- three motion variants from the same image
+- one platform adaptation for TikTok, Reels, or Shorts
+- a product ad version with `ad-video-generation`
+
+## Safety and Privacy
+
+Do not animate private people, public figures, or brand assets in misleading contexts without user authorization. Do not produce deceptive political, medical, financial, or impersonation content.
+
+## See Also
+
+- `image-edit`
+- `product-image-generation`
+- `ad-video-generation`
+- [EvoLink](https://evolink.ai?utm_source=skillssh&utm_medium=skill&utm_campaign=image-to-video)
+

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