This repository provides an external API agent skill pack for Arcads, enabling users to generate AI marketing videos and images within Claude Code or Cursor. It targets media buyers and marketers seeking to automate creative production and integrate advanced AI models like Sora 2 and Veo 3.1 into their workflows, aiming to enhance creative output and scale ad account performance.

How It Works

The system employs an agent that interfaces with the Arcads API, orchestrating prompt engineering, API calls, and file management. It leverages a suite of AI models—including Sora 2 for video, Veo 3.1 for animating stills, Kling 3.0 for B-roll, and Nano Banana 2 for image generation—to produce diverse creative assets. A persistent workspace memory (MASTER_CONTEXT.md) stores project-specific details like brand voice and credit costs, while local reference image directories facilitate consistent asset generation.

Quick Start & Requirements

• Installation: Clone the repository, navigate to the directory, and run ./scripts/setup.sh.
• Prerequisites: An Arcads account with an API key, Claude Code or Cursor IDE, Git, and a Bash environment.
• Setup Time: Estimated at 5 minutes.
• Resources: Requires an Arcads API key for authentication. Usage of AI models incurs credit costs.
• Links: Arcads sign-up: https://arcads.ai/?via=caleb. API key location: https://app.arcads.ai/settings/api.

Highlighted Details

• AI Model Support: Integrates Veo 3.1, Sora 2, Kling 3.0, and Nano Banana 2 for various video and image generation tasks.
• Key Workflows: Automated generation of AI influencers, UGC product selfies, animated video from stills, and direct video ads.
• Workspace Management: Utilizes MASTER_CONTEXT.md for project memory, including brand voice, credit tracking, and API learnings.
• Asset Referencing: Supports local, gitignored storage for influencer, product, and aesthetic reference images.

Maintenance & Community

The project is associated with "The AI Ad Alchemists," a private Skool community of over 460 media buyers, led by Caleb ("Mr. Paid Social"), offering direct access and advanced training.

Licensing & Compatibility

The repository's license is not explicitly stated in the provided README. It is designed for integration with Claude Code and Cursor IDEs, utilizing a .env file for secure API key management.

Limitations & Caveats

Requires a paid Arcads account and API key. The system is primarily tailored for Claude Code or Cursor environments. Usage of advanced AI models incurs credit costs, and the project is actively developed, with some features noted as "shipping next."