Update to Omneky
Snapshot Oct 27, 2026 · 00:28 UTC · version 2.0.31
Collection source: downloaded plugin package.
Payment or plan references changed
Skill instructions — Now says: this when the user wants to launch, pause, re-budget, retarget or delete paid ads, or connect an ad account. One job: paid-media changes and account...
Observed in published text. Live prices and checkout terms have not been verified by this change.
Up to 3 plugins free · no card required.
All fields and original values.
Skill instructions
Oct 24, 2026 · 13:12 UTC
the connected Omneky MCP server. Gate on this session's `tools/list`. Default new launches to `PAUSED`. The X Ads channel value is `twitter`; the OpenAI Ads channel value is `openai`. If launch tools aren't available on this session's `t...
Oct 27, 2026 · 00:28 UTC
this when the user wants to launch, pause, re-budget, retarget or delete paid ads, or connect an ad account. One job: paid-media changes and account connection. Live vs paused is the host's call from the user's request. Gate on `tools/li...
Supporting files
Oct 24, 2026 · 13:12 UTC
[{"relative_path":"references/facebook.md","size_in_bytes":685},{"relative_path":"references/google.md","size_in_bytes":1061},{"relative_path":"references/linkedin.md","size_in_bytes":840},{"relative_path":"references/openai.md","size_in...
Oct 27, 2026 · 00:28 UTC
[{"relative_path":"references/facebook.md","size_in_bytes":759},{"relative_path":"references/google.md","size_in_bytes":1147},{"relative_path":"references/linkedin.md","size_in_bytes":963},{"relative_path":"references/managed.md","size_i...
Compare saved observations
Download comparison JSONSKILL.md text changes
− removed · + added
--- before +++ after @@ -20,56 +20,58 @@ # Launch paid ads and connect accounts -Use the connected Omneky MCP server. Gate on this session's -`tools/list`. Default new launches to `PAUSED`. -The X Ads channel value is `twitter`; the OpenAI Ads channel value is -`openai`. - -If launch tools aren't available on this session's `tools/list`, -say so and point the user to the Omneky app. Do not invent them. - -Handoff fields: -[handoff-contract](../_shared/references/handoff-contract.md). -Sourced ids (how to obtain / what to do if absent): -[preconditions](../_shared/references/preconditions.md). +Use this when the user wants to launch, pause, re-budget, retarget or +delete paid ads, or connect an ad account. One job: paid-media +changes and account connection. Live vs paused is the host's call from the user's request. + +Gate on `tools/list`; a missing launch tool → the Omneky app. X Ads +is channel `twitter`; OpenAI Ads is `openai`. +Step detail: [playbook](references/playbook.md) (channel table, launch +path, preflight, targeting, manage, connect, launch checks). + +Handoff fields: [handoff-contract](../_shared/references/handoff-contract.md). +Sourced ids (how to obtain / what to do if absent): [preconditions](../_shared/references/preconditions.md). <!-- host:begin name="scan-tools-routing" --> -Acceptance gates: -[creative-quality-gates](../_shared/references/creative-quality-gates.md). -Other intents: -[capability-registry](../_shared/references/capability-registry.md). -Write for: -[marketer-persona](../_shared/references/marketer-persona.md). +Acceptance gates: [creative-quality-gates](../_shared/references/creative-quality-gates.md). +Other intents: [capability-registry](../_shared/references/capability-registry.md). +Write for: [marketer-persona](../_shared/references/marketer-persona.md). <!-- host:end --> ## Goal -Launch or mutate paid media after one explicit yes. Default `PAUSED`. Apply budget, pause waste, and retarget only on approval. +Launch or mutate paid media the user asked for. Set `campaign_spec.status_on_launch` from what the user asked (no server default). Launches, deletes, budget, status and targeting changes are marked destructive, so the host confirms them; do not add your own approval step. ## Prerequisites | Need | Check | If missing | |---|---|---| | Brand | `list_brands` | Ask which | -| Channel | `get_channel_connection_status` | `get_channel_connect_url` → `list_authorized_ad_accounts` → `link_ad_channel_account` when listed. If `link_ad_channel_account` is not on `tools/list`, say that capability isn't available on this connector. Do not invent a link. | -| Budget floor | `minimum_budget_for_objective` | Do not launch under the floor | -| Audience size | `reach_estimate` | Optional; estimate only | -| Targeting tokens | `search_ad_targeting` / `get_tiktok_location_ids` / `search_google_countries` | Required on LinkedIn / TikTok / Demand Gen | +| Channel | `list_connections` (`connector`) | `get_connect_link` → `list_ad_accounts` → `link_ad_account` when listed. If `link_ad_account` is not on `tools/list`, say that capability isn't available on this connector. Do not invent a link. Or managed launch | +| Budget floor | `get_launch_requirements` | Do not launch under the floor | +| Audience size | `estimate_reach` | Optional; estimate only | +| Targeting tokens | `search_targeting` (`channel`, `query`) / `search_targeting` (`channel="tiktok"`, `objective`) / `search_targeting` (`channel="google"`) | Required on LinkedIn / TikTok / Demand Gen | <!-- host:begin name="launch-creative-url-row" --> | Creative URL | any finished HTTPS asset URL (prior generate or user-supplied) | No URL at all → Owning creative skill first | <!-- host:end --> -| Credits | `quote_creative_credits` when an exact price helps | Shortfall → add credits in the Omneky app | +| Credits | `get_account` | `omneky-billing` | ## Flow -One summary (channel, daily spend, audience, asset, `PAUSED`) then wait for a yes. After: what launched, status, spend at risk, confidence. Do not list tool names in that summary. - -Require `approved_claims` from the prior handoff or the user (each -claim with its source). Require `source_evidence` only for -performance-informed or plan-driven launches. User-directed -launches do not need it. Accept a finished asset whose -`quality_result` records `accepted_exceptions`. Do not invent a -claim or a missing asset URL. Show the user a concise -plain-language summary, not the raw handoff. +1. Pick the channel and the exact `launch_*` tool from the playbook + table, then read only that channel's reference. +2. Self-managed: confirm the account is connected; if not, run + Connect and stop. Managed (no account): skip Connect. +3. Check the budget floor and run the channel's targeting pre-call + (TikTok locations, LinkedIn locations, Demand Gen countries). +4. Fill copy, CTA, landing URL and the finished asset URL from the + conversation; ask only for what you cannot infer. Use + `approved_claims` from the handoff; never invent a claim or URL. +5. Show one summary (channel, spend, audience, asset, status) and + call the tool. Launches, deletes, budget, status and targeting + changes are marked destructive, so the host confirms them; do not + add your own approval step. +6. Read back with one get_* call and report what launched, status, + and spend at risk. ## When to use @@ -79,7 +81,7 @@ ## When not to use -- First-run setup / first ad today → `omneky-onboarding` +- First-run setup / first ad today / run it for me → `omneky-onboarding` - Cross-brand / all clients → `omneky-agency` - ROAS, winning ads, or catalogue import (analytics skill) - Weekly marketing plan create / revise / poll / approve @@ -87,303 +89,25 @@ - Branded image ads or product video ads (`omneky-image-ads` / `omneky-product-video`) <!-- host:end --> -- Plan, credit history, or card on file (`omneky-billing`) - -## Channel rules - -Read **only** the reference for the channel you are launching. Do not -load the other eight. Channel budgets, required fields, and targeting -live there — not in this file. - -| Channel | Read | Tools | -|---|---|---| -| Meta / Facebook | [references/facebook.md](references/facebook.md) | `launch_facebook_sales_ad`, `launch_facebook_leads_ad`, `launch_facebook_awareness_ad`, `launch_facebook_traffic_ad`, `launch_facebook_video_views_ad` | -| Google | [references/google.md](references/google.md) | `launch_google_performance_max_ad`, `launch_google_demand_gen_ad` | -| LinkedIn | [references/linkedin.md](references/linkedin.md) | `launch_linkedin_brand_awareness_ad`, `launch_linkedin_website_visits_ad`, `launch_linkedin_conversions_ad`, `launch_linkedin_engagement_ad` | -| Reddit | [references/reddit.md](references/reddit.md) | `launch_reddit_awareness_ad`, `launch_reddit_traffic_ad`, `launch_reddit_conversions_ad`, `launch_reddit_leads_ad`, `launch_reddit_video_views_ad` | -| TikTok | [references/tiktok.md](references/tiktok.md) | `launch_tiktok_traffic_ad`, `launch_tiktok_leads_ad`, `launch_tiktok_video_views_ad`, `launch_tiktok_conversions_ad` | -| X Ads | [references/twitter.md](references/twitter.md) | `launch_twitter_awareness_ad`, `launch_twitter_traffic_ad`, `launch_twitter_engagements_ad`, `launch_twitter_followers_ad`, `launch_twitter_video_views_ad` | -| Pinterest | [references/pinterest.md](references/pinterest.md) | `launch_pinterest_awareness_ad`, `launch_pinterest_traffic_ad`, `launch_pinterest_sales_ad`, `launch_pinterest_leads_ad`, `launch_pinterest_video_views_ad` | -| OpenAI Ads | [references/openai.md](references/openai.md) | `launch_openai_clicks_ad`, `launch_openai_impressions_ad` (`openai_location_search` optional; details in that file) | - -Every allowlisted `launch_*` tool is named above. Do not call a -wildcard or an unlisted sibling. - -## Launch path - -Pick one branch before any `launch_*` call. - -**paused-campaign-from-winners.** Incoming handoff from analytics + -creative must include accepted `asset_url`s, `source_evidence`, and -`source_ad_ids`. Default `PAUSED`. One summary, one yes. Do not go -live unless they say so in that yes. - -An A/B test with a recorded plan (hypothesis, metric, duration, -stop rule) is `omneky-ab-tests`. A budget-reallocation -**recommendation** is `omneky-analytics-and-catalogue`. Applying -`set_ad_budget` after that recommendation still needs one yes -here. - -**waste-pruner (apply).** Incoming pause list from analytics. -One summary naming each entity. `set_ad_entity_status` only -after that yes. - -**audience-targeting-apply.** Incoming tokens from -`search_ad_targeting`. `update_ad_targeting` only after a yes. - -**target-cpa-budget-apply.** Incoming floor from -`minimum_budget_for_objective` / `reach_estimate`. `set_ad_budget` -only after a yes, at or above the floor. - -### Self-managed launch - -Every `launch_*` in the table. Full Preflight below. Disconnected → -Connect, do not launch. - -## Preflight (self-managed) - -Work through this checklist with tool calls before a self-managed -`launch_*` call. Reuse answers the user already gave; ask only for -what is still missing (usually copy, landing URL, budget, and -audience). Then show **one** launch summary — channel, tool, account, -campaign / ad set (new or existing), budget, audience, copy, CTA, -landing URL, creative, and status — and get one yes. Do not ask for -a separate confirmation per item. Do not call `launch_*` until that -yes. Budget, dates, and status in the call must equal the approval; -if any differ, stop and re-summarize. - -Status: set `campaign_spec.status_on_launch` to `"PAUSED"` on -`launch_*` tools. A non-paused launch needs an explicit yes to - -Hierarchy is Campaign → Ad Set (`ad_group`) → Ad. The creative is an -asset on the Ad (`ad_specs`), never on the campaign. - -1. **Objective.** Name the channel and the exact `launch_*` tool from - the table. Read that channel's reference. Do not guess a sibling - objective. -2. **Connected account (self-managed only).** - `get_channel_connection_status` (X Ads: `channel="twitter"`). - Pinterest also: `get_pinterest_connection_status`. Disconnected → - Connect below. Do not launch. -3. **Budget.** `minimum_budget_for_objective` with `brand_id`, channel, - and objective. Do not set a daily or lifetime budget under that - floor. `get_channel_budget` is allocated daily budget, not spend, - not the floor, and not historical ROAS. A disconnected channel is a - per-channel error, not an empty total. -4. **Targeting.** The channel pre-call in that reference. Do not launch - LinkedIn or TikTok without it (the API returns 400). -5. **Copy, CTA, and landing URL.** Use what the user gave. Do not - invent a destination. Meta leads also need `lead_gen_form_id` on - the ad spec. -6. **Existing campaign or ad set.** `get_campaigns`, then - `get_ad_groups` with `campaign_id` (unscoped lists can timeout). - Add under an existing campaign: `campaign_spec={"id": "<campaign_id>"}`. - Add into an existing ad set: `ad_group_spec={"id": "<ad_set_id>"}` - and set `adset_id` on each ad spec. -7. **Audience size.** `reach_estimate` with `brand_id`, `channel`, and - `targeting_fragments` when the user asks how large the audience is. - That is an estimate, not live delivery or ROAS. -8. **Custom conversions.** `get_ad_custom_properties` when the launch needs - a brand conversion event. Not a performance report. -9. **Credits.** Launch creates need available Omneky credits; the - server checks this. `credit_insufficient` means the launch did - **not** start. Do not retry it. Tell the user the shortfall; credits - are added in the Omneky app. Never collect a PAN. Never invent a - credit purchase tool. - -## Targeting pre-calls - -Meta and Reddit take inline targeting (see those references). X Ads -uses `channel="twitter"`. Pinterest checks -`get_pinterest_connection_status` and uses inline countries. The three -lookups below are required before launch. - -**TikTok.** Before any `launch_tiktok_*`: `get_tiktok_location_ids` -with `brand_id` and required `campaign_objective`. Put the returned -ids on the ad group as `location_ids`. Without them the API returns -400. Details: [references/tiktok.md](references/tiktok.md). - -**LinkedIn.** Before any `launch_linkedin_*`: `search_ad_targeting` -with `brand_id`, `channel="linkedin"`, `types=["locations"]`. Copy a -hit whose value includes `urn:li:adTargetingFacet:locations` into -`targeting_criteria`. A new campaign group also needs `start_date`. -Details: [references/linkedin.md](references/linkedin.md). - -**Google Demand Gen vs PMax.** Demand Gen is one image or video on -YouTube or Discover — `search_google_countries`, then -`targeting_fragments`. PMax is the full multi-placement asset suite -(no country lookup). Details: [references/google.md](references/google.md). - -`register_creative_for_launch` is optional (Ad Central library). Pass -`asset_url` or `preview_storage_key` as the finished HTTPS URL -(`presigned_url` / `assets.url`); the server copies it. Launch itself -takes `ad_specs[].media_url`. Use `search_ad_targeting` for LinkedIn / -optional X Ads location lookup. - -## Creative → launch (short) - -<!-- host:begin name="launch-generation-stays" --> -Generation stays in the matching creative skill (`omneky-image-ads`, -`omneky-product-video`, or `omneky-edit-and-resize`). This -skill starts once the user -has a finished Omneky ad and wants it on a paid-media channel. -<!-- host:end --> - -1. The launch summary covers the creative URL too; one yes is enough. -2. Put the finished HTTPS URL (`presigned_url` / `resized_ad_url` / - `assets.url`) on `ad_specs[].media_url` with `media_type`. Published - copy fields (`headline`, `primary_text`, `cta`, `landing_url`) are - mapped to the launcher names. Google Performance Max: `ad_specs: []` - and put images / `link_url` / headlines (≥3) / descriptions (≥2) on - `ad_group_spec`. Square and logo images are required and must not - reuse the landscape ad image. - `register_creative_for_launch` is optional (library). Pass - `asset_url` or `preview_storage_key` as that same HTTPS URL if the - user wants it saved. Do not stop for a missing storage key. -3. Run the matching Preflight, - then the matching `launch_*` from the table. Keep the launch - `PAUSED` unless the user explicitly says to go live. Then run - Launch checks. - -## Manage (short) - -`get_campaigns` (each row is name with campaign id) / -`get_ad_groups` (pass `campaign_id`) / `get_ads`. A disconnected or -skipped channel returns an explicit error, not an empty-looking list. -`set_ad_entity_status` (pause or resume), `set_ad_budget`, -`update_ad_targeting`, `set_pinterest_entity_status`. - -Before any of those mutate tools, show one summary and wait for an -explicit yes. The summary names the entity (name and id), the -channel, the current value, the new value, and that the change -affects live spend. One yes covers the batch; do not confirm each -item separately. - -Name the user said, ids only: `get_campaign_ad_group_names`. Not a -status or budget list. - -Pinterest lists: `get_pinterest_campaigns`, `get_pinterest_ad_groups` -(pass `campaign_id`), `get_pinterest_ads`. Pause or resume with -`set_pinterest_entity_status` (same one-summary / one-yes rule). - -`needs_user_decision` → hand off to -`omneky-getting-started-and-failures` (`request_user_decision`). Do not dump raw -JSON. - -**Deletes.** `delete_campaign`, `delete_ad_group`, and `delete_ads` -are irreversible. Prefer pause (`set_ad_entity_status`) when the user -only wants a stop. - -1. Resolve ids first: `get_campaigns`, `get_ad_groups` (pass - `campaign_id`), `get_ads`. Do not delete from a name alone. -2. In chat, name exactly what will be removed: channel, entity type, - name, and id. Say it cannot be undone. -3. Wait for an explicit yes that repeats that entity (for example - "yes, delete campaign 123"). A vague "ok", or a yes to a different - question, is not confirmation. Do not call the delete until that - yes. If they say no, stop. -4. Then call one tool: - - `delete_campaign` — `brand_id`, `channel`, `campaign_id` - - `delete_ad_group` — `brand_id`, `channel`, `ad_group_id` - - `delete_ads` — `brand_id`, `channel`, `ad_ids` (list of ids) - -## Connect (short) - -Paid-media self-connect for the chosen brand. OAuth wire values: -`facebook`, `google`, `linkedin`, `tiktok`, `reddit`, `twitter`, -`pinterest`. X Ads is `twitter`, never `x`. OAuth channels never need a -token or password in chat — do not ask for one. - -Call `link_ad_channel_account` only when it appears on this -session's `tools/list`. If it is not listed, say that capability -isn't available on this connector. Do not invent a link. - -1. `get_channel_connect_url` with `channel` and `brand_id`. Omit - `redirect_url` unless its host is `omneky.com`. Hand the user - `connect_url` (or `browser_connect_url`). `next_action` is - `open_connect_url`. They finish the provider consent screen. -2. **OAuth not finished.** If they have not completed consent, or - `list_authorized_ad_accounts` is empty or errors, do not link and - do not launch. Send the same URL again. Do not collect a token. -3. After they confirm consent: `list_authorized_ad_accounts` with - `brand_id` and `channel`. Several accounts: ask which `id` / name. - Do not pick silently. -4. Meta / Facebook pages: also `list_authorized_facebook_pages` with - `brand_id`. When `link_ad_channel_account` is on `tools/list`, it - needs `facebook_page_id` plus `channel_account_id` and - `channel_account_name`. If `link_ad_channel_account` is not on - `tools/list`, say that capability isn't available on this - connector. Do not invent a link. -5. Other channels: when `link_ad_channel_account` is on `tools/list`, - call it with `brand_id`, `channel`, `channel_account_id`, and - `channel_account_name`. If it is not listed, say that capability - isn't available on this connector. Do not invent a link. -6. Confirm with `list_connector_statuses` and - `get_channel_connection_status`. Still disconnected: stop and say - so. Do not launch. - -**OpenAI Ads** has no OAuth URL. Status: -`get_openai_ads_connection_status` (or `get_channel_connection_status` -with `channel="openai"`). There is no OpenAI Ads connect tool on this -listing: the user connects it in the Omneky app. Launching on OpenAI -Ads is supported for connected accounts: -`launch_openai_clicks_ad` / `launch_openai_impressions_ad` (see -[references/openai.md](references/openai.md)). - -**PostHog:** connect it in the Omneky app; then -`get_posthog_connection_status` (host and project id, never the key). -`disconnect_posthog` only after an explicit yes. Drive: -`get_google_drive_connection_status`, then -`get_google_drive_connect_url` if it is disconnected. -`disconnect_google_drive` only after an explicit yes. No Pinterest or -X Ads disconnect tool on this surface. - -X Ads pause is `set_ad_entity_status` at **campaign** level only. -Pinterest launches are supported (`launch_pinterest_*`). - -Connected OpenAI Ads launches use `launch_openai_*`. OpenAI targeting -stays on `campaign_spec.targeting`. A disconnected account must be -connected first. Connecting an account is a separate step -from launching. - -## Launch checks - -Observe the launch reply or one cheap get_* read-back. Request -arguments never prove saved campaign configuration. - -Reply or read-back already shows the fact → say it plainly (e.g. -"done"). Do not hedge. Missing detail → **one** get_* call. If it -is still not confirmed, say so in one short plain sentence (e.g. -"I couldn't confirm the saved budget"). - -- Campaign / ad-set / ad ids — launch reply, then `get_campaigns` / - `get_ad_groups` / `get_ads` (Pinterest: `get_pinterest_*`) -- Status equals the approval (`PAUSED` unless they said go live) — - same reply or a get_* read-back, not request `status_on_launch` -- Budget and dates — created entity via get_*. Request args never - prove the save -- Channel and `launch_*` tool — the tool that ran plus the entity's - channel field -- Creative URL and copy on the created ad — `get_ads` (or - launch-reply ad fields). Request `ad_specs` never prove the save - -If a check fails: say which field differed. Do not claim live or -paused as requested. Do not silently relaunch. +- Credit balance or plan upgrade (`omneky-billing`) ## Failure and recovery Auth / 401 → `omneky-getting-started-and-failures` (host OAuth). -Empty reporting → empty is missing data, not zero; narrow the window. -`credit_insufficient` → nothing charged; the user can add credits in the Omneky app. -`needs_user_decision` → `request_user_decision`; never dump JSON. -Missing tool → say so; Omneky app. Do not invent it. +Empty reporting → `get_performance_summary` (`include_coverage=true`); empty is not zero. +`credit_insufficient` → nothing charged; state balance vs required +(`omneky-billing`). No payment links. +`needs_user_decision` → fill the missing detail and call again; ask in plain chat only if you cannot. Never dump JSON. +Missing tool → this session may run an older published app snapshot: look +the name up in [tool-name-fallbacks](../_shared/references/tool-name-fallbacks.md) +and call the older name if that one is on `tools/list`. If neither is +listed, say so; Omneky app. Do not invent it. Never ask for internal ids. Never silent-switch `brand_id`. <!-- host:begin name="capability-gaps-link" --> ## Gaps -This connector cannot do comment/social inbox, landing pages, -subtitle burn-in, email/SMS, organic scheduling, Meta Ad Library -competitor ads, virtual try-on, or website builder. Decline those. -See [capability-gaps](../_shared/references/capability-gaps.md). +Decline social inbox, landing pages, subtitle burn-in, email/SMS, +organic scheduling, Ad Library ads, try-on, and website builder +([capability-gaps](../_shared/references/capability-gaps.md)). <!-- host:end -->
Full technical diff · 2 changed fields
changed /included_files
[
{
"relative_path": "references/facebook.md",
"size_in_bytes": 685
},
{
"relative_path": "references/google.md",
"size_in_bytes": 1061
},
{
"relative_path": "references/linkedin.md",
"size_in_bytes": 840
},
{
"relative_path": "references/openai.md",
"size_in_bytes": 994
},
{
"relative_path": "references/pinterest.md",
"size_in_bytes": 886
},
{
"relative_path": "references/reddit.md",
"size_in_bytes": 664
},
{
"relative_path": "references/tiktok.md",
"size_in_bytes": 805
},
{
"relative_path": "references/twitter.md",
"size_in_bytes": 742
}
][
{
"relative_path": "references/facebook.md",
"size_in_bytes": 759
},
{
"relative_path": "references/google.md",
"size_in_bytes": 1147
},
{
"relative_path": "references/linkedin.md",
"size_in_bytes": 963
},
{
"relative_path": "references/managed.md",
"size_in_bytes": 1091
},
{
"relative_path": "references/openai.md",
"size_in_bytes": 1098
},
{
"relative_path": "references/pinterest.md",
"size_in_bytes": 1165
},
{
"relative_path": "references/playbook.md",
"size_in_bytes": 16092
},
{
"relative_path": "references/reddit.md",
"size_in_bytes": 784
},
{
"relative_path": "references/tiktok.md",
"size_in_bytes": 912
},
{
"relative_path": "references/twitter.md",
"size_in_bytes": 843
}
]changed /skill_md_contents
"---\nname: omneky-launch-and-connect\ndescription: >-\n Launch Omneky paid-media campaigns and connect missing ad\n accounts (Meta/Facebook, Google, TikTok, LinkedIn, Reddit,\n Pinterest, X/Twitter, OpenAI Ads). Use to launch, publish,\n pause/budget/retarget, or connect an ads account. Do\n not use for first-run onboarding (omneky-onboarding), agency\n cross-brand (omneky-agency), ROAS analytics or catalogue\n (omneky-analytics-and-catalogue), competitor analysis\n (omneky-competitor-analysis), A/B tests (omneky-ab-tests),\n weekly marketing plans (omneky-marketing-plan), AI creative\n generation, or credit balance (omneky-billing).\n Keywords: launch Meta sales ads, launch campaign, Meta ads,\n Facebook ads, Google PMax, TikTok ads, LinkedIn ads, connect\n ads, pause ad, budget, targeting, twitter, paused, preflight,\n waste pruner pause, update ad targeting, apply target CPA\n budget, Demand Gen, TikTok locations, Pinterest campaigns.\n---\n\n# Launch paid ads and connect accounts\n\nUse the connected Omneky MCP server. Gate on this session's\n`tools/list`. Default new launches to `PAUSED`.\nThe X Ads channel value is `twitter`; the OpenAI Ads channel value is\n`openai`.\n\nIf launch tools aren't available on this session's `tools/list`,\nsay so and point the user to the Omneky app. Do not invent them.\n\nHandoff fields:\n[handoff-contract](../_shared/references/handoff-contract.md).\nSourced ids (how to obtain / what to do if absent):\n[preconditions](../_shared/references/preconditions.md).\n<!-- host:begin name=\"scan-tools-routing\" -->\nAcceptance gates:\n[creative-quality-gates](../_shared/references/creative-quality-gates.md).\nOther intents:\n[capability-registry](../_shared/references/capability-registry.md).\nWrite for:\n[marketer-persona](../_shared/references/marketer-persona.md).\n<!-- host:end -->\n\n## Goal\n\nLaunch or mutate paid media after one explicit yes. Default `PAUSED`. Apply budget, pause waste, and retarget only on approval.\n\n## Prerequisites\n\n| Need | Check | If missing |\n|---|---|---|\n| Brand | `list_brands` | Ask which |\n| Channel | `get_channel_connection_status` | `get_channel_connect_url` → `list_authorized_ad_accounts` → `link_ad_channel_account` when listed. If `link_ad_channel_account` is not on `tools/list`, say that capability isn't available on this connector. Do not invent a link. |\n| Budget floor | `minimum_budget_for_objective` | Do not launch under the floor |\n| Audience size | `reach_estimate` | Optional; estimate only |\n| Targeting tokens | `search_ad_targeting` / `get_tiktok_location_ids` / `search_google_countries` | Required on LinkedIn / TikTok / Demand Gen |\n<!-- host:begin name=\"launch-creative-url-row\" -->\n| Creative URL | any finished HTTPS asset URL (prior generate or user-supplied) | No URL at all → Owning creative skill first |\n<!-- host:end -->\n| Credits | `quote_creative_credits` when an exact price helps | Shortfall → add credits in the Omneky app |\n\n## Flow\n\nOne summary (channel, daily spend, audience, asset, `PAUSED`) then wait for a yes. After: what launched, status, spend at risk, confidence. Do not list tool names in that summary.\n\nRequire `approved_claims` from the prior handoff or the user (each\nclaim with its source). Require `source_evidence` only for\nperformance-informed or plan-driven launches. User-directed\nlaunches do not need it. Accept a finished asset whose\n`quality_result` records `accepted_exceptions`. Do not invent a\nclaim or a missing asset URL. Show the user a concise\nplain-language summary, not the raw handoff.\n\n## When to use\n\n- Launch a campaign, publish an ad, pause, budget, or retarget\n- Connect a disconnected Meta, Google, TikTok, LinkedIn, Reddit,\n Pinterest, X Ads, or OpenAI Ads account\n\n## When not to use\n\n- First-run setup / first ad today → `omneky-onboarding`\n- Cross-brand / all clients → `omneky-agency`\n- ROAS, winning ads, or catalogue import (analytics skill)\n- Weekly marketing plan create / revise / poll / approve\n<!-- host:begin name=\"launch-when-not-creative\" -->\n- Branded image ads or product video ads (`omneky-image-ads` /\n `omneky-product-video`)\n<!-- host:end -->\n- Plan, credit history, or card on file (`omneky-billing`)\n\n## Channel rules\n\nRead **only** the reference for the channel you are launching. Do not\nload the other eight. Channel budgets, required fields, and targeting\nlive there — not in this file.\n\n| Channel | Read | Tools |\n|---|---|---|\n| Meta / Facebook | [references/facebook.md](references/facebook.md) | `launch_facebook_sales_ad`, `launch_facebook_leads_ad`, `launch_facebook_awareness_ad`, `launch_facebook_traffic_ad`, `launch_facebook_video_views_ad` |\n| Google | [references/google.md](references/google.md) | `launch_google_performance_max_ad`, `launch_google_demand_gen_ad` |\n| LinkedIn | [references/linkedin.md](references/linkedin.md) | `launch_linkedin_brand_awareness_ad`, `launch_linkedin_website_visits_ad`, `launch_linkedin_conversions_ad`, `launch_linkedin_engagement_ad` |\n| Reddit | [references/reddit.md](references/reddit.md) | `launch_reddit_awareness_ad`, `launch_reddit_traffic_ad`, `launch_reddit_conversions_ad`, `launch_reddit_leads_ad`, `launch_reddit_video_views_ad` |\n| TikTok | [references/tiktok.md](references/tiktok.md) | `launch_tiktok_traffic_ad`, `launch_tiktok_leads_ad`, `launch_tiktok_video_views_ad`, `launch_tiktok_conversions_ad` |\n| X Ads | [references/twitter.md](references/twitter.md) | `launch_twitter_awareness_ad`, `launch_twitter_traffic_ad`, `launch_twitter_engagements_ad`, `launch_twitter_followers_ad`, `launch_twitter_video_views_ad` |\n| Pinterest | [references/pinterest.md](references/pinterest.md) | `launch_pinterest_awareness_ad`, `launch_pinterest_traffic_ad`, `launch_pinterest_sales_ad`, `launch_pinterest_leads_ad`, `launch_pinterest_video_views_ad` |\n| OpenAI Ads | [references/openai.md](references/openai.md) | `launch_openai_clicks_ad`, `launch_openai_impressions_ad` (`openai_location_search` optional; details in that file) |\n\nEvery allowlisted `launch_*` tool is named above. Do not call a\nwildcard or an unlisted sibling.\n\n## Launch path\n\nPick one branch before any `launch_*` call.\n\n**paused-campaign-from-winners.** Incoming handoff from analytics +\ncreative must include accepted `asset_url`s, `source_evidence`, and\n`source_ad_ids`. Default `PAUSED`. One summary, one yes. Do not go\nlive unless they say so in that yes.\n\nAn A/B test with a recorded plan (hypothesis, metric, duration,\nstop rule) is `omneky-ab-tests`. A budget-reallocation\n**recommendation** is `omneky-analytics-and-catalogue`. Applying\n`set_ad_budget` after that recommendation still needs one yes\nhere.\n\n**waste-pruner (apply).** Incoming pause list from analytics.\nOne summary naming each entity. `set_ad_entity_status` only\nafter that yes.\n\n**audience-targeting-apply.** Incoming tokens from\n`search_ad_targeting`. `update_ad_targeting` only after a yes.\n\n**target-cpa-budget-apply.** Incoming floor from\n`minimum_budget_for_objective` / `reach_estimate`. `set_ad_budget`\nonly after a yes, at or above the floor.\n\n### Self-managed launch\n\nEvery `launch_*` in the table. Full Preflight below. Disconnected →\nConnect, do not launch.\n\n## Preflight (self-managed)\n\nWork through this checklist with tool calls before a self-managed\n`launch_*` call. Reuse answers the user already gave; ask only for\nwhat is still missing (usually copy, landing URL, budget, and\naudience). Then show **one** launch summary — channel, tool, account,\ncampaign / ad set (new or existing), budget, audience, copy, CTA,\nlanding URL, creative, and status — and get one yes. Do not ask for\na separate confirmation per item. Do not call `launch_*` until that\nyes. Budget, dates, and status in the call must equal the approval;\nif any differ, stop and re-summarize.\n\nStatus: set `campaign_spec.status_on_launch` to `\"PAUSED\"` on\n`launch_*` tools. A non-paused launch needs an explicit yes to\n\nHierarchy is Campaign → Ad Set (`ad_group`) → Ad. The creative is an\nasset on the Ad (`ad_specs`), never on the campaign.\n\n1. **Objective.** Name the channel and the exact `launch_*` tool from\n the table. Read that channel's reference. Do not guess a sibling\n objective.\n2. **Connected account (self-managed only).**\n `get_channel_connection_status` (X Ads: `channel=\"twitter\"`).\n Pinterest also: `get_pinterest_connection_status`. Disconnected →\n Connect below. Do not launch.\n3. **Budget.** `minimum_budget_for_objective` with `brand_id`, channel,\n and objective. Do not set a daily or lifetime budget under that\n floor. `get_channel_budget` is allocated daily budget, not spend,\n not the floor, and not historical ROAS. A disconnected channel is a\n per-channel error, not an empty total.\n4. **Targeting.** The channel pre-call in that reference. Do not launch\n LinkedIn or TikTok without it (the API returns 400).\n5. **Copy, CTA, and landing URL.** Use what the user gave. Do not\n invent a destination. Meta leads also need `lead_gen_form_id` on\n the ad spec.\n6. **Existing campaign or ad set.** `get_campaigns`, then\n `get_ad_groups` with `campaign_id` (unscoped lists can timeout).\n Add under an existing campaign: `campaign_spec={\"id\": \"<campaign_id>\"}`.\n Add into an existing ad set: `ad_group_spec={\"id\": \"<ad_set_id>\"}`\n and set `adset_id` on each ad spec.\n7. **Audience size.** `reach_estimate` with `brand_id`, `channel`, and\n `targeting_fragments` when the user asks how large the audience is.\n That is an estimate, not live delivery or ROAS.\n8. **Custom conversions.** `get_ad_custom_properties` when the launch needs\n a brand conversion event. Not a performance report.\n9. **Credits.** Launch creates need available Omneky credits; the\n server checks this. `credit_insufficient` means the launch did\n **not** start. Do not retry it. Tell the user the shortfall; credits\n are added in the Omneky app. Never collect a PAN. Never invent a\n credit purchase tool.\n\n## Targeting pre-calls\n\nMeta and Reddit take inline targeting (see those references). X Ads\nuses `channel=\"twitter\"`. Pinterest checks\n`get_pinterest_connection_status` and uses inline countries. The three\nlookups below are required before launch.\n\n**TikTok.** Before any `launch_tiktok_*`: `get_tiktok_location_ids`\nwith `brand_id` and required `campaign_objective`. Put the returned\nids on the ad group as `location_ids`. Without them the API returns\n400. Details: [references/tiktok.md](references/tiktok.md).\n\n**LinkedIn.** Before any `launch_linkedin_*`: `search_ad_targeting`\nwith `brand_id`, `channel=\"linkedin\"`, `types=[\"locations\"]`. Copy a\nhit whose value includes `urn:li:adTargetingFacet:locations` into\n`targeting_criteria`. A new campaign group also needs `start_date`.\nDetails: [references/linkedin.md](references/linkedin.md).\n\n**Google Demand Gen vs PMax.** Demand Gen is one image or video on\nYouTube or Discover — `search_google_countries`, then\n`targeting_fragments`. PMax is the full multi-placement asset suite\n(no country lookup). Details: [references/google.md](references/google.md).\n\n`register_creative_for_launch` is optional (Ad Central library). Pass\n`asset_url` or `preview_storage_key` as the finished HTTPS URL\n(`presigned_url` / `assets.url`); the server copies it. Launch itself\ntakes `ad_specs[].media_url`. Use `search_ad_targeting` for LinkedIn /\noptional X Ads location lookup.\n\n## Creative → launch (short)\n\n<!-- host:begin name=\"launch-generation-stays\" -->\nGeneration stays in the matching creative skill (`omneky-image-ads`,\n`omneky-product-video`, or `omneky-edit-and-resize`). This\nskill starts once the user\nhas a finished Omneky ad and wants it on a paid-media channel.\n<!-- host:end -->\n\n1. The launch summary covers the creative URL too; one yes is enough.\n2. Put the finished HTTPS URL (`presigned_url` / `resized_ad_url` /\n `assets.url`) on `ad_specs[].media_url` with `media_type`. Published\n copy fields (`headline`, `primary_text`, `cta`, `landing_url`) are\n mapped to the launcher names. Google Performance Max: `ad_specs: []`\n and put images / `link_url` / headlines (≥3) / descriptions (≥2) on\n `ad_group_spec`. Square and logo images are required and must not\n reuse the landscape ad image.\n `register_creative_for_launch` is optional (library). Pass\n `asset_url` or `preview_storage_key` as that same HTTPS URL if the\n user wants it saved. Do not stop for a missing storage key.\n3. Run the matching Preflight,\n then the matching `launch_*` from the table. Keep the launch\n `PAUSED` unless the user explicitly says to go live. Then run\n Launch checks.\n\n## Manage (short)\n\n`get_campaigns` (each row is name with campaign id) /\n`get_ad_groups` (pass `campaign_id`) / `get_ads`. A disconnected or\nskipped channel returns an explicit error, not an empty-looking list.\n`set_ad_entity_status` (pause or resume), `set_ad_budget`,\n`update_ad_targeting`, `set_pinterest_entity_status`.\n\nBefore any of those mutate tools, show one summary and wait for an\nexplicit yes. The summary names the entity (name and id), the\nchannel, the current value, the new value, and that the change\naffects live spend. One yes covers the batch; do not confirm each\nitem separately.\n\nName the user said, ids only: `get_campaign_ad_group_names`. Not a\nstatus or budget list.\n\nPinterest lists: `get_pinterest_campaigns`, `get_pinterest_ad_groups`\n(pass `campaign_id`), `get_pinterest_ads`. Pause or resume with\n`set_pinterest_entity_status` (same one-summary / one-yes rule).\n\n`needs_user_decision` → hand off to\n`omneky-getting-started-and-failures` (`request_user_decision`). Do not dump raw\nJSON.\n\n**Deletes.** `delete_campaign`, `delete_ad_group`, and `delete_ads`\nare irreversible. Prefer pause (`set_ad_entity_status`) when the user\nonly wants a stop.\n\n1. Resolve ids first: `get_campaigns`, `get_ad_groups` (pass\n `campaign_id`), `get_ads`. Do not delete from a name alone.\n2. In chat, name exactly what will be removed: channel, entity type,\n name, and id. Say it cannot be undone.\n3. Wait for an explicit yes that repeats that entity (for example\n \"yes, delete campaign 123\"). A vague \"ok\", or a yes to a different\n question, is not confirmation. Do not call the delete until that\n yes. If they say no, stop.\n4. Then call one tool:\n - `delete_campaign` — `brand_id`, `channel`, `campaign_id`\n - `delete_ad_group` — `brand_id`, `channel`, `ad_group_id`\n - `delete_ads` — `brand_id`, `channel`, `ad_ids` (list of ids)\n\n## Connect (short)\n\nPaid-media self-connect for the chosen brand. OAuth wire values:\n`facebook`, `google`, `linkedin`, `tiktok`, `reddit`, `twitter`,\n`pinterest`. X Ads is `twitter`, never `x`. OAuth channels never need a\ntoken or password in chat — do not ask for one.\n\nCall `link_ad_channel_account` only when it appears on this\nsession's `tools/list`. If it is not listed, say that capability\nisn't available on this connector. Do not invent a link.\n\n1. `get_channel_connect_url` with `channel` and `brand_id`. Omit\n `redirect_url` unless its host is `omneky.com`. Hand the user\n `connect_url` (or `browser_connect_url`). `next_action` is\n `open_connect_url`. They finish the provider consent screen.\n2. **OAuth not finished.** If they have not completed consent, or\n `list_authorized_ad_accounts` is empty or errors, do not link and\n do not launch. Send the same URL again. Do not collect a token.\n3. After they confirm consent: `list_authorized_ad_accounts` with\n `brand_id` and `channel`. Several accounts: ask which `id` / name.\n Do not pick silently.\n4. Meta / Facebook pages: also `list_authorized_facebook_pages` with\n `brand_id`. When `link_ad_channel_account` is on `tools/list`, it\n needs `facebook_page_id` plus `channel_account_id` and\n `channel_account_name`. If `link_ad_channel_account` is not on\n `tools/list`, say that capability isn't available on this\n connector. Do not invent a link.\n5. Other channels: when `link_ad_channel_account` is on `tools/list`,\n call it with `brand_id`, `channel`, `channel_account_id`, and\n `channel_account_name`. If it is not listed, say that capability\n isn't available on this connector. Do not invent a link.\n6. Confirm with `list_connector_statuses` and\n `get_channel_connection_status`. Still disconnected: stop and say\n so. Do not launch.\n\n**OpenAI Ads** has no OAuth URL. Status:\n`get_openai_ads_connection_status` (or `get_channel_connection_status`\nwith `channel=\"openai\"`). There is no OpenAI Ads connect tool on this\nlisting: the user connects it in the Omneky app. Launching on OpenAI\nAds is supported for connected accounts:\n`launch_openai_clicks_ad` / `launch_openai_impressions_ad` (see\n[references/openai.md](references/openai.md)).\n\n**PostHog:** connect it in the Omneky app; then\n`get_posthog_connection_status` (host and project id, never the key).\n`disconnect_posthog` only after an explicit yes. Drive:\n`get_google_drive_connection_status`, then\n`get_google_drive_connect_url` if it is disconnected.\n`disconnect_google_drive` only after an explicit yes. No Pinterest or\nX Ads disconnect tool on this surface.\n\nX Ads pause is `set_ad_entity_status` at **campaign** level only.\nPinterest launches are supported (`launch_pinterest_*`).\n\nConnected OpenAI Ads launches use `launch_openai_*`. OpenAI targeting\nstays on `campaign_spec.targeting`. A disconnected account must be\nconnected first. Connecting an account is a separate step\nfrom launching.\n\n## Launch checks\n\nObserve the launch reply or one cheap get_* read-back. Request\narguments never prove saved campaign configuration.\n\nReply or read-back already shows the fact → say it plainly (e.g.\n\"done\"). Do not hedge. Missing detail → **one** get_* call. If it\nis still not confirmed, say so in one short plain sentence (e.g.\n\"I couldn't confirm the saved budget\").\n\n- Campaign / ad-set / ad ids — launch reply, then `get_campaigns` /\n `get_ad_groups` / `get_ads` (Pinterest: `get_pinterest_*`)\n- Status equals the approval (`PAUSED` unless they said go live) —\n same reply or a get_* read-back, not request `status_on_launch`\n- Budget and dates — created entity via get_*. Request args never\n prove the save\n- Channel and `launch_*` tool — the tool that ran plus the entity's\n channel field\n- Creative URL and copy on the created ad — `get_ads` (or\n launch-reply ad fields). Request `ad_specs` never prove the save\n\nIf a check fails: say which field differed. Do not claim live or\npaused as requested. Do not silently relaunch.\n\n## Failure and recovery\n\nAuth / 401 → `omneky-getting-started-and-failures` (host OAuth).\nEmpty reporting → empty is missing data, not zero; narrow the window.\n`credit_insufficient` → nothing charged; the user can add credits in the Omneky app.\n`needs_user_decision` → `request_user_decision`; never dump JSON.\nMissing tool → say so; Omneky app. Do not invent it.\nNever ask for internal ids. Never silent-switch `brand_id`.\n\n<!-- host:begin name=\"capability-gaps-link\" -->\n## Gaps\n\nThis connector cannot do comment/social inbox, landing pages,\nsubtitle burn-in, email/SMS, organic scheduling, Meta Ad Library\ncompetitor ads, virtual try-on, or website builder. Decline those.\nSee [capability-gaps](../_shared/references/capability-gaps.md).\n<!-- host:end -->\n""---\nname: omneky-launch-and-connect\ndescription: >-\n Launch Omneky paid-media campaigns and connect missing ad\n accounts (Meta/Facebook, Google, TikTok, LinkedIn, Reddit,\n Pinterest, X/Twitter, OpenAI Ads). Use to launch, publish,\n pause/budget/retarget, or connect an ads account. Do\n not use for first-run onboarding (omneky-onboarding), agency\n cross-brand (omneky-agency), ROAS analytics or catalogue\n (omneky-analytics-and-catalogue), competitor analysis\n (omneky-competitor-analysis), A/B tests (omneky-ab-tests),\n weekly marketing plans (omneky-marketing-plan), AI creative\n generation, or credit balance (omneky-billing).\n Keywords: launch Meta sales ads, launch campaign, Meta ads,\n Facebook ads, Google PMax, TikTok ads, LinkedIn ads, connect\n ads, pause ad, budget, targeting, twitter, paused, preflight,\n waste pruner pause, update ad targeting, apply target CPA\n budget, Demand Gen, TikTok locations, Pinterest campaigns.\n---\n\n# Launch paid ads and connect accounts\n\nUse this when the user wants to launch, pause, re-budget, retarget or\ndelete paid ads, or connect an ad account. One job: paid-media\nchanges and account connection. Live vs paused is the host's call from the user's request.\n\nGate on `tools/list`; a missing launch tool → the Omneky app. X Ads\nis channel `twitter`; OpenAI Ads is `openai`.\nStep detail: [playbook](references/playbook.md) (channel table, launch\npath, preflight, targeting, manage, connect, launch checks).\n\nHandoff fields: [handoff-contract](../_shared/references/handoff-contract.md).\nSourced ids (how to obtain / what to do if absent): [preconditions](../_shared/references/preconditions.md).\n<!-- host:begin name=\"scan-tools-routing\" -->\nAcceptance gates: [creative-quality-gates](../_shared/references/creative-quality-gates.md).\nOther intents: [capability-registry](../_shared/references/capability-registry.md).\nWrite for: [marketer-persona](../_shared/references/marketer-persona.md).\n<!-- host:end -->\n\n## Goal\n\nLaunch or mutate paid media the user asked for. Set `campaign_spec.status_on_launch` from what the user asked (no server default). Launches, deletes, budget, status and targeting changes are marked destructive, so the host confirms them; do not add your own approval step.\n\n## Prerequisites\n\n| Need | Check | If missing |\n|---|---|---|\n| Brand | `list_brands` | Ask which |\n| Channel | `list_connections` (`connector`) | `get_connect_link` → `list_ad_accounts` → `link_ad_account` when listed. If `link_ad_account` is not on `tools/list`, say that capability isn't available on this connector. Do not invent a link. Or managed launch |\n| Budget floor | `get_launch_requirements` | Do not launch under the floor |\n| Audience size | `estimate_reach` | Optional; estimate only |\n| Targeting tokens | `search_targeting` (`channel`, `query`) / `search_targeting` (`channel=\"tiktok\"`, `objective`) / `search_targeting` (`channel=\"google\"`) | Required on LinkedIn / TikTok / Demand Gen |\n<!-- host:begin name=\"launch-creative-url-row\" -->\n| Creative URL | any finished HTTPS asset URL (prior generate or user-supplied) | No URL at all → Owning creative skill first |\n<!-- host:end -->\n| Credits | `get_account` | `omneky-billing` |\n\n## Flow\n\n1. Pick the channel and the exact `launch_*` tool from the playbook\n table, then read only that channel's reference.\n2. Self-managed: confirm the account is connected; if not, run\n Connect and stop. Managed (no account): skip Connect.\n3. Check the budget floor and run the channel's targeting pre-call\n (TikTok locations, LinkedIn locations, Demand Gen countries).\n4. Fill copy, CTA, landing URL and the finished asset URL from the\n conversation; ask only for what you cannot infer. Use\n `approved_claims` from the handoff; never invent a claim or URL.\n5. Show one summary (channel, spend, audience, asset, status) and\n call the tool. Launches, deletes, budget, status and targeting\n changes are marked destructive, so the host confirms them; do not\n add your own approval step.\n6. Read back with one get_* call and report what launched, status,\n and spend at risk.\n\n## When to use\n\n- Launch a campaign, publish an ad, pause, budget, or retarget\n- Connect a disconnected Meta, Google, TikTok, LinkedIn, Reddit,\n Pinterest, X Ads, or OpenAI Ads account\n\n## When not to use\n\n- First-run setup / first ad today / run it for me → `omneky-onboarding`\n- Cross-brand / all clients → `omneky-agency`\n- ROAS, winning ads, or catalogue import (analytics skill)\n- Weekly marketing plan create / revise / poll / approve\n<!-- host:begin name=\"launch-when-not-creative\" -->\n- Branded image ads or product video ads (`omneky-image-ads` /\n `omneky-product-video`)\n<!-- host:end -->\n- Credit balance or plan upgrade (`omneky-billing`)\n\n## Failure and recovery\n\nAuth / 401 → `omneky-getting-started-and-failures` (host OAuth).\nEmpty reporting → `get_performance_summary` (`include_coverage=true`); empty is not zero.\n`credit_insufficient` → nothing charged; state balance vs required\n(`omneky-billing`). No payment links.\n`needs_user_decision` → fill the missing detail and call again; ask in plain chat only if you cannot. Never dump JSON.\nMissing tool → this session may run an older published app snapshot: look\nthe name up in [tool-name-fallbacks](../_shared/references/tool-name-fallbacks.md)\nand call the older name if that one is on `tools/list`. If neither is\nlisted, say so; Omneky app. Do not invent it.\nNever ask for internal ids. Never silent-switch `brand_id`.\n\n<!-- host:begin name=\"capability-gaps-link\" -->\n## Gaps\n\nDecline social inbox, landing pages, subtitle burn-in, email/SMS,\norganic scheduling, Ad Library ads, try-on, and website builder\n([capability-gaps](../_shared/references/capability-gaps.md)).\n<!-- host:end -->\n"
Full snapshot data
{
"description": "Launch Omneky paid-media campaigns and connect missing ad accounts (Meta/Facebook, Google, TikTok, LinkedIn, Reddit, Pinterest, X/Twitter, OpenAI Ads). Use to launch, publish, pause/budget/retarget, or connect an ads account. Do not use for first-run onboarding (omneky-onboarding), agency cross-brand (omneky-agency), ROAS analytics or catalogue (omneky-analytics-and-catalogue), competitor analysis (omneky-competitor-analysis), A/B tests (omneky-ab-tests), weekly marketing plans (omneky-marketing-plan), AI creative generation, or credit balance (omneky-billing). Keywords: launch Meta sales ads, launch campaign, Meta ads, Facebook ads, Google PMax, TikTok ads, LinkedIn ads, connect ads, pause ad, budget, targeting, twitter, paused, preflight, waste pruner pause, update ad targeting, apply target CPA budget, Demand Gen, TikTok locations, Pinterest campaigns.",
"included_files": [
{
"relative_path": "references/facebook.md",
"size_in_bytes": 759
},
{
"relative_path": "references/google.md",
"size_in_bytes": 1147
},
{
"relative_path": "references/linkedin.md",
"size_in_bytes": 963
},
{
"relative_path": "references/managed.md",
"size_in_bytes": 1091
},
{
"relative_path": "references/openai.md",
"size_in_bytes": 1098
},
{
"relative_path": "references/pinterest.md",
"size_in_bytes": 1165
},
{
"relative_path": "references/playbook.md",
"size_in_bytes": 16092
},
{
"relative_path": "references/reddit.md",
"size_in_bytes": 784
},
{
"relative_path": "references/tiktok.md",
"size_in_bytes": 912
},
{
"relative_path": "references/twitter.md",
"size_in_bytes": 843
}
],
"name": "omneky-launch-and-connect",
"skill_md_contents": "---\nname: omneky-launch-and-connect\ndescription: >-\n Launch Omneky paid-media campaigns and connect missing ad\n accounts (Meta/Facebook, Google, TikTok, LinkedIn, Reddit,\n Pinterest, X/Twitter, OpenAI Ads). Use to launch, publish,\n pause/budget/retarget, or connect an ads account. Do\n not use for first-run onboarding (omneky-onboarding), agency\n cross-brand (omneky-agency), ROAS analytics or catalogue\n (omneky-analytics-and-catalogue), competitor analysis\n (omneky-competitor-analysis), A/B tests (omneky-ab-tests),\n weekly marketing plans (omneky-marketing-plan), AI creative\n generation, or credit balance (omneky-billing).\n Keywords: launch Meta sales ads, launch campaign, Meta ads,\n Facebook ads, Google PMax, TikTok ads, LinkedIn ads, connect\n ads, pause ad, budget, targeting, twitter, paused, preflight,\n waste pruner pause, update ad targeting, apply target CPA\n budget, Demand Gen, TikTok locations, Pinterest campaigns.\n---\n\n# Launch paid ads and connect accounts\n\nUse this when the user wants to launch, pause, re-budget, retarget or\ndelete paid ads, or connect an ad account. One job: paid-media\nchanges and account connection. Live vs paused is the host's call from the user's request.\n\nGate on `tools/list`; a missing launch tool → the Omneky app. X Ads\nis channel `twitter`; OpenAI Ads is `openai`.\nStep detail: [playbook](references/playbook.md) (channel table, launch\npath, preflight, targeting, manage, connect, launch checks).\n\nHandoff fields: [handoff-contract](../_shared/references/handoff-contract.md).\nSourced ids (how to obtain / what to do if absent): [preconditions](../_shared/references/preconditions.md).\n<!-- host:begin name=\"scan-tools-routing\" -->\nAcceptance gates: [creative-quality-gates](../_shared/references/creative-quality-gates.md).\nOther intents: [capability-registry](../_shared/references/capability-registry.md).\nWrite for: [marketer-persona](../_shared/references/marketer-persona.md).\n<!-- host:end -->\n\n## Goal\n\nLaunch or mutate paid media the user asked for. Set `campaign_spec.status_on_launch` from what the user asked (no server default). Launches, deletes, budget, status and targeting changes are marked destructive, so the host confirms them; do not add your own approval step.\n\n## Prerequisites\n\n| Need | Check | If missing |\n|---|---|---|\n| Brand | `list_brands` | Ask which |\n| Channel | `list_connections` (`connector`) | `get_connect_link` → `list_ad_accounts` → `link_ad_account` when listed. If `link_ad_account` is not on `tools/list`, say that capability isn't available on this connector. Do not invent a link. Or managed launch |\n| Budget floor | `get_launch_requirements` | Do not launch under the floor |\n| Audience size | `estimate_reach` | Optional; estimate only |\n| Targeting tokens | `search_targeting` (`channel`, `query`) / `search_targeting` (`channel=\"tiktok\"`, `objective`) / `search_targeting` (`channel=\"google\"`) | Required on LinkedIn / TikTok / Demand Gen |\n<!-- host:begin name=\"launch-creative-url-row\" -->\n| Creative URL | any finished HTTPS asset URL (prior generate or user-supplied) | No URL at all → Owning creative skill first |\n<!-- host:end -->\n| Credits | `get_account` | `omneky-billing` |\n\n## Flow\n\n1. Pick the channel and the exact `launch_*` tool from the playbook\n table, then read only that channel's reference.\n2. Self-managed: confirm the account is connected; if not, run\n Connect and stop. Managed (no account): skip Connect.\n3. Check the budget floor and run the channel's targeting pre-call\n (TikTok locations, LinkedIn locations, Demand Gen countries).\n4. Fill copy, CTA, landing URL and the finished asset URL from the\n conversation; ask only for what you cannot infer. Use\n `approved_claims` from the handoff; never invent a claim or URL.\n5. Show one summary (channel, spend, audience, asset, status) and\n call the tool. Launches, deletes, budget, status and targeting\n changes are marked destructive, so the host confirms them; do not\n add your own approval step.\n6. Read back with one get_* call and report what launched, status,\n and spend at risk.\n\n## When to use\n\n- Launch a campaign, publish an ad, pause, budget, or retarget\n- Connect a disconnected Meta, Google, TikTok, LinkedIn, Reddit,\n Pinterest, X Ads, or OpenAI Ads account\n\n## When not to use\n\n- First-run setup / first ad today / run it for me → `omneky-onboarding`\n- Cross-brand / all clients → `omneky-agency`\n- ROAS, winning ads, or catalogue import (analytics skill)\n- Weekly marketing plan create / revise / poll / approve\n<!-- host:begin name=\"launch-when-not-creative\" -->\n- Branded image ads or product video ads (`omneky-image-ads` /\n `omneky-product-video`)\n<!-- host:end -->\n- Credit balance or plan upgrade (`omneky-billing`)\n\n## Failure and recovery\n\nAuth / 401 → `omneky-getting-started-and-failures` (host OAuth).\nEmpty reporting → `get_performance_summary` (`include_coverage=true`); empty is not zero.\n`credit_insufficient` → nothing charged; state balance vs required\n(`omneky-billing`). No payment links.\n`needs_user_decision` → fill the missing detail and call again; ask in plain chat only if you cannot. Never dump JSON.\nMissing tool → this session may run an older published app snapshot: look\nthe name up in [tool-name-fallbacks](../_shared/references/tool-name-fallbacks.md)\nand call the older name if that one is on `tools/list`. If neither is\nlisted, say so; Omneky app. Do not invent it.\nNever ask for internal ids. Never silent-switch `brand_id`.\n\n<!-- host:begin name=\"capability-gaps-link\" -->\n## Gaps\n\nDecline social inbox, landing pages, subtitle burn-in, email/SMS,\norganic scheduling, Ad Library ads, try-on, and website builder\n([capability-gaps](../_shared/references/capability-gaps.md)).\n<!-- host:end -->\n"
}SHA-256 of public snapshot: c8678d682416cff622f14bb5523a28d3420e92a0d7c233541aab4ffd0a350e7f