Viral Swipe File

View saved version →

---
name: brief-from-saved-videos
description: Read the videos the user's team saved on Viral Swipe File and turn them into a content or UGC brief - shared hooks, formats and creators, and ideas to shoot next. Use when the user mentions their saved videos, a board, favourites, their swipe file or swipe folder on Viral Swipe File, or wants to turn saved inspiration into posts.
---

# Brief from saved videos

Explicit user instructions take priority over this workflow.

1. Call `list_saved_videos`. Page with `nextOffset` if the user wants all of
   them. If the list is empty, say the team has saved nothing yet and that
   videos are saved on viralswipefile.com; offer to find viral videos in
   their niche instead.
2. Summarise what the saved videos share: niches, formats, platforms and
   recurring hook patterns, each with counts from the list and a linked
   example.
3. Read the two or three strongest by viral factor with `get_video` for
   their full hook and caption.
4. Write the brief the user asked for: what to shoot, which hook pattern and
   format to use, and the saved video to reference for each idea.

The plugin is read-only: it cannot save, remove or reorder videos. Point the
user to viralswipefile.com for that.

View saved version →

---
name: find-viral-videos
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.
---

# Find and cite viral videos

Explicit user instructions take priority over this workflow.

## 1. Resolve names to slugs

`list_videos` filters on niche and format slugs. Plain names usually work
("Make Money Online" becomes `make-money-online`), but when a name is not an
exact niche or format:

- call `search_library` with the user's words, or
- call `list_niches` / `list_formats` and pick the closest match. They do
  not count toward the team's daily questions, so use them freely.

If two niches fit, say which one you used. If nothing fits, say so and use
`search` (free text over hook, caption, niche, formats and creator) instead
of guessing a slug.

## 2. Pick the tool

| Question | Tool |
| --- | --- |
| A topic, brand or creator name, no exact slug | `search_library` |
| Top videos in a niche, format, platform or period | `list_videos` (`sort: "viral"` by default) |
| Most-viewed rather than most outsized | `list_videos` with `sort: "views"` |
| Newest additions | `list_videos` with `sort: "recent"` |
| One creator's best videos | `list_videos` with `creator` |
| One video's full hook and caption | `get_video` |
| Which niches or formats exist, and how many videos each has | `list_niches`, `list_formats` |
| The user's team's saved videos | `list_saved_videos` |

Page with `offset` (use the returned `nextOffset`). `min_viral_factor` keeps
only outliers, for example 4 or more. If a `days` window returns nothing,
say so and widen it; the library holds past viral videos, so recent windows
can be thin.

## 3. Quote every video with its basis

For each video you show:

- the hook, exactly as returned (do not paraphrase it as a quote),
- the platform and creator,
- views and viral factor, and engagement rate when relevant,
- the video's `url` on viralswipefile.com, so the reader can watch it.

Then:

- Explain viral factor once: views relative to the account's usual. A viral
  factor of 10 means ten times the account's normal views.
- A list is a sample of the library, not the whole platform. Say "in the
  library", never "on TikTok".
- When you count formats or patterns, give the counts from the videos you
  read ("6 of the 20 top fitness videos are face close-up").
- If a result has no `hook` and carries a `notice`, pass the notice on as
  given, without adding to it, when the user wants hooks.
- A missing figure is unavailable, not zero.
- If a call answers with a message instead of results, saying the team has
  used today's questions, pass it on as given, with when the count starts
  again, and do not retry before then. It is not an error to work around.

## 4. Stop at the edge of the data

Decline, and say why, for live trends, the user's own account analytics,
YouTube or long-form video, and downloading or reposting someone's video.
Offer the closest thing the library holds. Never invent a video, a hook or a
figure the tools did not return.

View saved version →

---
name: get-started
description: Set up Viral Swipe File after installation, check its connection when asked, and help the user try a first question. Use for get started, onboarding, setup, connection checks, or questions about what the library holds, what it can do, or how it helps decide what to post.
---

# Get started with Viral Swipe File

Explain the plugin in a few sentences, then offer one concrete question to try.
Explicit user instructions take priority over this guidance.

## Choose the requested path

- For "set up", "get started" or "is it connected", call `list_niches` once
  (it does not count toward the team's daily questions). If it returns
  niches, the connection works: say so and name a few niches from the
  result. Do not list them all.
- If tools are unavailable or authentication fails, say the connection is not
  verified and tell the user to connect or reconnect Viral Swipe File in their
  app, signing in with their Viral Swipe File account. Do not claim the plugin
  is ready because this skill loaded.
- For "what can it do", explain without calling a tool.
- If the user already asked a real question, answer it instead of stopping
  at a suggestion: what-to-post for post ideas, find-viral-videos for
  examples.

## What to say

- Viral Swipe File helps decide what to post: it is a library of TikToks
  and Instagram Reels that went viral, each filed under a niche and one or
  more formats (selfie with background, face close-up, story in slideshow
  and more), and the assistant writes hooks and ideas from them.
- Each video has its hook, caption, creator, views, engagement rate and
  viral factor.
- **Viral factor** is how many times more views a video got than its account
  usually gets. Sorting by it finds outliers whatever the account's size.
- Every tool is read-only. Signing in also lets it read the videos the
  user's team saved on viralswipefile.com.

## What it cannot do

Say so plainly if asked: it is a collection of past viral videos, not a live
trend feed; it has no analytics for the user's own account; it covers TikTok
and Instagram Reels only; it links to videos and never downloads or reposts
them; it cannot save or remove videos.

## Suggested first questions

Offer one, adapted to what the user mentioned:

- "What should I post this week for a fitness client?"
- "Show me the viral hooks in finance, then write 5 for my budgeting app."
- "Which video formats work best for astrology on TikTok?"
- "What has my team saved, and what do those videos have in common?"

Never quote a figure from memory; figures come only from tool results.

View saved version →

---
name: research-a-niche
description: Find which formats and hooks work in one niche on TikTok or Instagram Reels, using the Viral Swipe File library - counts per format, the best example of each, and the creators who repeat. Use when the user asks which formats work, what a niche's viral videos have in common, how to research TikTok and Instagram content for a niche, or how a niche differs between TikTok and Instagram.
---

# Research a niche

Explicit user instructions take priority over this workflow.

1. **Resolve the niche** with `search_library` or `list_niches`. Note its
   video count from `list_niches`: a niche with few videos supports only a
   tentative answer, and you should say so.
2. **Read a sample.** `list_videos` for the niche sorted by viral factor, 30
   to 50 videos. Add `platform` when the user asked about one; to compare
   platforms, read each separately with the same limit.
3. **Tally formats.** Count how many videos in the sample carry each format.
   Report the counts, not percentages of the platform. For the leading
   formats, read one or two videos with `get_video` and say what their hooks
   and openings do.
4. **Name creators** who appear more than once in the sample, with a link to
   their page from `get_video`'s `creator_url`.
5. **Summarise** in a short table (format, videos in sample, best example
   with its viral factor and link), then two or three takeaways the user can
   act on.

State the sample: "the top 40 astrology videos in the library by viral
factor". The library is past viral videos, so do not describe the result as
this week's trend.

View saved version →

---
name: what-to-post
description: Decide what to post next on TikTok or Instagram Reels for a client, brand or account, with post ideas built on real viral videos from the Viral Swipe File library - each idea with a format, a hook and a linked reference video. Use when the user asks what to post, what to post this week or tomorrow, for fresh content ideas or post ideas for a client or niche, for a batch of ideas for several clients, or for help with a blank page.
---

# What to post

Explicit user instructions take priority over this workflow.

1. **Pin who it is for.** The client, brand or account, its niche, its
   platform and audience, and how many ideas the user wants (5 by default).
   For several clients, run the steps once per client and keep the answers
   apart.
2. **Resolve the niche** with `search_library` or `list_niches`. If two
   niches fit, say which one you used; if the niche is thin, read an
   adjacent one too and say so.
3. **Read what worked.** `list_videos` for the niche sorted by viral factor,
   about 30 videos, with `platform` when the user posts on one. Viral factor
   compares each video with its own account's usual views, so a small
   account's breakout counts as much as a big one's.
4. **Find what repeats.** Group the videos by format and by hook pattern,
   with how many of the videos you read use each. Read the two or three
   strongest with `get_video` for their full hook and description.
5. **Write the ideas.** For each idea give: the format, a new hook in a
   pattern that repeats, what to show, and the library video it learns from,
   with its hook quoted exactly, its viral factor and its link.
6. **Keep the line clear.** Library hooks are quotes with links; the ideas
   and new hooks are your writing. Never present an idea as one that went
   viral or promise that it will.

If the user asks for "this week" or "right now", say once that the library
holds past viral videos ranked by viral factor, not a live trend feed, then
answer from it. `list_videos` with `sort: "recent"` shows the newest
additions when the user wants them.

View saved version →

---
name: write-hooks
description: Write new hooks, scripts or video ideas for TikTok or Instagram Reels from real viral videos in the Viral Swipe File library. Use when the user wants viral hooks, UGC hooks, opening lines that stop the scroll, hooks that don't sound like AI, scripts or UGC briefs for their product, app, brand, client or account.
---

# Write hooks from viral examples

Explicit user instructions take priority over this workflow.

1. **Pin the brief.** What the user sells or posts, who it is for, the
   platform, and the niche. If the niche is unclear, ask, or pick the closest
   one from `list_niches` and say which.
2. **Read the evidence.** `list_videos` in that niche sorted by viral factor
   (20 is a good sample). Add a `format` when the user named one. If the niche
   is thin, read an adjacent niche too and say so.
3. **Name the patterns.** Group the hooks you read into 3 to 5 patterns
   (a question, a bold claim, a "POV:", a list promise, a confession…). For
   each pattern give how many of the videos you read use it and one linked
   example with its hook quoted exactly and its viral factor.
4. **Write.** Write the requested number of new hooks for the user's product,
   each labelled with the pattern it follows. Keep them in the user's voice
   and claims they can stand behind: do not invent results, numbers or
   testimonials for their product.
5. **Keep the line clear.** Library hooks are quotes with links; new hooks
   are your writing. Never present a new hook as one that went viral, and
   never copy a creator's hook word for word as the user's own.

If results carry a `notice` instead of hooks, pass the notice on as given,
without adding to it; you can still work from captions you are shown,
formats and creators.