{"id":59859,"plugin_id":"plugin_asdk_app_6aa944d20a3081919d9f65692616ff4d","kind":"skill","collection_source":"plugin_package","comparison_source":"plugin_package","observed_at":"2026-10-27T00:28:52.568Z","digest":"0c76d4118fff1d28f3bd13b7d466d8512ee156f2e92c073e7f2a7f23450b5b4c","against":43813,"payload":{"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"},"changes":[{"path":"/description","type":"changed","before":"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.","after":"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."},{"path":"/included_files","type":"changed","before":[],"after":[{"relative_path":"references/playbook.md","size_in_bytes":2446}]},{"path":"/skill_md_contents","type":"changed","before":"---\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","after":"---\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"}],"summary":"Fields changed: 3. /description, /included_files, /skill_md_contents.","summary_kind":"deterministic","summary_metadata":{}}