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: analyze_brand, or a scraped PDP. Every claim must cite its evidence source. Do not use for ROAS / winning-ads tables (omneky-analytics-and-catalogue), A/B...
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
GSC, analyze_brand, or a scraped PDP. Every claim must cite its evidence source. Do not use for ROAS / winning-ads tables (omneky-analytics-and-catalogue), A/B tests (omneky-ab-tests), first-run onboarding (omneky-onboarding), agency (om...
Oct 27, 2026 · 00:28 UTC
analyze_brand, or a scraped PDP. Every claim must cite its evidence source. Do not use for ROAS / winning-ads tables (omneky-analytics-and-catalogue), A/B tests (omneky-ab-tests), first-run onboarding (omneky-onboarding), agency (omneky-...
Skill instructions
Oct 24, 2026 · 13:12 UTC
Ahrefs, GSC, messaging angles, messaging gaps, competitive brief, GSC queries, keyword gaps, domain rating, backlinks, Semrush Use the connected Omneky MCP server. Gate every named tool on this session's `tools/list`. If the tool for...
Oct 27, 2026 · 00:28 UTC
Ahrefs, messaging angles, messaging gaps, competitive brief, keyword gaps, domain rating, backlinks, Semrush Use this when the user asks how competitors position themselves, which angles to test, or where keyword and backlink gaps ar...
Supporting files
Oct 24, 2026 · 13:12 UTC
[]
Oct 27, 2026 · 00:28 UTC
[{"relative_path":"references/playbook.md","size_in_bytes":2446}]
Compare saved observations
Download comparison JSONSKILL.md text changes
− removed · + added
--- before +++ after @@ -3,7 +3,7 @@ description: >- Analyze competitors and brand positioning with Omneky. Use for competitor analysis, positioning, messaging angles, messaging - gaps, or a competitive brief that cites Semrush, Ahrefs, GSC, + gaps, or a competitive brief that cites Semrush, Ahrefs, analyze_brand, or a scraped PDP. Every claim must cite its evidence source. Do not use for ROAS / winning-ads tables (omneky-analytics-and-catalogue), A/B tests (omneky-ab-tests), @@ -12,36 +12,28 @@ (omneky-marketing-plan), generating creatives, launch/connect (omneky-launch-and-connect), or credit balance (omneky-billing). Keywords: competitor analysis, positioning, - messaging angles, messaging gaps, competitive brief, GSC - queries, keyword gaps, domain rating, backlinks, Semrush + messaging angles, messaging gaps, competitive brief, + keyword gaps, domain rating, backlinks, Semrush competitor, Ahrefs competitor. --- # Competitor analysis -Use the connected Omneky MCP server. Gate every named tool on this -session's `tools/list`. If the tool for a requested step is missing, -say so and point to the Omneky app. Do not invent a tool or offer -another app or connector. - -This skill owns **positioning, messaging angles, and gaps** that -feed a later creative brief. Paid-media ROAS tables stay in -`omneky-analytics-and-catalogue`. Weekly plans stay in -`omneky-marketing-plan`. - -Handoff fields: -[handoff-contract](../_shared/references/handoff-contract.md). -Sourced ids: -[preconditions](../_shared/references/preconditions.md). +Use this when the user asks how competitors position themselves, +which angles to test, or where keyword and backlink gaps are. One +job: cited positioning, angles, and gaps that feed a creative brief. +ROAS tables stay in `omneky-analytics-and-catalogue`. + +Gate every tool on `tools/list`; a missing tool → the Omneky app. +Step detail: [playbook](references/playbook.md) (hard rules, path). + +Handoff fields: [handoff-contract](../_shared/references/handoff-contract.md). +Sourced ids: [preconditions](../_shared/references/preconditions.md). <!-- host:begin name="scan-tools-routing" --> -Acceptance gates (for a later creative): -[creative-quality-gates](../_shared/references/creative-quality-gates.md). -Structured brief (output of this skill): -[creative-brief](../_shared/references/creative-brief.md). -Other intents: -[capability-registry](../_shared/references/capability-registry.md). -Write for: -[marketer-persona](../_shared/references/marketer-persona.md). +Acceptance gates (for a later creative): [creative-quality-gates](../_shared/references/creative-quality-gates.md). +Structured brief (output of this skill): [creative-brief](../_shared/references/creative-brief.md). +Other intents: [capability-registry](../_shared/references/capability-registry.md). +Write for: [marketer-persona](../_shared/references/marketer-persona.md). <!-- host:end --> ## Goal @@ -50,7 +42,7 @@ ## When to use -- Competitor analysis, positioning, messaging gaps, GSC top queries as ad angles, Semrush/Ahrefs keyword gaps, domain rating / backlinks +- Competitor analysis, positioning, messaging gaps, Semrush/Ahrefs keyword gaps, domain rating / backlinks ## When not to use @@ -63,97 +55,36 @@ |---|---|---| | Brand | `list_brands` | Ask which | | Analysis | `analyze_brand` | Call it | -| Semrush | `get_semrush_connection_status` | Skip Semrush | -| Ahrefs | `ahrefs_connection_status` | Skip Ahrefs | -| GSC | `get_gsc_connection_status` | Skip GSC | -| PDP copy | `identify_product_from_url` | Ask for one product URL | +| Semrush | `list_connections` (`connector="semrush"`) | Skip Semrush | +| Ahrefs | `list_connections` (`connector="ahrefs"`) | Skip Ahrefs | +| PDP copy | `import_product_from_url` (`url`) | Ask for one product URL | ## Flow -Status-gate each connector. Cite every claim. Lead with the -angles worth testing, then the gaps, then confidence per -source. Skip a disconnected source; do not ask them to reconnect -unless they want that source. - -## Hard rules - -- Stick to the chosen `brand_id`. Never silent-switch brands. -- Every claim cites `source` (tool name + entity + date or window). - No source → do not write the claim. -- Gate Semrush / Ahrefs / GSC on that connector's status tool. - Disconnected → skip that source and say so. Do not invent ranks - or keywords. -- Reads need no approval. This skill does not generate or launch. -- Do not ask the user for internal ids. - -## Path - -1. Reuse the chosen `brand_id`. Unknown: `list_brands` (pass - `search` when they named it). Several matches: ask which one. -2. `get_brand_details` when you need the brand site, name, or copy. -3. `analyze_brand` with `brand_id` (optional `website_url`, optional - `product_id`). Draft only — no plan steps. Cite it as - `analyze_brand`. -4. Own-site organic (each gated on status): - - Semrush: `get_semrush_connection_status`, then - `get_semrush_domain_overview` (`domain`) and/or - `get_semrush_keyword_overview` (`keyword`). - - Ahrefs: `ahrefs_connection_status`, then `ahrefs_domain_rating` - (`target`), `ahrefs_organic_keywords` (default `limit` 10; - refuse `limit` greater than 50), `ahrefs_backlinks_stats` - (overview only). - - Search Console: `get_gsc_connection_status`, `gsc_list_sites`, - then `gsc_query_analytics` (`site_url`, `start_date`, - `end_date`). -5. Competitor or own PDP they pasted: `identify_product_from_url` - first. Listing/category → do not scrape; ask for one product - URL. Then `scrape_product_from_url` when they want page copy - cited. Finalize only if they asked to save the product - (`omneky-analytics-and-catalogue`). -6. Write the brief feed. Each line is `{claim, source}`. Group as: - - Positioning (who they are vs the cited competitor set) - - Messaging angles (hooks / benefits that appear in the sources) - - Gaps (what the sources do not support — say "not in sources", - never invent a gap stat) - -### gsc-queries-to-ad-angles - -`get_gsc_connection_status` → `gsc_list_sites` → -`gsc_query_analytics`. Each query becomes an angle only when -the row exists. Cite the query + dates. - -### keyword-gaps - -Semrush `get_semrush_keyword_overview` / domain overview and -Ahrefs `ahrefs_organic_keywords` (limit ≤ 50). A gap is "in -their list, not in ours" only when both sides were fetched. -Otherwise say which side is missing. - -### domain-rating-backlinks - -`ahrefs_domain_rating` + `ahrefs_backlinks_stats` (overview -only). Not a full export. Not Meta Ad Library ads (gap). - -<!-- host:begin name="competitor-creative-handoff" --> -Hand `approved_claims` and those angles to `omneky-image-ads` or -`omneky-product-video` when they ask to -make the ad. Do not generate here. -<!-- host:end --> +1. Check each source's connection status (Semrush, Ahrefs, + HubSpot). Skip a disconnected source. +2. Pull both sides of every comparison before stating a gap. +3. Cite every claim with its source. +4. Lead with the angles worth testing, then the gaps, then confidence + per source. Hand the brief to the creative skill. ## 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 · 3 changed fields
changed /description
"Analyze competitors and brand positioning with Omneky. Use for competitor analysis, positioning, messaging angles, messaging gaps, or a competitive brief that cites Semrush, Ahrefs, GSC, analyze_brand, or a scraped PDP. Every claim must cite its evidence source. Do not use for ROAS / winning-ads tables (omneky-analytics-and-catalogue), A/B tests (omneky-ab-tests), first-run onboarding (omneky-onboarding), agency (omneky-agency), weekly marketing plans (omneky-marketing-plan), generating creatives, launch/connect (omneky-launch-and-connect), or credit balance (omneky-billing). Keywords: competitor analysis, positioning, messaging angles, messaging gaps, competitive brief, GSC queries, keyword gaps, domain rating, backlinks, Semrush competitor, Ahrefs competitor."
"Analyze competitors and brand positioning with Omneky. Use for competitor analysis, positioning, messaging angles, messaging gaps, or a competitive brief that cites Semrush, Ahrefs, analyze_brand, or a scraped PDP. Every claim must cite its evidence source. Do not use for ROAS / winning-ads tables (omneky-analytics-and-catalogue), A/B tests (omneky-ab-tests), first-run onboarding (omneky-onboarding), agency (omneky-agency), weekly marketing plans (omneky-marketing-plan), generating creatives, launch/connect (omneky-launch-and-connect), or credit balance (omneky-billing). Keywords: competitor analysis, positioning, messaging angles, messaging gaps, competitive brief, keyword gaps, domain rating, backlinks, Semrush competitor, Ahrefs competitor."
changed /included_files
[]
[
{
"relative_path": "references/playbook.md",
"size_in_bytes": 2446
}
]changed /skill_md_contents
"---\nname: omneky-competitor-analysis\ndescription: >-\n Analyze competitors and brand positioning with Omneky. Use for\n competitor analysis, positioning, messaging angles, messaging\n gaps, or a competitive brief that cites Semrush, Ahrefs, GSC,\n analyze_brand, or a scraped PDP. Every claim must cite its\n evidence source. Do not use for ROAS / winning-ads tables\n (omneky-analytics-and-catalogue), A/B tests (omneky-ab-tests),\n first-run onboarding (omneky-onboarding), agency\n (omneky-agency), weekly marketing plans\n (omneky-marketing-plan), generating creatives,\n launch/connect (omneky-launch-and-connect), or credit balance\n (omneky-billing). Keywords: competitor analysis, positioning,\n messaging angles, messaging gaps, competitive brief, GSC\n queries, keyword gaps, domain rating, backlinks, Semrush\n competitor, Ahrefs competitor.\n---\n\n# Competitor analysis\n\nUse the connected Omneky MCP server. Gate every named tool on this\nsession's `tools/list`. If the tool for a requested step is missing,\nsay so and point to the Omneky app. Do not invent a tool or offer\nanother app or connector.\n\nThis skill owns **positioning, messaging angles, and gaps** that\nfeed a later creative brief. Paid-media ROAS tables stay in\n`omneky-analytics-and-catalogue`. Weekly plans stay in\n`omneky-marketing-plan`.\n\nHandoff fields:\n[handoff-contract](../_shared/references/handoff-contract.md).\nSourced ids:\n[preconditions](../_shared/references/preconditions.md).\n<!-- host:begin name=\"scan-tools-routing\" -->\nAcceptance gates (for a later creative):\n[creative-quality-gates](../_shared/references/creative-quality-gates.md).\nStructured brief (output of this skill):\n[creative-brief](../_shared/references/creative-brief.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\nCite positioning, keyword/query gaps, and domain-rating/backlink checks that feed a creative brief.\n\n## When to use\n\n- Competitor analysis, positioning, messaging gaps, GSC top queries as ad angles, Semrush/Ahrefs keyword gaps, domain rating / backlinks\n\n## When not to use\n\n- Paid ROAS tables → `omneky-analytics-and-catalogue`\n- Meta Ad Library competitor ads → decline (gap)\n\n## Prerequisites\n\n| Need | Check | If missing |\n|---|---|---|\n| Brand | `list_brands` | Ask which |\n| Analysis | `analyze_brand` | Call it |\n| Semrush | `get_semrush_connection_status` | Skip Semrush |\n| Ahrefs | `ahrefs_connection_status` | Skip Ahrefs |\n| GSC | `get_gsc_connection_status` | Skip GSC |\n| PDP copy | `identify_product_from_url` | Ask for one product URL |\n\n## Flow\n\nStatus-gate each connector. Cite every claim. Lead with the\nangles worth testing, then the gaps, then confidence per\nsource. Skip a disconnected source; do not ask them to reconnect\nunless they want that source.\n\n## Hard rules\n\n- Stick to the chosen `brand_id`. Never silent-switch brands.\n- Every claim cites `source` (tool name + entity + date or window).\n No source → do not write the claim.\n- Gate Semrush / Ahrefs / GSC on that connector's status tool.\n Disconnected → skip that source and say so. Do not invent ranks\n or keywords.\n- Reads need no approval. This skill does not generate or launch.\n- Do not ask the user for internal ids.\n\n## Path\n\n1. Reuse the chosen `brand_id`. Unknown: `list_brands` (pass\n `search` when they named it). Several matches: ask which one.\n2. `get_brand_details` when you need the brand site, name, or copy.\n3. `analyze_brand` with `brand_id` (optional `website_url`, optional\n `product_id`). Draft only — no plan steps. Cite it as\n `analyze_brand`.\n4. Own-site organic (each gated on status):\n - Semrush: `get_semrush_connection_status`, then\n `get_semrush_domain_overview` (`domain`) and/or\n `get_semrush_keyword_overview` (`keyword`).\n - Ahrefs: `ahrefs_connection_status`, then `ahrefs_domain_rating`\n (`target`), `ahrefs_organic_keywords` (default `limit` 10;\n refuse `limit` greater than 50), `ahrefs_backlinks_stats`\n (overview only).\n - Search Console: `get_gsc_connection_status`, `gsc_list_sites`,\n then `gsc_query_analytics` (`site_url`, `start_date`,\n `end_date`).\n5. Competitor or own PDP they pasted: `identify_product_from_url`\n first. Listing/category → do not scrape; ask for one product\n URL. Then `scrape_product_from_url` when they want page copy\n cited. Finalize only if they asked to save the product\n (`omneky-analytics-and-catalogue`).\n6. Write the brief feed. Each line is `{claim, source}`. Group as:\n - Positioning (who they are vs the cited competitor set)\n - Messaging angles (hooks / benefits that appear in the sources)\n - Gaps (what the sources do not support — say \"not in sources\",\n never invent a gap stat)\n\n### gsc-queries-to-ad-angles\n\n`get_gsc_connection_status` → `gsc_list_sites` →\n`gsc_query_analytics`. Each query becomes an angle only when\nthe row exists. Cite the query + dates.\n\n### keyword-gaps\n\nSemrush `get_semrush_keyword_overview` / domain overview and\nAhrefs `ahrefs_organic_keywords` (limit ≤ 50). A gap is \"in\ntheir list, not in ours\" only when both sides were fetched.\nOtherwise say which side is missing.\n\n### domain-rating-backlinks\n\n`ahrefs_domain_rating` + `ahrefs_backlinks_stats` (overview\nonly). Not a full export. Not Meta Ad Library ads (gap).\n\n<!-- host:begin name=\"competitor-creative-handoff\" -->\nHand `approved_claims` and those angles to `omneky-image-ads` or\n`omneky-product-video` when they ask to\nmake the ad. Do not generate here.\n<!-- host:end -->\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-competitor-analysis\ndescription: >-\n Analyze competitors and brand positioning with Omneky. Use for\n competitor analysis, positioning, messaging angles, messaging\n gaps, or a competitive brief that cites Semrush, Ahrefs,\n analyze_brand, or a scraped PDP. Every claim must cite its\n evidence source. Do not use for ROAS / winning-ads tables\n (omneky-analytics-and-catalogue), A/B tests (omneky-ab-tests),\n first-run onboarding (omneky-onboarding), agency\n (omneky-agency), weekly marketing plans\n (omneky-marketing-plan), generating creatives,\n launch/connect (omneky-launch-and-connect), or credit balance\n (omneky-billing). Keywords: competitor analysis, positioning,\n messaging angles, messaging gaps, competitive brief,\n keyword gaps, domain rating, backlinks, Semrush\n competitor, Ahrefs competitor.\n---\n\n# Competitor analysis\n\nUse this when the user asks how competitors position themselves,\nwhich angles to test, or where keyword and backlink gaps are. One\njob: cited positioning, angles, and gaps that feed a creative brief.\nROAS tables stay in `omneky-analytics-and-catalogue`.\n\nGate every tool on `tools/list`; a missing tool → the Omneky app.\nStep detail: [playbook](references/playbook.md) (hard rules, path).\n\nHandoff fields: [handoff-contract](../_shared/references/handoff-contract.md).\nSourced ids: [preconditions](../_shared/references/preconditions.md).\n<!-- host:begin name=\"scan-tools-routing\" -->\nAcceptance gates (for a later creative): [creative-quality-gates](../_shared/references/creative-quality-gates.md).\nStructured brief (output of this skill): [creative-brief](../_shared/references/creative-brief.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\nCite positioning, keyword/query gaps, and domain-rating/backlink checks that feed a creative brief.\n\n## When to use\n\n- Competitor analysis, positioning, messaging gaps, Semrush/Ahrefs keyword gaps, domain rating / backlinks\n\n## When not to use\n\n- Paid ROAS tables → `omneky-analytics-and-catalogue`\n- Meta Ad Library competitor ads → decline (gap)\n\n## Prerequisites\n\n| Need | Check | If missing |\n|---|---|---|\n| Brand | `list_brands` | Ask which |\n| Analysis | `analyze_brand` | Call it |\n| Semrush | `list_connections` (`connector=\"semrush\"`) | Skip Semrush |\n| Ahrefs | `list_connections` (`connector=\"ahrefs\"`) | Skip Ahrefs |\n| PDP copy | `import_product_from_url` (`url`) | Ask for one product URL |\n\n## Flow\n\n1. Check each source's connection status (Semrush, Ahrefs,\n HubSpot). Skip a disconnected source.\n2. Pull both sides of every comparison before stating a gap.\n3. Cite every claim with its source.\n4. Lead with the angles worth testing, then the gaps, then confidence\n per source. Hand the brief to the creative skill.\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": "Analyze competitors and brand positioning with Omneky. Use for competitor analysis, positioning, messaging angles, messaging gaps, or a competitive brief that cites Semrush, Ahrefs, analyze_brand, or a scraped PDP. Every claim must cite its evidence source. Do not use for ROAS / winning-ads tables (omneky-analytics-and-catalogue), A/B tests (omneky-ab-tests), first-run onboarding (omneky-onboarding), agency (omneky-agency), weekly marketing plans (omneky-marketing-plan), generating creatives, launch/connect (omneky-launch-and-connect), or credit balance (omneky-billing). Keywords: competitor analysis, positioning, messaging angles, messaging gaps, competitive brief, keyword gaps, domain rating, backlinks, Semrush competitor, Ahrefs competitor.",
"included_files": [
{
"relative_path": "references/playbook.md",
"size_in_bytes": 2446
}
],
"name": "omneky-competitor-analysis",
"skill_md_contents": "---\nname: omneky-competitor-analysis\ndescription: >-\n Analyze competitors and brand positioning with Omneky. Use for\n competitor analysis, positioning, messaging angles, messaging\n gaps, or a competitive brief that cites Semrush, Ahrefs,\n analyze_brand, or a scraped PDP. Every claim must cite its\n evidence source. Do not use for ROAS / winning-ads tables\n (omneky-analytics-and-catalogue), A/B tests (omneky-ab-tests),\n first-run onboarding (omneky-onboarding), agency\n (omneky-agency), weekly marketing plans\n (omneky-marketing-plan), generating creatives,\n launch/connect (omneky-launch-and-connect), or credit balance\n (omneky-billing). Keywords: competitor analysis, positioning,\n messaging angles, messaging gaps, competitive brief,\n keyword gaps, domain rating, backlinks, Semrush\n competitor, Ahrefs competitor.\n---\n\n# Competitor analysis\n\nUse this when the user asks how competitors position themselves,\nwhich angles to test, or where keyword and backlink gaps are. One\njob: cited positioning, angles, and gaps that feed a creative brief.\nROAS tables stay in `omneky-analytics-and-catalogue`.\n\nGate every tool on `tools/list`; a missing tool → the Omneky app.\nStep detail: [playbook](references/playbook.md) (hard rules, path).\n\nHandoff fields: [handoff-contract](../_shared/references/handoff-contract.md).\nSourced ids: [preconditions](../_shared/references/preconditions.md).\n<!-- host:begin name=\"scan-tools-routing\" -->\nAcceptance gates (for a later creative): [creative-quality-gates](../_shared/references/creative-quality-gates.md).\nStructured brief (output of this skill): [creative-brief](../_shared/references/creative-brief.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\nCite positioning, keyword/query gaps, and domain-rating/backlink checks that feed a creative brief.\n\n## When to use\n\n- Competitor analysis, positioning, messaging gaps, Semrush/Ahrefs keyword gaps, domain rating / backlinks\n\n## When not to use\n\n- Paid ROAS tables → `omneky-analytics-and-catalogue`\n- Meta Ad Library competitor ads → decline (gap)\n\n## Prerequisites\n\n| Need | Check | If missing |\n|---|---|---|\n| Brand | `list_brands` | Ask which |\n| Analysis | `analyze_brand` | Call it |\n| Semrush | `list_connections` (`connector=\"semrush\"`) | Skip Semrush |\n| Ahrefs | `list_connections` (`connector=\"ahrefs\"`) | Skip Ahrefs |\n| PDP copy | `import_product_from_url` (`url`) | Ask for one product URL |\n\n## Flow\n\n1. Check each source's connection status (Semrush, Ahrefs,\n HubSpot). Skip a disconnected source.\n2. Pull both sides of every comparison before stating a gap.\n3. Cite every claim with its source.\n4. Lead with the angles worth testing, then the gaps, then confidence\n per source. Hand the brief to the creative skill.\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: 0c76d4118fff1d28f3bd13b7d466d8512ee156f2e92c073e7f2a7f23450b5b4c