One-click install
npx skills add https://github.com/mutonby/viraloop --skill viraloop
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: viraloop
Source: https://github.com/mutonby/viraloop/tree/main
Command: npx skills add https://github.com/mutonby/viraloop --skill viraloop

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires playwright, jq, uv, node, curl, and includes scripts (resource) components.

What problem does it solve?

Viraloop removes the manual grind of researching a product and then repeatedly crafting, designing, and publishing TikTok/Instagram carousel content by turning a single website URL into a ready-to-post 6-slide sequence with an analytics-driven learning loop.

Core Features & Use Cases

  • URL-to-carousel business research: Analyzes a target website to extract brand cues, features, pricing signals, CTAs, and competitors, then converts that into hook/pain/solution messaging.
  • Hook testing + visually coherent slide generation: Produces multiple hook variants (shock, curiosity, contradiction) and generates 6 slides with consistent style via image-to-image so the carousel reads as one cohesive story.
  • Direct publishing + performance feedback loop: Publishes to TikTok and Instagram in one request (with auto trending music on TikTok) and saves results locally to improve future hooks based on what performs best.

Example use case: Provide your SaaS landing page URL, generate a carousel structured around the website’s value proposition, publish it to both platforms, then use the collected analytics to determine which hook style and wording drives the most views.

Quick Start

Run the full pipeline by analyzing your website URL, generating the 6 carousel slides, publishing them to TikTok and Instagram via upload-post.com, and then learning from the returned analytics to improve next posts.

Frequently Asked Questions about viraloop

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automate Instagram and TikTok carousel generation from a website URL?

You can automate carousel generation by analyzing a website URL to extract brand and pricing signals, then converting that data into a 6-slide hook-to-CTA narrative. This process uses local Playwright research and AI image generation to create visually cohesive slides ready for publishing.

Can I automatically publish carousels to TikTok and Instagram and track their performance?

Yes, direct publishing to TikTok and Instagram is executed in one request via the Upload-Post API, including auto trending music on TikTok. The system then saves analytics locally to iteratively optimize future hooks based on which content drives the most views.

How do I create visually coherent carousel slides for social media marketing?

Visually coherent carousel slides are created using AI image-to-image generation. The system produces multiple hook variants and generates 6 slides with a consistent style, ensuring the carousel reads as one cohesive story aligned with the extracted brand cues.

Do I need Playwright and local dependencies to run social media carousel automation?

Yes, local Playwright is required to perform website research and extract brand features. Additional dependencies include jq, uv, node, and curl to execute the full pipeline, generate images via the Gemini API, and handle the publishing workflow.

What is the best way to test different marketing hooks for TikTok and Instagram carousels?

The best way to test marketing hooks is to generate multiple variants like shock, curiosity, and contradiction, publish them to TikTok and Instagram, and then use the collected analytics. A local learning loop saves these results to continuously improve future hook wording.

Are there limitations to using automated AI image generation for social media publishing workflows?

Limitations include relying on external APIs like Gemini for image generation and Upload-Post for publishing, meaning API rate limits or downtime can halt the workflow. Additionally, the system requires a local environment with Playwright and Node installed to function properly.