Update to Viral Swipe File

{
  "description": "Find viral TikToks and Instagram Reels in the Viral Swipe File library by niche, format, platform or creator, and quote each video's hook, views and viral factor with its link. Use when the user asks for viral videos or examples, what's working in a niche or format, videos that beat their account's usual views, the top videos in a niche, or a creator's best videos.",
  "included_files": [],
  "name": "find-viral-videos",
  "skill_md_contents": "---\nname: find-viral-videos\ndescription: Find viral TikToks and Instagram Reels in the Viral Swipe File library by niche, format, platform or creator, and quote each video's hook, views and viral factor with its link. Use when the user asks for viral videos or examples, what's working in a niche or format, videos that beat their account's usual views, the top videos in a niche, or a creator's best videos.\n---\n\n# Find and cite viral videos\n\nExplicit user instructions take priority over this workflow.\n\n## 1. Resolve names to slugs\n\n`list_videos` filters on niche and format slugs. Plain names usually work\n(\"Make Money Online\" becomes `make-money-online`), but when a name is not an\nexact niche or format:\n\n- call `search_library` with the user's words, or\n- call `list_niches` / `list_formats` and pick the closest match. They do\n  not count toward the team's daily questions, so use them freely.\n\nIf two niches fit, say which one you used. If nothing fits, say so and use\n`search` (free text over hook, caption, niche, formats and creator) instead\nof guessing a slug.\n\n## 2. Pick the tool\n\n| Question | Tool |\n| --- | --- |\n| A topic, brand or creator name, no exact slug | `search_library` |\n| Top videos in a niche, format, platform or period | `list_videos` (`sort: \"viral\"` by default) |\n| Most-viewed rather than most outsized | `list_videos` with `sort: \"views\"` |\n| Newest additions | `list_videos` with `sort: \"recent\"` |\n| One creator's best videos | `list_videos` with `creator` |\n| One video's full hook and caption | `get_video` |\n| Which niches or formats exist, and how many videos each has | `list_niches`, `list_formats` |\n| The user's team's saved videos | `list_saved_videos` |\n\nPage with `offset` (use the returned `nextOffset`). `min_viral_factor` keeps\nonly outliers, for example 4 or more. If a `days` window returns nothing,\nsay so and widen it; the library holds past viral videos, so recent windows\ncan be thin.\n\n## 3. Quote every video with its basis\n\nFor each video you show:\n\n- the hook, exactly as returned (do not paraphrase it as a quote),\n- the platform and creator,\n- views and viral factor, and engagement rate when relevant,\n- the video's `url` on viralswipefile.com, so the reader can watch it.\n\nThen:\n\n- Explain viral factor once: views relative to the account's usual. A viral\n  factor of 10 means ten times the account's normal views.\n- A list is a sample of the library, not the whole platform. Say \"in the\n  library\", never \"on TikTok\".\n- When you count formats or patterns, give the counts from the videos you\n  read (\"6 of the 20 top fitness videos are face close-up\").\n- If a result has no `hook` and carries a `notice`, pass the notice on as\n  given, without adding to it, when the user wants hooks.\n- A missing figure is unavailable, not zero.\n- If a call answers with a message instead of results, saying the team has\n  used today's questions, pass it on as given, with when the count starts\n  again, and do not retry before then. It is not an error to work around.\n\n## 4. Stop at the edge of the data\n\nDecline, and say why, for live trends, the user's own account analytics,\nYouTube or long-form video, and downloading or reposting someone's video.\nOffer the closest thing the library holds. Never invent a video, a hook or a\nfigure the tools did not return.\n"
}