evolink-ad-creative-images 1.0.0

package/README.md

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

package/README.npm.md

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

package/SKILL.md

@@ -0,0 +1,81 @@
+---
+name: ad-creative-images
+displayName: "Ad Creative Images with GPT Image 2 on EvoLink"
+description: >
+  Generate paid social ad images, marketing creatives, campaign stills, and visual variants with GPT Image 2 on EvoLink. Use this skill when the user needs static ad assets that can later become Seedance 2 ad videos.
+homepage: "https://evolink.ai?utm_source=skillssh&utm_medium=skill&utm_campaign=ad-creative-images"
+license: MIT
+---
+
+# Ad Creative Images with GPT Image 2 on EvoLink
+
+Create static ad creatives that can be used directly in campaigns or handed off as first frames for Seedance 2 videos.
+
+```bash
+npx skills add Evolink-AI/evolink-agent-skills --skill ad-creative-images -g
+```
+
+## When to Use This Skill
+
+Use this skill when the user wants:
+
+- paid social ad images
+- marketing campaign visuals
+- launch creative concepts
+- product offer images
+- audience-specific image variants
+- first-frame options for video ads
+
+Use `ad-video-generation` when the user already wants motion.
+
+## Prerequisites
+
+1. EvoLink API access or EvoLink MCP configured.
+2. Offer, audience, product, platform, and visual style.
+3. Optional product photo, brand guide, landing page, or existing creative.
+4. Attribution links should use `utm_source=skillssh&utm_medium=skill&utm_campaign=ad-creative-images`.
+
+## Pick the Right Workflow
+
+| User intent | Model path | Why |
+|---|---|---|
+| New ad image from product copy | GPT Image 2 | Creates commercial still concepts quickly. |
+| Variant from existing creative | GPT Image 2 image edit | Changes angle, audience, style, or composition. |
+| First frame for video ad | GPT Image 2 -> Seedance 2 | Turns a static ad concept into a video-ready image. |
+| Multi-platform ad pack | GPT Image 2 variants | Supports different ratios and campaign angles. |
+
+## Default Workflow
+
+1. Extract offer, audience, product proof, platform, and style.
+2. Decide if the task is new generation or edit from an existing creative.
+3. Write a GPT Image 2 prompt for one primary ad creative.
+4. Generate the asset.
+5. Propose three variants and one video handoff.
+
+## Prompting Tips
+
+- Keep the visual idea simple enough to understand while scrolling.
+- Reserve exact text, pricing, and disclaimers for design tools unless the user accepts generated text risk.
+- Use platform context: Meta ad, TikTok cover, Instagram story, YouTube thumbnail, marketplace banner.
+- For video handoff, create a strong subject and clear foreground-background separation.
+
+## Next Token Loop
+
+After the first creative, offer:
+
+- three audience variants
+- three style variants
+- one `image-to-video` handoff
+- one `ad-video-generation` adaptation
+
+## Safety and Privacy
+
+Do not create fake endorsements, fake screenshots, misleading before-after claims, or regulated-product claims not provided by the user.
+
+## See Also
+
+- `image-edit`
+- `product-to-ad`
+- `ad-video-generation`
+- [EvoLink](https://evolink.ai?utm_source=skillssh&utm_medium=skill&utm_campaign=ad-creative-images)
+

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