genviral

# genviral Partner API Skill

> **TL;DR for agents:** This skill wraps genviral's Partner API into 42+ bash commands covering all documented endpoints. Core workflow: `generate` (create slideshow from prompt) > `render` (produce images) > `review` (check quality) > `create-post` (publish). Auth via `GENVIRAL_API_KEY` env var. Config in `config.md`. New: full analytics support (summary, posts, targets, refresh). Product context in `context/`. Hook library in `hooks/`. Track results in `performance/`. The skill self-improves: post > track > analyze > adapt strategy > post better content.

Complete automation for genviral's Partner API. Create video posts, AI-generated slideshows, manage templates and image packs, track analytics, and schedule content across any platform genviral supports (TikTok, Instagram, etc.).

This skill provides a full CLI wrapper around the Partner API with commands for every endpoint, plus higher-level workflows for content creation, performance tracking, and strategy optimization.

## What This Skill Does

- **Multi-Platform Posting:** Create posts for TikTok, Instagram, or any connected account (video OR slideshow, multiple accounts per post)
- **File Management:** Upload videos/images to genviral's CDN with presigned URL flow
- **AI Slideshow Generation:** Generate photo carousels from prompts, render them to images
- **Template System:** Create reusable slideshow templates, convert winning slideshows to templates
- **Pack Management:** Manage image packs (backgrounds for slideshows)
- **Analytics:** Get summary KPIs, post-level metrics, manage tracked accounts, trigger refreshes
- **Content Pipeline:** Full automation from prompt to posted draft
- **Performance Tracking:** Log posts, track metrics, learn from results
- **Hook Library:** Maintain and evolve a library of proven content hooks

## How It Works

The core workflow is:

1. **Generate or upload media** (slideshow from prompt, or upload your own video/images)
2. **Create a post** t...

# Genviral Skill

An [OpenClaw](https://openclaw.ai) skill for the [Genviral](https://genviral.io) Partner API.

It generates slideshows, posts them across 6 platforms, tracks what performs, and adjusts its strategy based on real data. Every cycle makes the next one better.

## Supported Platforms

| Platform | Posting | Analytics | Notes |
|----------|---------|-----------|-------|
| **TikTok** | Yes | Yes | Slideshow carousels, videos. BYO or hosted accounts. |
| **Instagram** | Yes | Yes | Reels, stories, carousels, square/portrait/landscape posts. |
| **YouTube** | Yes | Yes | Shorts and standard video uploads. |
| **Facebook** | Yes | - | Posts, square posts, event covers. |
| **Pinterest** | Yes | - | Standard pins, square pins. |
| **LinkedIn** | Yes | - | Posts, square posts, company pages. |

Analytics (performance tracking, post metrics, account insights) is available for TikTok, Instagram, and YouTube.

## How It Works

The skill runs a closed loop:

1. **Generate** slideshows from a prompt + image pack
2. **Review** each slide visually before anything gets posted
3. **Post** to connected accounts across any supported platform
4. **Track** performance through analytics endpoints
5. **Learn** what hooks, formats, and timing actually work
6. **Adapt** strategy weights, retire underperformers, double down on winners

It keeps a performance log, distills insights, and rewrites its own strategy over time. The longer it runs, the better it gets.

## Quick Start

```bash
# Set your API key
export GENVIRAL_API_KEY="your_public_id.your_secret"

# See what accounts you have
./scripts/genviral.sh accounts

# Generate a slideshow
./scripts/genviral.sh generate --prompt "5 morning habits that changed my life" --pack-id PACK_ID

# Render and post it
./scripts/genviral.sh render --id SLIDESHOW_ID
./scripts/genviral.sh create-post --caption "Caption here" --media-type slideshow --media-urls "url1,url2,..." --accounts ACCOUNT_ID

# Check how it performed
./scripts/genvira...