| name | viral-replicator |
| description | Use when the user wants to either (a) deconstruct a viral Instagram/TikTok/YouTube Short and rebuild it for their brand, or (b) scrape product reviews from G2/Trustpilot and turn them into a testimonial-style video ad. Both paths produce a paste-ready Higgsfield video prompt. Triggers on phrases like "deconstruct this viral video", "rebuild this for my brand", "scrape these reviews into an ad", or "turn G2 reviews into a testimonial video". |
Viral Replicator + Review-to-Ad
Two paths, same destination: a Higgsfield-ready video prompt.
- Path A — Viral replication. Paste a viral video URL → deconstruct the structure → rebuild it for the user's brand.
- Path B — Review-to-ad. Point at a G2 product reviews URL → cluster reviews into testimonial themes → generate ad scripts.
When to use
User prompts that should trigger this skill:
- "Deconstruct this Instagram video and rebuild it for my brand: "
- "What made this viral video work? Now make me a version of it."
- "Scrape Castos's G2 reviews and turn them into a testimonial ad."
- "Pull these reviews and write me 3 ad scripts."
Routing
Route on the first user input:
| User input contains | Path |
|---|
instagram.com/p/, instagram.com/reel/, tiktok.com, youtube.com/shorts | Path A |
g2.com/products/, trustpilot.com/review, OR pasted review text | Path B |
| Both | Run Path A first, then ask whether to also run Path B |
Path A — Viral replication
Step 1 — Fetch the post
node skills/viral-replicator/scripts/fetch-ig-post.mjs <URL> --out output/viral-replicator/<slug>-<YYYY-MM-DD>/raw-post.json
The script captures: caption, hashtags, on-screen text, video poster, duration, engagement counts. If Instagram blocks the headless browser (common — they aggressively rate-limit), fall back to examples/kallaway-fixture.md and tell the user the demo is using a fixture.
The same script handles TikTok and YouTube Shorts URLs at best-effort; for YouTube Shorts especially, ask the user to paste the transcript if scraping fails.
Step 2 — Deconstruct
Load prompts/deconstruct-viral.md and produce a structured breakdown: hook (0–3s), pattern interrupts, narrative arc, visual style, audio role, payoff, CTA shape, why-it-worked hypothesis.
Write to output/viral-replicator/<slug>-<YYYY-MM-DD>/deconstruction.md.
Step 3 — Rebuild for the user's brand
Ask once: "What's the brand and topic this rebuild is for? One sentence." (Skip if the user already told you.)
Load prompts/rebuild-viral.md and produce a shot-by-shot script + a paste-ready Higgsfield video prompt using templates/higgsfield-rebuild-prompt.md.
Write to output/viral-replicator/<slug>-<YYYY-MM-DD>/rebuild.md and higgsfield.md.
Step 4 — Render (optional)
If the Higgsfield MCP is connected, call ToolSearch with query higgsfield to find the current video-generation tool, then call it with the prompt from templates/higgsfield-rebuild-prompt.md. If not, the prompt sits paste-ready.
Path B — Review-to-ad
Step 1 — Scrape reviews
node skills/viral-replicator/scripts/scrape-g2-reviews.mjs <URL> --top 25 --out output/viral-replicator/<brand>-reviews-<YYYY-MM-DD>/raw-reviews.json
The script captures per review: reviewer name (or "Verified User"), role, company size, star rating, "what do you like best", "what do you dislike", quote excerpt. G2 has anti-bot protections — if the scrape is blocked, fall back to examples/castos-g2-fixture.md and tell the user.
For Trustpilot URLs, the script auto-switches selectors. For arbitrary review text the user pastes, skip Step 1 and feed the text directly into Step 2.
Step 2 — Cluster into testimonial themes
Load prompts/review-to-ad.md. Produce 2–3 testimonial themes. Each theme:
- Theme name (the customer truth, NOT a feature name)
- 1 representative pull-quote per theme (verbatim, with reviewer attribution)
- Why this theme converts
Write to output/viral-replicator/<brand>-reviews-<YYYY-MM-DD>/themes.md.
Step 3 — Ad-ify
For each theme, write a 30-second testimonial-style spot:
- Hook (0–3s) — uses the pull-quote or a paraphrase
- Setup (3–10s)
- Demonstration (10–22s)
- Payoff + CTA (22–30s)
Choose the visual treatment per theme:
- Talking-head reconstruction — for emotional / "this saved my business" testimonials
- Text-on-b-roll with VO — for technical / specific-feature testimonials
- Side-by-side before/after — for migration / switching testimonials
Use templates/testimonial-ad-prompt.md to write the Higgsfield video prompt for each spot.
Write to output/viral-replicator/<brand>-reviews-<YYYY-MM-DD>/scripts.md and higgsfield.md.
Step 4 — Render (optional)
Same MCP discovery pattern as Path A.
Output structure
output/viral-replicator/
├── <viral-post-slug>-<YYYY-MM-DD>/
│ ├── raw-post.json
│ ├── deconstruction.md
│ ├── rebuild.md
│ └── higgsfield.md
└── <brand>-reviews-<YYYY-MM-DD>/
├── raw-reviews.json
├── themes.md
├── scripts.md
└── higgsfield.md
Voice & tone
- For rebuilds: match the structure of the original, NOT the voice. The voice should sound like the user's brand.
- For testimonial ads: keep customer quotes verbatim where possible. Resist polishing — real language reads as real.
- No "transformative." No "game-changing." No "I never thought I could…" unless the customer literally said it.
Demo commands
Deconstruct https://www.instagram.com/p/DAi1lWIPFuB/ and rebuild it for an insulated cup brand.
Scrape https://www.g2.com/products/castos/reviews and turn them into 3 testimonial ad scripts.
