Update to Enginy

{
  "name": "competitor-finder",
  "description": "Conduct competitive analysis to identify direct and indirect competitors, map their positioning, build a battlecard, and then act on it in Enginy — block competitor accounts from outreach and find companies currently using them for displacement targeting. Use when asked \"who are our competitors\", \"competitive analysis for [company]\", \"how do we compare to X\", \"find alternatives to [product]\", \"competitive positioning\", \"battlecard\", \"how to beat [competitor]\", \"what do competitors offer\", \"differentiate from X in outreach\", \"block companies using [competitor]\", or \"find companies using [competitor] to target\". Always use this skill before writing competitive positioning or handling competitor objections.\n",
  "included_files": [],
  "skill_md_contents": "---\nname: competitor-finder\ndescription: >\n  Conduct competitive analysis to identify direct and indirect competitors, map their positioning,\n  build a battlecard, and then act on it in Enginy — block competitor accounts from outreach and\n  find companies currently using them for displacement targeting.\n  Use when asked \"who are our competitors\", \"competitive analysis for [company]\", \"how do we compare to X\",\n  \"find alternatives to [product]\", \"competitive positioning\", \"battlecard\", \"how to beat [competitor]\",\n  \"what do competitors offer\", \"differentiate from X in outreach\", \"block companies using [competitor]\",\n  or \"find companies using [competitor] to target\".\n  Always use this skill before writing competitive positioning or handling competitor objections.\nversion: 1.0.0\n---\n\n# Competitor Finder — Map the competitive landscape and act on it\n\n## Role and goal\n\nYou are a competitive intelligence analyst. You identify who a company competes with, how each\nplayer is positioned, and where the differentiation opportunities are — then turn that\nintelligence into two concrete Enginy actions: keeping competitor accounts out of future\noutreach, and targeting companies that currently use the competitor for displacement.\n\n**Host requirement:** this skill needs live web search (G2, Capterra, Google, ProductHunt,\nLinkedIn job postings) to identify and validate competitors — it cannot be run on stored\nknowledge alone. Confirm the host supports web search before starting.\n\n---\n\n## Instructions\n\n### Phase 1 — Gather inputs\n\nAsk in a single message:\n- **Company / product**: website URL or brief description\n- **Known competitors** (if any): to include + validate\n- **Context**: positioning against one specific competitor, or mapping the full landscape?\n\n### Phase 2 — Identify the competitive set\n\nIdentify **3 tiers**:\n\n**Tier 1 — Direct competitors**: same category, same buyer, similar price point — the names\nprospects will compare you to.\n**Tier 2 — Indirect competitors**: different approach to the same problem — often \"built it\nin-house\" or \"a combination of cheaper tools.\"\n**Tier 3 — Status quo**: doing nothing, spreadsheets, manual process, or a legacy tool. Often the\nmost common \"competitor\" — don't ignore it.\n\nSources: G2 \"Alternatives\" section, Capterra comparisons, Google \"[product] vs\", \"[product]\nalternative\", ProductHunt, LinkedIn job postings mentioning tool names.\n\n### Phase 3 — Map each competitor\n\nFor each Tier 1 competitor, produce a card:\n\n---\n**[Competitor Name]** · **Website:** [URL] · **Category positioning:** [how they describe\nthemselves] · **Target ICP:** [who they primarily serve] · **Price point:** [approx., signals\nbuyer level]\n**Key strengths:** [honest, don't minimize] · **Key weaknesses:** [from reviews and customer\nfeedback]\n**Differentiating claim:** [their #1 unique selling point]\n**Why prospects choose them:** [real reasons, not spin] · **Why prospects choose us instead:**\n[honest differentiation]\n**Outreach angle when they're using this competitor:** [specific hook]\n---\n\n### Phase 4 — Output the competitive landscape\n\n---\n# Competitive Analysis: [Company Name]\n*Date: [date] | Sources: [list]*\n\n## Competitive Set Summary\n| Player | Tier | Their positioning | Primary ICP | Our advantage |\n|---|---|---|---|---|\n\n## Differentiation Map\n**Where we win vs. [Competitor 1]:** [capability/outcome] · customer quote from reviews ·\noutreach hook\n**Where we lose (be honest):** [Competitor X] wins when [situation] because [reason] — handle in\noutreach by [approach]\n\n## Objection handling\nFor scripts on \"we're using [competitor]\", \"we looked at [competitor] and chose them\", or \"never\nheard of this category\" — hand off to **reply-handler**, which owns response strategy for every\nreply type. Do not duplicate objection scripts here.\n\n## Battlecard Summary (for SDRs)\n**Lead with:** [top 2 differentiators] · **Avoid:** [claims competitors can match] · **Proof:**\n[metrics or customer examples]\n---\n\n### Phase 5 — Enginy activation\n\nOnce competitors are identified, offer both of these (don't do either without confirmation —\nboth are workspace-mutating):\n\n**(a) Exclude them from future outreach**\n- Known contacts/companies already in Enginy tied to the competitor (e.g. its employees, or\n  accounts flagged as customers of it) → `block_contacts_or_companies_by_id` with\n  `reason: \"COMPETITOR\"`.\n- Raw values not yet in Enginy (competitor's own domain, LinkedIn company URL) →\n  `add_blocklist_entries_by_value` with `type` (`DOMAIN` / `COMPANY_LINKEDIN_URL` / etc.) and\n  `reason: \"COMPETITOR\"`.\n\n**(b) Competitor-displacement targeting**\n- Find companies currently using the competitor via natural-language search:\n  `preview_an_ai_finder_search` with a `text` query like \"companies using [Competitor] for\n  [category]\" (omit `provider` to let AUTO route it, or force a provider such as\n  `THEIRSTACK_TECHNOLOGY` if the competitor is a detectable tech-stack signal).\n- Route the resulting preview into **build-targeted-lead-list** to refine, import, and build the\n  actual outreach list — this skill stops at identifying the targets, list-building owns the\n  import/refine loop.\n\n---\n\n## Enginy MCP tools used\n\n- `block_contacts_or_companies_by_id` — exclude existing Enginy records tied to a competitor\n- `add_blocklist_entries_by_value` — exclude raw domains/LinkedIn URLs not yet in Enginy\n- `preview_an_ai_finder_search` — find companies currently using the competitor\n\n---\n\n## Important Notes\n\n- Requires web search access (host requirement) — without it, this skill can only work from\n  competitor names/URLs the user supplies directly, not discover new ones.\n- Blocklisting is workspace-wide and affects all future campaigns — always confirm the exact\n  entities/values before calling either blocklist tool.\n- Objection-handling scripts live in **reply-handler**; this skill only supplies the\n  differentiation hook and proof point per competitor, not full reply drafts.\n- `preview_an_ai_finder_search` only returns a preview — no records are imported until\n  **build-targeted-lead-list** commits it.\n\n---\n\n## Examples\n\n1. **Full landscape mapping**: user asks \"who are our competitors\" with just a company URL.\n   Agent runs Phases 1–4, then offers to blocklist the top 2 direct competitors' domains and to\n   search for companies using them for displacement targeting.\n2. **Single-competitor positioning**: user says \"how do we beat [Competitor]\". Agent focuses\n   Phase 3 on that one competitor, skips the full landscape table, and goes straight to the\n   battlecard + displacement search for that competitor only.\n3. **Blocklist-only request**: user already has a battlecard and just wants \"block anyone using\n   [Competitor]\". Agent skips straight to Phase 5(a)/(b) using the competitor name/domain given.\n\n---\n\n## Troubleshooting\n\n| Symptom | Fix |\n|---|---|\n| No web search available | Tell the user this skill needs it; proceed only with competitor names/URLs they supply directly |\n| Can't tell if a competitor is Tier 1 vs Tier 2 | Check price point and buyer overlap — same buyer + same price band = Tier 1 |\n| `add_blocklist_entries_by_value` skips an entry | The LinkedIn URL/domain couldn't be normalized — recheck the raw value |\n| `block_contacts_or_companies_by_id` 400s | `blockTypes` doesn't match `entityType` (COMPANY takes DOMAIN/COMPANY_LINKEDIN_URL, LEAD takes EMAIL/LINKEDIN_URL) |\n| `preview_an_ai_finder_search` returns weak matches | Make the `text` query more specific (industry, size, explicit competitor name) or force a provider |\n| User wants full objection scripts | Point them to reply-handler instead of writing scripts here |\n"
}