genviral Partner API Skill

TL;DR: Uses the @genviral/cli npm package for 60+ Partner API commands; docs.genviral.io is the canonical REST reference (start with llms.txt and Create Post for POST /posts payload shapes). Core flow: get-pack → analyze images (metadata + vision) → generate with pinned_images → render → visual review (hard gate) → create-post → log to workspace/performance/log.json. TikTok copy flow: copy-tiktok-preview → copy-tiktok-import (with exactly one of pack_id or pack_images). Studio AI: studio-models → studio-generate-image (sync) or studio-generate-video → studio-video-status --poll (async). Folders: create-folder → folder-items-add to organize files/slideshows. Analytics correlation: treat analyticsId/id, platformPostId, and genviralPostId as different identifiers; use genviralPostId or externalId to map analytics rows back to created posts. Auth via GENVIRAL_API_KEY. Config in defaults.yaml. Instance data in workspace/.

What This Skill Does

Multi-Platform Posting: Video, slideshow, or text-only posts across TikTok, Instagram, YouTube, Pinterest, LinkedIn, Facebook, X, Bluesky (check each account's capabilities from GET /accounts)
Studio AI Generation: Generate images (sync) and videos (async) via AI models through the API
File Management: Upload videos/images to genviral's CDN; organize with folders
Folder Management: Nested folders for uploads, AI images, AI videos, and slideshows
AI Slideshow Generation: Photo carousels from prompts, rendered to images
Template System: Reusable slideshow structures, convert winners to templates
Pack Management: Image packs as slideshow backgrounds
Analytics: KPIs, post-level metrics, tracked accounts, refresh triggers
Niche Intelligence: One-call trend research (trend-brief) for hashtags, sounds, creators, posting windows, and hook angles
Content Pipeline: Full automation from prompt to posted content
Performance Tracking: Post log, hook tracking, weekly review
Hook Library: Maintain and evolve a library of proven content hooks