Update to vidIQ

{
  "description": "Find and manage the competitor channels tracked in vidIQ for an authorized YouTube channel, adding or removing channels only after explicit approval. Use when asked 'who are my competitors', 'youtube competitor analysis', 'find channels like mine', 'channels similar to [channel]', or 'clean up my competitor list'.",
  "included_files": [
    {
      "relative_path": "agents/openai.yaml",
      "size_in_bytes": 454
    },
    {
      "relative_path": "references/discovery-evidence.md",
      "size_in_bytes": 1213
    },
    {
      "relative_path": "references/live-surface-notes.md",
      "size_in_bytes": 2014
    }
  ],
  "name": "vidiq-competitor-watchlist",
  "skill_md_contents": "---\nname: vidiq-competitor-watchlist\ndescription: Find and manage the competitor channels tracked in vidIQ for an authorized YouTube channel, adding or removing channels only after explicit approval. Use when asked 'who are my competitors', 'youtube competitor analysis', 'find channels like mine', 'channels similar to [channel]', or 'clean up my competitor list'.\n---\n\n# vidIQ Competitor Watchlist\n\nRead [Live surface notes](references/live-surface-notes.md) first, even when using only supplied evidence.\n\nAudit or update a watchlist for the intended authorized channel. Research only what the request\nneeds; a recommendation never authorizes a mutation. Only this skill changes the saved watchlist.\n\n## Establish the list and candidate fit\n\n1. Resolve the intended owner with `vidiq_user_channels`, then\n   capture `vidiq_list_competitors` for its `youtubeChannelId` as the original canonical-ID set.\n   Enrich titles with `vidiq_get_channels_by_ids` only when useful.\n2. Exclude self, known siblings, and unrelated channels from analysis, but present removals as\n   recommendations. Unknown ownership/fit is not an automatic removal reason; preserve\n   intentional references.\n3. For discovery, `vidiq_similar_channels` takes canonical `channelId` with optional `size` and\n   `sort`, or manual `niche` with its declared filters. Do not mix modes or pass `subNiches`.\n   Reuse known IDs; resolve manual context through `vidiq_channel_search` only when needed,\n   matching the returned canonical ID. Country/format can influence ranking rather than strict\n   eligibility, so check actual fit.\n4. Use generic niche `vidiq_channel_search` for broader discovery and `breakoutChannel: true`\n   for emerging challengers (`vidiq_breakout_channels` is a deprecated alias of that search). Set `subscriberCountMin` only for a requested or justified cohort\n   boundary. Disclose it; tiny or nonpositive baselines make growth ratios unreliable.\n5. Read [Discovery evidence](references/discovery-evidence.md) for candidate discovery or\n   audience/mechanism pattern claims; individual candidate fit can\n   remain tentative. Use semantic mechanism matching where declared.\n6. Verify upload recency only when it affects a recommendation: use `vidiq_channel_search`\n   with `channelTitle` and `channelTitleMatch: \"exact\"` when declared, verify the ID, and read\n   `lastVideoPublished`. Channel `publishedAt` is creation time. Alternatively, a scoped\n   `vidiq_channel_videos` read needs `popular: false` and `videoFormat: long`, `short`, or\n   `live`; that format sample cannot prove channel-wide inactivity. Missing dates mean unknown.\n   `vidiq_channel_stats` with the `channelId` and a `from`/`to` window verifies a growth claim\n   before a candidate is added.\n\nClassify useful candidates as direct competitors, format references, or emerging challengers.\nRaw fame or size is insufficient; do not invent audience-overlap or private competitor analytics.\n\n## Propose and execute an exact change\n\n1. Present owner ID, original snapshot, canonical-ID `add`/`remove` sets, rationale, and expected\n   final set: `(snapshot - remove) ∪ add`. Deduplicate, prevent overlap, and omit already-present\n   additions or absent removals. Map additions to `follow` and removals to `unfollow`.\n   An empty diff needs no mutation. Do not invent a watchlist/plan cap.\n2. Obtain approval of the exact owner and add/remove diff.\n3. Immediately before mutation, re-read the list within that approval. Compare canonical-ID sets\n   with the original snapshot. If changed, abort, show the concurrent difference, and obtain\n   approval for a revised diff. If the read fails, pause.\n4. With unchanged preflight and approval, call `vidiq_update_competitors` once with\n   `youtubeChannelId`, `follow`, and `unfollow`. Preserve the response and read back with\n   `vidiq_list_competitors`.\n5. Compare actual added/removed and final sets with the approved expectation. Report discrepancies,\n   partial updates, or limit failures; never silently repair, roll back, or resubmit. Readback\n   detects but cannot prevent a race after preflight because no atomic compare-and-swap is\n   declared. If verification fails, label readback unverified and distinguish\n   any response-confirmed state.\n\n## Deliver\n\nFor an audit, return the diagnosis and proposed changes. After an approved update, report the\nconfirmed final list or exact verification gap, approval state, and unresolved discrepancies.\nKeep the owner explicit for multi-channel accounts.\n"
}