Schedule Ads / aeon skill

AI agent that schedules paid ads

Manage paid ads on AdManage.ai from declarative config - default schedules launches across Meta/TikTok/Snapchat/Pinterest/LinkedIn (always PAUSED); create provisions Meta campaigns and ad sets.

CATEGORY ProductivityRUNS Daily at 08:00 UTCUPDATED
Skill
Schedule Ads schedule-ads
Category
Productivity
Default schedule
Daily at 08:00 UTC
cron 0 8 * * *
Last updated

commit 7d3dd68
Source
aeonfun/aeon/skills/schedule-ads/SKILL.md MIT licensed, one prompt file

What it does

Schedule Ads is an aeon skill: Manage paid ads on AdManage.ai from declarative config - default schedules launches across Meta/TikTok/Snapchat/Pinterest/LinkedIn (always PAUSED); create provisions Meta campaigns and ad sets. Like every aeon skill it is one SKILL.md prompt file that runs unattended on your own GitHub Actions, on a schedule or when you trigger it, and sends what it finds to Telegram, Discord, Slack or email.

Reads a declarative config, computes what to do, and makes the AdManage.ai API calls in-run via ./secretcurl. The calls are an irreversible outbound side-effect (real ad spend), so they are each branch's final actions and run only behind the guardrails below (PAUSED-by-default, dailySpendCap circuit-breaker, dry-run). ADMANAGE_API_KEY is injected in-run via this skill's requires: - always write it as the {ADMANAGE_API_KEY} placeholder, never a bare $ADMANAGE_API_KEY (the Bash permission layer refuses that).

Input: the var setting

Every aeon skill takes one optional text input, var, set in aeon.yml or typed in when you run it by hand. It picks the target or the mode for that run.

Selects the flow. Empty/unset = schedule (launch ads into existing ad sets). create = create-campaign (provision Meta campaigns + ad sets). Both are config-driven, PAUSED-by-default, and make the AdManage API calls in-run via ./secretcurl (the {ADMANAGE_API_KEY} placeholder keeps the key off the command line), behind fail-closed spend guardrails.

What it needs

Besides the model you connected to aeon, Schedule Ads uses the following. Add secrets as GitHub Actions secrets on your aeon repo, or in Aeon Connect.

  • ADMANAGE_API_KEY - required secret

Install and run it

Easiest: open Aeon Connect, sign in with GitHub and turn on Schedule Ads. No clone, no terminal. To add it to an existing aeon repo from a shell, run:

bin/add-skill aeonfun/aeon schedule-ads

Then switch it on in aeon.yml (the default schedule is filled in):

skills:
  schedule-ads: { enabled: true, schedule: "0 8 * * *", var: "" }

New to aeon? Read the docs for how skills, schedules and memory fit together, or browse all skills.