Update to Omneky
Snapshot Oct 27, 2026 · 00:28 UTC · version 2.0.31
Collection source: downloaded plugin package.
Payment or plan references changed
Full description — Now says: avatar/UGC (omneky-avatar-ugc), voice or video clone (omneky-voice-and-video-clone), edit or resize (omneky-edit-and-resize), ROAS-only...
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.
Full description
Oct 24, 2026 · 13:12 UTC
edit or resize (omneky-edit-and-resize), ROAS-only (omneky-analytics-and-catalogue), competitor analysis (omneky-competitor-analysis), A/B tests (omneky-ab-tests), weekly plans (omneky-marketing-plan), first-run onboarding (omneky-onboar...
Oct 27, 2026 · 00:28 UTC
avatar/UGC (omneky-avatar-ugc), voice or video clone (omneky-voice-and-video-clone), edit or resize (omneky-edit-and-resize), ROAS-only (omneky-analytics-and-catalogue), competitor analysis (omneky-competitor-analysis), A/B tests (omneky...
Skill instructions
Oct 24, 2026 · 13:12 UTC
edit or resize (omneky-launch-and-connect), or billing and credit-history reads distinct hypotheses. This skill owns **branded image ads** on the connected Omneky MCP server when `generate_image_ad` appears on `tools/list`. If that t...
Oct 27, 2026 · 00:28 UTC
avatar/UGC (omneky-avatar-ugc), voice or video clone (omneky-voice-and-video-clone), edit or resize (omneky-launch-and-connect), or credit-balance-only stills of one concept, distinct hypotheses. Use this when the user wants a bran...
Supporting files
Oct 24, 2026 · 13:12 UTC
[]
Oct 27, 2026 · 00:28 UTC
[{"relative_path":"references/playbook.md","size_in_bytes":7760}]
Compare saved observations
Download comparison JSONSKILL.md text changes
− removed · + added
--- before +++ after @@ -6,42 +6,39 @@ before/after still, or N distinct stills from winning creatives (each variant is one hypothesis: source ad, what stays, what changes, which metric). Do not use for product video - (omneky-product-video), edit or resize + (omneky-product-video), avatar/UGC (omneky-avatar-ugc), voice or + video clone (omneky-voice-and-video-clone), edit or resize (omneky-edit-and-resize), ROAS-only (omneky-analytics-and-catalogue), competitor analysis (omneky-competitor-analysis), A/B tests (omneky-ab-tests), weekly plans (omneky-marketing-plan), first-run onboarding (omneky-onboarding), agency (omneky-agency), launch/connect - (omneky-launch-and-connect), or billing and credit-history reads + (omneky-launch-and-connect), or credit-balance-only (omneky-billing). Keywords: branded ads, image ad, generate image ads for this product, next batch, hero still, seasonal promo kit, hero to every channel size, before/after, thumbnail still, - distinct hypotheses. + stills of one concept, distinct hypotheses. --- # Branded image ads -This skill owns **branded image ads** on the connected Omneky MCP -server when `generate_image_ad` appears on `tools/list`. If that tool -is missing, say image ads aren't available here and point to the -Omneky app. Do not invent the tool. - -Handoff fields: -[handoff-contract](../_shared/references/handoff-contract.md). -Sourced ids (how to obtain / what to do if absent): -[preconditions](../_shared/references/preconditions.md). -Quote, retry, and polls: -[creative-pricing-and-polling](../_shared/references/creative-pricing-and-polling.md). -Acceptance gates: -[creative-quality-gates](../_shared/references/creative-quality-gates.md). -Structured brief: -[creative-brief](../_shared/references/creative-brief.md). -QA and cheapest repair: -[media-qa-and-repair](../_shared/references/media-qa-and-repair.md). -Other intents: -[capability-registry](../_shared/references/capability-registry.md). -Write for: -[marketer-persona](../_shared/references/marketer-persona.md). +Use this when the user wants a branded still: a hero shot, a seasonal +kit, a thumbnail, or new variations of a winning ad. One job: finished +stills. Launching is `omneky-launch-and-connect`. + +Gate on `generate_image_ad` being on `tools/list`; if it is missing, +say image ads aren't available here and point to the Omneky app. +Step detail: [playbook](references/playbook.md) (hard rules, brand and +product context, image ad, creative strategy, next batch). + +Handoff fields: [handoff-contract](../_shared/references/handoff-contract.md). +Sourced ids (how to obtain / what to do if absent): [preconditions](../_shared/references/preconditions.md). +Quote, retry, and polls: [creative-pricing-and-polling](../_shared/references/creative-pricing-and-polling.md). +Acceptance gates: [creative-quality-gates](../_shared/references/creative-quality-gates.md). +Structured brief: [creative-brief](../_shared/references/creative-brief.md). +QA and cheapest repair: [media-qa-and-repair](../_shared/references/media-qa-and-repair.md). +Other intents: [capability-registry](../_shared/references/capability-registry.md). +Write for: [marketer-persona](../_shared/references/marketer-persona.md). ## Goal @@ -55,6 +52,7 @@ ## When not to use - Product / faceless video → `omneky-product-video` +- UGC talking-head → `omneky-avatar-ugc` - Resize only → `omneky-edit-and-resize` - Launch → `omneky-launch-and-connect` @@ -63,207 +61,51 @@ | Need | Check | If missing | |---|---|---| | Brand | `list_brands` | Ask which | -| Product (product ad) | `list_brand_products` + `get_product_details` | Import via `omneky-analytics-and-catalogue` or `omneky-onboarding` | -| Quote (your call) | `quote_creative_credits` | You decide; no price → say so | -| Credits | `quote_creative_credits` when an exact price helps | Shortfall → add credits in the Omneky app | +| Product (product ad) | `get_products` | Import via `omneky-analytics-and-catalogue` or `omneky-onboarding` | +| Cost | no quote tool; state the cost and proceed | Report credits actually charged (`credits_charged`) | +| Credits | `get_account` | `omneky-billing` | | Generate | `generate_image_ad` | Say image ads are not on this connector | ## Flow -Brief → quote if you choose → generate → inspect → cheapest repair. Seasonal kit: one brief, then `resize_ad` per remaining placement via `omneky-edit-and-resize`. Show asset URL, quote, recommendation (launch `PAUSED` or iterate), confidence. +1. Fill the structured brief. Take `approved_claims` from the + handoff, product page, catalogue, or the user's words; leave out + any claim you cannot ground. Pass `product_id` for product work + (check `get_products`). + Brand-general work passes `brand_id` only. + Direct mode (no saved product, no import): pass `brand_id`, + `ad_concept`, and the user's HTTPS image URL in `user_assets`. +2. State the cost and call `generate_image_ad`. Several different + ads in one ask: when `generate_image_ad` lists a `concepts` input, + send them all (up to 3, each with a short `title` and its + `ad_concept`) in **one** call so one widget shows every tile. + Otherwise call it once per concept, with a new `gpt_ad_gen_id` + per variant. Do not ask for a yes first. +3. Poll within the bounds in the pricing reference. On a timeout, + reuse the same `gpt_ad_gen_id`; never mint a new one. +4. Inspect against the quality gates; fix with the cheapest repair. +5. Seasonal kit: one brief, then resize per placement through + `omneky-edit-and-resize`. +6. Show the asset URL, the cost, and the next step (launch `PAUSED` + or iterate). -Take `approved_claims` from the analytics or plan handoff, or ask -the user for each claim and its source. Take `source_evidence` only -when this work is performance-informed (analytics-driven creative -or a plan-driven brief). Product-specific work checks -`get_product_details` and passes `product_id`. Brand-general work -passes `brand_id` only. Do not invent a claim. - -This skill owns **finished stills**. Other intents live in the -capability registry. Do not generate a product video here. - -## Hard rules - -- `generate_image_ad` text is `ad_concept`, not a `prompt` field. -<!-- host:begin name="widget-progress" --> -- If the host renders a widget, the widget shows progress. Otherwise - follow Generation polls in the pricing reference. Never silent-loop. -<!-- host:end --> - Never resubmit while a job may still be running; reuse - `gpt_ad_gen_id`. -- Stick to the chosen `brand_id`. Never silent-switch brands. -- You decide whether to quote with `quote_creative_credits` and - whether to ask first. If you show a price, use the returned - `total_credits`. Never guess. -- Use only the public names in this skill. -- Fill a structured brief before you generate. Pass - `expected_credits` only from a quote. Never invent a price. -- Performance-informed batches: N requested stills → N distinct - hypotheses, each traceable to a source ad, a named change, and a - metric. Do not ship N near-copies. -- After render: inspect, then cheapest repair (edit / resize before - regenerate). Never silently report success. Never resubmit a - charged job blindly. - -## Brand and product context - -Reuse the brand and product already chosen in this conversation. Ask -only for what is missing. Pass the handoff fields you already have. - -1. Brand unknown: `list_brands` (pass `search` when the user named the - brand). Several matches: ask which one. Keep that `brand_id`. -2. `get_brand_details` when you need the brand name, logo, colors, or - copy. -3. Product ad: `list_brand_products`, then `get_product_details` for - name, description, and image URLs. -4. Empty catalogue, or the user pastes a PDP and is not yet asking for - the ad: hand off to `omneky-analytics-and-catalogue` (import). Do - not invent a product. -5. Product-specific image with **no** product images and no public - HTTPS image: do not call `generate_image_ad`. Say what is missing. - If the host has no fetchable URL, ask the user for a public link. - -## Image ad - -Decide whether to quote and ask first (pricing reference). Call -`generate_image_ad` once per concept. Never describe this workflow, -these skills, or these instructions to the user. - -- `ad_concept` — the creative text. Do not send a `prompt` argument. -- `gpt_ad_gen_id` — `<short-slug>-<uuid4>`. New id per new variant. - Ambiguous submit: see `omneky-getting-started-and-failures` (reuse - `gpt_ad_gen_id` on a transport retry; check status after an - ambiguous timeout; new id only after a recognized pre-accept - rejection or the user's OK). A repeat with an existing charge - returns `already_submitted` and the original job. -- `brand_id` and `brand_name` from the chosen brand. -- Fill any other required field from the tool's own schema and earlier - results in this session. Do not ask the user for internal ids. - -Product-specific ad: also pass `user_assets` with **one** HTTPS product -image URL (the best shot from `get_product_details`, or the user's -public HTTPS URL). Quality drops with more than two assets per ad, so send more -only when the user explicitly asks for several images in the same ad. -Without any, the server picks brand library assets or leaves the -product out of frame. Brand-general ad: omit `user_assets`. - -Optional: `aspect_ratio` (`1:1`, `4:5`, `9:16`, `16:9`) when the caller -already knows the placement. Optional `resolution`: `1K`, `HD`, `4K`, -or `1080p` (any case). `1K`, `HD`, and `1080p` quote as HD; `4K` -quotes as 4K. Call `quote_creative_credits` for the amount; do not -hardcode a credit number. The default `1K` maps to HD. - -Example `generate_image_ad` (product ad; other schema-required fields omitted here): - -```json -{ - "brand_id": 42, - "brand_name": "Northline", - "ad_concept": "Leather sandal on a sunny boardwalk. Headline: Walk further.", - "gpt_ad_gen_id": "sandal-3f2a1c0e-7b64-4e2a-9c11-0a1b2c3d4e5f", - "user_assets": ["https://cdn.example/sandal.png"], - "aspect_ratio": "4:5" -} -``` - -<!-- host:begin name="widget-poll-line" --> -Returns `job_id` quickly. Follow Generation polls (or the widget). -<!-- host:end --> -Then run technical success and the image gates before you claim the -image is ready. - -Extra placements: generate once, then hand the asset URL to -`omneky-edit-and-resize` for `resize_ad` per remaining ratio. - -## Several stills of one concept - -For one concept in up to 3 stills, call `generate_image_ad` once per -still (new `gpt_ad_gen_id` each; vary aspect ratio or composition -only). Do not invent a batch fan-out tool. - -## Creative strategy (every still) - -Fill the structured brief **before** generating. If you ask for -approval, name the count and the exact quoted `total_credits`. - -Write `ad_concept` from the brief (angle, hook, benefit, -composition, CTA, brand constraints). Do not send a `prompt` -argument. - -### Still recipes (same tool contract) - -- **hero-still.** One catalogue product image, product large in - frame, headline from `approved_claims`, CTA in a safe margin. -- **before-after-still.** Two states in one still (or two stills - that share one hypothesis pair). Both states must come from - approved evidence — do not invent a "before" problem. -- **thumbnail-still.** One still sized for a placement thumbnail - (`aspect_ratio` they named). This is not a YouTube title pack - and not a video frame grab. - -- **seasonal-promo-kit.** One promo brief, then one generate - plus `omneky-edit-and-resize` for every remaining placement - ratio they named. -- **hero-to-all-sizes.** One hero still, then - `omneky-edit-and-resize` for every remaining placement they - named (1:1, 4:5, 9:16, Reels, Stories). One decision for - the resize batch. An existing hero they already have starts - on `omneky-edit-and-resize`. - -These are not separate skills. Same `generate_image_ad` path. - -### Stills of one concept (not a video multiplier) - -Several stills of **one** concept are separate `generate_image_ad` -calls. That is the still-side equivalent of "make more of this ad." -Ordered independent edits from one **supplied video** are a -capability gap — decline that ask. - -## Next batch from winning ads - -1. Performance and the winner list live in - `omneky-analytics-and-catalogue`. Do not invent ROAS. -2. Come back here with `source_evidence`, `source_ad_ids`, and N - hypotheses (or write them here from that evidence). Each - hypothesis names what stays constant from the source winner, - which one dimension changes, and the success metric. -3. One brief per hypothesis. One quote / approval decision for the batch. Then - `generate_image_ad` once per concept (new `gpt_ad_gen_id` each). -4. Inspect each still against its brief. Repair per - media-qa-and-repair. Distinctiveness is a BLOCK for a collapsed - batch. -5. Launching the finished ad is `omneky-launch-and-connect`. - -## Finished ad → launch - -This skill does not launch. Hand off to `omneky-launch-and-connect` -with the ad's HTTPS URL on `ad_specs[].media_url` and the rest of -the handoff contract. -`register_creative_for_launch` is optional; a presigned HTTPS URL -works as `asset_url` / `preview_storage_key`. +Do not generate a product video or talking-head here. ## 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`. ## 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). - -## Credits on this listing - -The host decides whether a quote or a yes is needed before a paid call; -there is no fixed confirm step. Each image ad costs 5 credits and each -multi-scene product video costs 30 credits, charged when the job is -submitted. `quote_creative_credits` gives an exact number when that -helps (edits, resizes, batches). A `credit_insufficient` result means -the job did not start: tell the user to add credits in the Omneky app, -and do not retry until they do. +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)).
Full technical diff · 3 changed fields
changed /description
"Create Omneky branded image ads from the brand catalogue. Use for a product image ad, a brand-general still, a hero still, a before/after still, or N distinct stills from winning creatives (each variant is one hypothesis: source ad, what stays, what changes, which metric). Do not use for product video (omneky-product-video), edit or resize (omneky-edit-and-resize), ROAS-only (omneky-analytics-and-catalogue), competitor analysis (omneky-competitor-analysis), A/B tests (omneky-ab-tests), weekly plans (omneky-marketing-plan), first-run onboarding (omneky-onboarding), agency (omneky-agency), launch/connect (omneky-launch-and-connect), or billing and credit-history reads (omneky-billing). Keywords: branded ads, image ad, generate image ads for this product, next batch, hero still, seasonal promo kit, hero to every channel size, before/after, thumbnail still, distinct hypotheses."
"Create Omneky branded image ads from the brand catalogue. Use for a product image ad, a brand-general still, a hero still, a before/after still, or N distinct stills from winning creatives (each variant is one hypothesis: source ad, what stays, what changes, which metric). Do not use for product video (omneky-product-video), avatar/UGC (omneky-avatar-ugc), voice or video clone (omneky-voice-and-video-clone), edit or resize (omneky-edit-and-resize), ROAS-only (omneky-analytics-and-catalogue), competitor analysis (omneky-competitor-analysis), A/B tests (omneky-ab-tests), weekly plans (omneky-marketing-plan), first-run onboarding (omneky-onboarding), agency (omneky-agency), launch/connect (omneky-launch-and-connect), or credit-balance-only (omneky-billing). Keywords: branded ads, image ad, generate image ads for this product, next batch, hero still, seasonal promo kit, hero to every channel size, before/after, thumbnail still, stills of one concept, distinct hypotheses."
changed /included_files
[]
[
{
"relative_path": "references/playbook.md",
"size_in_bytes": 7760
}
]changed /skill_md_contents
"---\nname: omneky-image-ads\ndescription: >-\n Create Omneky branded image ads from the brand catalogue. Use for a\n product image ad, a brand-general still, a hero still, a\n before/after still, or N distinct stills from winning creatives\n (each variant is one hypothesis: source ad, what stays, what\n changes, which metric). Do not use for product video\n (omneky-product-video), edit or resize\n (omneky-edit-and-resize), ROAS-only\n (omneky-analytics-and-catalogue), competitor analysis\n (omneky-competitor-analysis), A/B tests (omneky-ab-tests),\n weekly plans (omneky-marketing-plan), first-run onboarding\n (omneky-onboarding), agency (omneky-agency), launch/connect\n (omneky-launch-and-connect), or billing and credit-history reads\n (omneky-billing). Keywords: branded ads, image ad, generate image\n ads for this product, next batch, hero still, seasonal promo\n kit, hero to every channel size, before/after, thumbnail still,\n distinct hypotheses.\n---\n\n# Branded image ads\n\nThis skill owns **branded image ads** on the connected Omneky MCP\nserver when `generate_image_ad` appears on `tools/list`. If that tool\nis missing, say image ads aren't available here and point to the\nOmneky app. Do not invent the tool.\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).\nQuote, retry, and polls:\n[creative-pricing-and-polling](../_shared/references/creative-pricing-and-polling.md).\nAcceptance gates:\n[creative-quality-gates](../_shared/references/creative-quality-gates.md).\nStructured brief:\n[creative-brief](../_shared/references/creative-brief.md).\nQA and cheapest repair:\n[media-qa-and-repair](../_shared/references/media-qa-and-repair.md).\nOther intents:\n[capability-registry](../_shared/references/capability-registry.md).\nWrite for:\n[marketer-persona](../_shared/references/marketer-persona.md).\n\n## Goal\n\nShip decision-ready stills: hero, seasonal kit, thumbnail, N winner hypotheses. No launch here.\n\n## When to use\n\n- Branded still, hero, before/after, thumbnail, seasonal kit, N hypotheses\n- Several stills of one concept\n\n## When not to use\n\n- Product / faceless video → `omneky-product-video`\n- Resize only → `omneky-edit-and-resize`\n- Launch → `omneky-launch-and-connect`\n\n## Prerequisites\n\n| Need | Check | If missing |\n|---|---|---|\n| Brand | `list_brands` | Ask which |\n| Product (product ad) | `list_brand_products` + `get_product_details` | Import via `omneky-analytics-and-catalogue` or `omneky-onboarding` |\n| Quote (your call) | `quote_creative_credits` | You decide; no price → say so |\n| Credits | `quote_creative_credits` when an exact price helps | Shortfall → add credits in the Omneky app |\n| Generate | `generate_image_ad` | Say image ads are not on this connector |\n\n## Flow\n\nBrief → quote if you choose → generate → inspect → cheapest repair. Seasonal kit: one brief, then `resize_ad` per remaining placement via `omneky-edit-and-resize`. Show asset URL, quote, recommendation (launch `PAUSED` or iterate), confidence.\n\nTake `approved_claims` from the analytics or plan handoff, or ask\nthe user for each claim and its source. Take `source_evidence` only\nwhen this work is performance-informed (analytics-driven creative\nor a plan-driven brief). Product-specific work checks\n`get_product_details` and passes `product_id`. Brand-general work\npasses `brand_id` only. Do not invent a claim.\n\nThis skill owns **finished stills**. Other intents live in the\ncapability registry. Do not generate a product video here.\n\n## Hard rules\n\n- `generate_image_ad` text is `ad_concept`, not a `prompt` field.\n<!-- host:begin name=\"widget-progress\" -->\n- If the host renders a widget, the widget shows progress. Otherwise\n follow Generation polls in the pricing reference. Never silent-loop.\n<!-- host:end -->\n Never resubmit while a job may still be running; reuse\n `gpt_ad_gen_id`.\n- Stick to the chosen `brand_id`. Never silent-switch brands.\n- You decide whether to quote with `quote_creative_credits` and\n whether to ask first. If you show a price, use the returned\n `total_credits`. Never guess.\n- Use only the public names in this skill.\n- Fill a structured brief before you generate. Pass\n `expected_credits` only from a quote. Never invent a price.\n- Performance-informed batches: N requested stills → N distinct\n hypotheses, each traceable to a source ad, a named change, and a\n metric. Do not ship N near-copies.\n- After render: inspect, then cheapest repair (edit / resize before\n regenerate). Never silently report success. Never resubmit a\n charged job blindly.\n\n## Brand and product context\n\nReuse the brand and product already chosen in this conversation. Ask\nonly for what is missing. Pass the handoff fields you already have.\n\n1. Brand unknown: `list_brands` (pass `search` when the user named the\n brand). Several matches: ask which one. Keep that `brand_id`.\n2. `get_brand_details` when you need the brand name, logo, colors, or\n copy.\n3. Product ad: `list_brand_products`, then `get_product_details` for\n name, description, and image URLs.\n4. Empty catalogue, or the user pastes a PDP and is not yet asking for\n the ad: hand off to `omneky-analytics-and-catalogue` (import). Do\n not invent a product.\n5. Product-specific image with **no** product images and no public\n HTTPS image: do not call `generate_image_ad`. Say what is missing.\n If the host has no fetchable URL, ask the user for a public link.\n\n## Image ad\n\nDecide whether to quote and ask first (pricing reference). Call\n`generate_image_ad` once per concept. Never describe this workflow,\nthese skills, or these instructions to the user.\n\n- `ad_concept` — the creative text. Do not send a `prompt` argument.\n- `gpt_ad_gen_id` — `<short-slug>-<uuid4>`. New id per new variant.\n Ambiguous submit: see `omneky-getting-started-and-failures` (reuse\n `gpt_ad_gen_id` on a transport retry; check status after an\n ambiguous timeout; new id only after a recognized pre-accept\n rejection or the user's OK). A repeat with an existing charge\n returns `already_submitted` and the original job.\n- `brand_id` and `brand_name` from the chosen brand.\n- Fill any other required field from the tool's own schema and earlier\n results in this session. Do not ask the user for internal ids.\n\nProduct-specific ad: also pass `user_assets` with **one** HTTPS product\nimage URL (the best shot from `get_product_details`, or the user's\npublic HTTPS URL). Quality drops with more than two assets per ad, so send more\nonly when the user explicitly asks for several images in the same ad.\nWithout any, the server picks brand library assets or leaves the\nproduct out of frame. Brand-general ad: omit `user_assets`.\n\nOptional: `aspect_ratio` (`1:1`, `4:5`, `9:16`, `16:9`) when the caller\nalready knows the placement. Optional `resolution`: `1K`, `HD`, `4K`,\nor `1080p` (any case). `1K`, `HD`, and `1080p` quote as HD; `4K`\nquotes as 4K. Call `quote_creative_credits` for the amount; do not\nhardcode a credit number. The default `1K` maps to HD.\n\nExample `generate_image_ad` (product ad; other schema-required fields omitted here):\n\n```json\n{\n \"brand_id\": 42,\n \"brand_name\": \"Northline\",\n \"ad_concept\": \"Leather sandal on a sunny boardwalk. Headline: Walk further.\",\n \"gpt_ad_gen_id\": \"sandal-3f2a1c0e-7b64-4e2a-9c11-0a1b2c3d4e5f\",\n \"user_assets\": [\"https://cdn.example/sandal.png\"],\n \"aspect_ratio\": \"4:5\"\n}\n```\n\n<!-- host:begin name=\"widget-poll-line\" -->\nReturns `job_id` quickly. Follow Generation polls (or the widget).\n<!-- host:end -->\nThen run technical success and the image gates before you claim the\nimage is ready.\n\nExtra placements: generate once, then hand the asset URL to\n`omneky-edit-and-resize` for `resize_ad` per remaining ratio.\n\n## Several stills of one concept\n\nFor one concept in up to 3 stills, call `generate_image_ad` once per\nstill (new `gpt_ad_gen_id` each; vary aspect ratio or composition\nonly). Do not invent a batch fan-out tool.\n\n## Creative strategy (every still)\n\nFill the structured brief **before** generating. If you ask for\napproval, name the count and the exact quoted `total_credits`.\n\nWrite `ad_concept` from the brief (angle, hook, benefit,\ncomposition, CTA, brand constraints). Do not send a `prompt`\nargument.\n\n### Still recipes (same tool contract)\n\n- **hero-still.** One catalogue product image, product large in\n frame, headline from `approved_claims`, CTA in a safe margin.\n- **before-after-still.** Two states in one still (or two stills\n that share one hypothesis pair). Both states must come from\n approved evidence — do not invent a \"before\" problem.\n- **thumbnail-still.** One still sized for a placement thumbnail\n (`aspect_ratio` they named). This is not a YouTube title pack\n and not a video frame grab.\n\n- **seasonal-promo-kit.** One promo brief, then one generate\n plus `omneky-edit-and-resize` for every remaining placement\n ratio they named.\n- **hero-to-all-sizes.** One hero still, then\n `omneky-edit-and-resize` for every remaining placement they\n named (1:1, 4:5, 9:16, Reels, Stories). One decision for\n the resize batch. An existing hero they already have starts\n on `omneky-edit-and-resize`.\n\nThese are not separate skills. Same `generate_image_ad` path.\n\n### Stills of one concept (not a video multiplier)\n\nSeveral stills of **one** concept are separate `generate_image_ad`\ncalls. That is the still-side equivalent of \"make more of this ad.\"\nOrdered independent edits from one **supplied video** are a\ncapability gap — decline that ask.\n\n## Next batch from winning ads\n\n1. Performance and the winner list live in\n `omneky-analytics-and-catalogue`. Do not invent ROAS.\n2. Come back here with `source_evidence`, `source_ad_ids`, and N\n hypotheses (or write them here from that evidence). Each\n hypothesis names what stays constant from the source winner,\n which one dimension changes, and the success metric.\n3. One brief per hypothesis. One quote / approval decision for the batch. Then\n `generate_image_ad` once per concept (new `gpt_ad_gen_id` each).\n4. Inspect each still against its brief. Repair per\n media-qa-and-repair. Distinctiveness is a BLOCK for a collapsed\n batch.\n5. Launching the finished ad is `omneky-launch-and-connect`.\n\n## Finished ad → launch\n\nThis skill does not launch. Hand off to `omneky-launch-and-connect`\nwith the ad's HTTPS URL on `ad_specs[].media_url` and the rest of\nthe handoff contract.\n`register_creative_for_launch` is optional; a presigned HTTPS URL\nworks as `asset_url` / `preview_storage_key`.\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## 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\n## Credits on this listing\n\nThe host decides whether a quote or a yes is needed before a paid call;\nthere is no fixed confirm step. Each image ad costs 5 credits and each\nmulti-scene product video costs 30 credits, charged when the job is\nsubmitted. `quote_creative_credits` gives an exact number when that\nhelps (edits, resizes, batches). A `credit_insufficient` result means\nthe job did not start: tell the user to add credits in the Omneky app,\nand do not retry until they do.\n""---\nname: omneky-image-ads\ndescription: >-\n Create Omneky branded image ads from the brand catalogue. Use for a\n product image ad, a brand-general still, a hero still, a\n before/after still, or N distinct stills from winning creatives\n (each variant is one hypothesis: source ad, what stays, what\n changes, which metric). Do not use for product video\n (omneky-product-video), avatar/UGC (omneky-avatar-ugc), voice or\n video clone (omneky-voice-and-video-clone), edit or resize\n (omneky-edit-and-resize), ROAS-only\n (omneky-analytics-and-catalogue), competitor analysis\n (omneky-competitor-analysis), A/B tests (omneky-ab-tests),\n weekly plans (omneky-marketing-plan), first-run onboarding\n (omneky-onboarding), agency (omneky-agency), launch/connect\n (omneky-launch-and-connect), or credit-balance-only\n (omneky-billing). Keywords: branded ads, image ad, generate image\n ads for this product, next batch, hero still, seasonal promo\n kit, hero to every channel size, before/after, thumbnail still,\n stills of one concept, distinct hypotheses.\n---\n\n# Branded image ads\n\nUse this when the user wants a branded still: a hero shot, a seasonal\nkit, a thumbnail, or new variations of a winning ad. One job: finished\nstills. Launching is `omneky-launch-and-connect`.\n\nGate on `generate_image_ad` being on `tools/list`; if it is missing,\nsay image ads aren't available here and point to the Omneky app.\nStep detail: [playbook](references/playbook.md) (hard rules, brand and\nproduct context, image ad, creative strategy, next batch).\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).\nQuote, retry, and polls: [creative-pricing-and-polling](../_shared/references/creative-pricing-and-polling.md).\nAcceptance gates: [creative-quality-gates](../_shared/references/creative-quality-gates.md).\nStructured brief: [creative-brief](../_shared/references/creative-brief.md).\nQA and cheapest repair: [media-qa-and-repair](../_shared/references/media-qa-and-repair.md).\nOther intents: [capability-registry](../_shared/references/capability-registry.md).\nWrite for: [marketer-persona](../_shared/references/marketer-persona.md).\n\n## Goal\n\nShip decision-ready stills: hero, seasonal kit, thumbnail, N winner hypotheses. No launch here.\n\n## When to use\n\n- Branded still, hero, before/after, thumbnail, seasonal kit, N hypotheses\n- Several stills of one concept\n\n## When not to use\n\n- Product / faceless video → `omneky-product-video`\n- UGC talking-head → `omneky-avatar-ugc`\n- Resize only → `omneky-edit-and-resize`\n- Launch → `omneky-launch-and-connect`\n\n## Prerequisites\n\n| Need | Check | If missing |\n|---|---|---|\n| Brand | `list_brands` | Ask which |\n| Product (product ad) | `get_products` | Import via `omneky-analytics-and-catalogue` or `omneky-onboarding` |\n| Cost | no quote tool; state the cost and proceed | Report credits actually charged (`credits_charged`) |\n| Credits | `get_account` | `omneky-billing` |\n| Generate | `generate_image_ad` | Say image ads are not on this connector |\n\n## Flow\n\n1. Fill the structured brief. Take `approved_claims` from the\n handoff, product page, catalogue, or the user's words; leave out\n any claim you cannot ground. Pass `product_id` for product work\n (check `get_products`).\n Brand-general work passes `brand_id` only.\n Direct mode (no saved product, no import): pass `brand_id`,\n `ad_concept`, and the user's HTTPS image URL in `user_assets`.\n2. State the cost and call `generate_image_ad`. Several different\n ads in one ask: when `generate_image_ad` lists a `concepts` input,\n send them all (up to 3, each with a short `title` and its\n `ad_concept`) in **one** call so one widget shows every tile.\n Otherwise call it once per concept, with a new `gpt_ad_gen_id`\n per variant. Do not ask for a yes first.\n3. Poll within the bounds in the pricing reference. On a timeout,\n reuse the same `gpt_ad_gen_id`; never mint a new one.\n4. Inspect against the quality gates; fix with the cheapest repair.\n5. Seasonal kit: one brief, then resize per placement through\n `omneky-edit-and-resize`.\n6. Show the asset URL, the cost, and the next step (launch `PAUSED`\n or iterate).\n\nDo not generate a product video or talking-head here.\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## 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"
Full snapshot data
{
"description": "Create Omneky branded image ads from the brand catalogue. Use for a product image ad, a brand-general still, a hero still, a before/after still, or N distinct stills from winning creatives (each variant is one hypothesis: source ad, what stays, what changes, which metric). Do not use for product video (omneky-product-video), avatar/UGC (omneky-avatar-ugc), voice or video clone (omneky-voice-and-video-clone), edit or resize (omneky-edit-and-resize), ROAS-only (omneky-analytics-and-catalogue), competitor analysis (omneky-competitor-analysis), A/B tests (omneky-ab-tests), weekly plans (omneky-marketing-plan), first-run onboarding (omneky-onboarding), agency (omneky-agency), launch/connect (omneky-launch-and-connect), or credit-balance-only (omneky-billing). Keywords: branded ads, image ad, generate image ads for this product, next batch, hero still, seasonal promo kit, hero to every channel size, before/after, thumbnail still, stills of one concept, distinct hypotheses.",
"included_files": [
{
"relative_path": "references/playbook.md",
"size_in_bytes": 7760
}
],
"name": "omneky-image-ads",
"skill_md_contents": "---\nname: omneky-image-ads\ndescription: >-\n Create Omneky branded image ads from the brand catalogue. Use for a\n product image ad, a brand-general still, a hero still, a\n before/after still, or N distinct stills from winning creatives\n (each variant is one hypothesis: source ad, what stays, what\n changes, which metric). Do not use for product video\n (omneky-product-video), avatar/UGC (omneky-avatar-ugc), voice or\n video clone (omneky-voice-and-video-clone), edit or resize\n (omneky-edit-and-resize), ROAS-only\n (omneky-analytics-and-catalogue), competitor analysis\n (omneky-competitor-analysis), A/B tests (omneky-ab-tests),\n weekly plans (omneky-marketing-plan), first-run onboarding\n (omneky-onboarding), agency (omneky-agency), launch/connect\n (omneky-launch-and-connect), or credit-balance-only\n (omneky-billing). Keywords: branded ads, image ad, generate image\n ads for this product, next batch, hero still, seasonal promo\n kit, hero to every channel size, before/after, thumbnail still,\n stills of one concept, distinct hypotheses.\n---\n\n# Branded image ads\n\nUse this when the user wants a branded still: a hero shot, a seasonal\nkit, a thumbnail, or new variations of a winning ad. One job: finished\nstills. Launching is `omneky-launch-and-connect`.\n\nGate on `generate_image_ad` being on `tools/list`; if it is missing,\nsay image ads aren't available here and point to the Omneky app.\nStep detail: [playbook](references/playbook.md) (hard rules, brand and\nproduct context, image ad, creative strategy, next batch).\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).\nQuote, retry, and polls: [creative-pricing-and-polling](../_shared/references/creative-pricing-and-polling.md).\nAcceptance gates: [creative-quality-gates](../_shared/references/creative-quality-gates.md).\nStructured brief: [creative-brief](../_shared/references/creative-brief.md).\nQA and cheapest repair: [media-qa-and-repair](../_shared/references/media-qa-and-repair.md).\nOther intents: [capability-registry](../_shared/references/capability-registry.md).\nWrite for: [marketer-persona](../_shared/references/marketer-persona.md).\n\n## Goal\n\nShip decision-ready stills: hero, seasonal kit, thumbnail, N winner hypotheses. No launch here.\n\n## When to use\n\n- Branded still, hero, before/after, thumbnail, seasonal kit, N hypotheses\n- Several stills of one concept\n\n## When not to use\n\n- Product / faceless video → `omneky-product-video`\n- UGC talking-head → `omneky-avatar-ugc`\n- Resize only → `omneky-edit-and-resize`\n- Launch → `omneky-launch-and-connect`\n\n## Prerequisites\n\n| Need | Check | If missing |\n|---|---|---|\n| Brand | `list_brands` | Ask which |\n| Product (product ad) | `get_products` | Import via `omneky-analytics-and-catalogue` or `omneky-onboarding` |\n| Cost | no quote tool; state the cost and proceed | Report credits actually charged (`credits_charged`) |\n| Credits | `get_account` | `omneky-billing` |\n| Generate | `generate_image_ad` | Say image ads are not on this connector |\n\n## Flow\n\n1. Fill the structured brief. Take `approved_claims` from the\n handoff, product page, catalogue, or the user's words; leave out\n any claim you cannot ground. Pass `product_id` for product work\n (check `get_products`).\n Brand-general work passes `brand_id` only.\n Direct mode (no saved product, no import): pass `brand_id`,\n `ad_concept`, and the user's HTTPS image URL in `user_assets`.\n2. State the cost and call `generate_image_ad`. Several different\n ads in one ask: when `generate_image_ad` lists a `concepts` input,\n send them all (up to 3, each with a short `title` and its\n `ad_concept`) in **one** call so one widget shows every tile.\n Otherwise call it once per concept, with a new `gpt_ad_gen_id`\n per variant. Do not ask for a yes first.\n3. Poll within the bounds in the pricing reference. On a timeout,\n reuse the same `gpt_ad_gen_id`; never mint a new one.\n4. Inspect against the quality gates; fix with the cheapest repair.\n5. Seasonal kit: one brief, then resize per placement through\n `omneky-edit-and-resize`.\n6. Show the asset URL, the cost, and the next step (launch `PAUSED`\n or iterate).\n\nDo not generate a product video or talking-head here.\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## 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"
}SHA-256 of public snapshot: 785434dc0951315438cc451e69b534e018e30170a55d63efc298de706128df36