Sogni-AI Sogni Creative Agent
Generate images, videos, and music via Sogni AI's decentralized GPU network through the sogni-agent CLI shipped with this plugin.
Claude Code plugin command: invoke sogni-agent-claude-code for every
Sogni command in this skill. Wherever this file or a referenced root guide says
sogni-agent, substitute sogni-agent-claude-code. This fixed launcher
preserves normal CLI behavior while attributing the request to Claude Code.
Setup
- Install the CLI (one-time):
npm install -g @sogni-ai/sogni-creative-agent-skill@latest. - Provide your Sogni API key (get one at https://dashboard.sogni.ai → account menu): either set
SOGNI_API_KEYin the environment, or save it to~/.config/sogni/credentialsasSOGNI_API_KEY=<your-key>. - Verify with
sogni-agent doctor --jsonand confirm"success": truebefore reporting the install as working. - Optional config files honored:
~/.config/sogni/credentials,~/.config/sogni/last-render.json.
Do not run the default npx setup-sogni-agent-skill from an installed plugin unless the user explicitly wants a separate personal skill registration in ~/.claude/skills/ or another host's personal skill directory; using both can create duplicate skills.
Uninstall: remove sogni-creative-agent@sogni with Claude Code's plugin manager. To also remove the global CLI and Sogni data, run npx setup-sogni-agent-skill --uninstall --remove-cli --purge after the plugin is removed; it backs up ~/.config/sogni/ to ~/.config/sogni.backup-<timestamp>.tar.gz first. Tell the user the backup path; it holds their API key. Omit --purge to keep data. This cleanup command does not uninstall the Claude Code plugin itself.
Quick examples
- Image:
sogni-agent "a cat on the moon, cinematic" - Image edit:
sogni-agent -c <path> "make it night, add fireflies" - Video (image-to-video):
sogni-agent --video --ref <path> "gentle camera pan"(defaults towan_v2.2-14b-fp8_i2v_lightx2v) - Animate two images (first frame → last frame):
sogni-agent --video --ref <first> --ref-end <last> "smooth morph into the final frame"(defaults toltx25-22b-int8_i2v_distilledand the standard FLF template; no transition LoRA is attached) - MiniMax H3 reference-to-video:
sogni-agent --video -m minimax-h3-r2v --ref <identity> -c <wardrobe> --ref-video <motion> --ref-audio <voice> "<Picture 1> controls identity; <Picture 2> controls wardrobe; <Video 1> controls motion; <Audio 1> controls voice." - Alibaba Wan 3 unified video:
sogni-agent --video -m wan3 --target-resolution 1080 --duration 8 "a presenter says 'Welcome' in a detailed studio" - Wan 3.0 Enhanced through MuleRouter:
sogni-agent --video -m wan3-enhanced --target-resolution 1080 --smart-duration --wan3-ratio adaptive "a presenter says 'Welcome' in a detailed studio" - One-click image-folder loop:
/sogni-creative-agent:loop-maker ./images - One-click image-folder loop in Codex:
$sogni-creative-agent:loop-maker ./images - Music:
sogni-agent --music "ambient drone, 30 seconds" - Hosted workflow:
sogni-agent --api-workflow storyboard-video --storyboard-frames 6 "9:16 bakery launch video" - List inbound media the user sent (Telegram etc.):
sogni-agent --json --list-media - Inspect the last render:
sogni-agent --last --json - Full reference:
sogni-agent --help
When to invoke this skill
The user asks to:
- generate / create / draw / render an image
- animate, make a video, convert image to video
- turn a folder of images into a deduplicated, music-backed seamless loop
- make music, generate audio, create a soundtrack
- apply a style or transform a subject ("as a superhero", "anime style")
- manage personas or saved reference assets
Full skill manifest
The complete skill spec — every workflow, model default, persona schema, memory schema, and prompt-engineering note — lives at ../../SKILL.md relative to this file, with deep-dive guides under ../../references/. Resolve those paths from this installed SKILL.md, not from the user's working directory. Read them when the user's request needs detail beyond the quick examples above (e.g. choosing between video workflows, configuring persona references, planning a multi-step composition).