Skip to content
OpenAgentSkill
Browsing is open · Catalog captured 2026-11-21 · Automatic updates and account services are paused.
Video & audio

sogni-creative-agent

Sogni Creative Agent: image, 3D, speech, video, and music generation using Sogni AI's decentralized GPU network. Supports personas, persistent memories, custom personality, style transfer, angle synthesis, MiniMax H3/Seedance/HappyHorse/LTX/WAN video, music/lyrics, hosted chat, durable workflows, replay records, and multi-step creative workflows. Invoke when the user asks to \"draw\", \"generate\", \"create an image\", \"make a video\", \"animate\", \"make music\", \"apply a style\", or \"generate me as a superhero\".

Sogni-AI · Static checks on file

Installation

Read the source and dependencies before running a command. Copying does not install or execute anything.

npx skills add Sogni-AI/sogni-creative-agent-skill --skill sogni-creative-agent

About this skill


name: sogni-creative-agent description: "Sogni Creative Agent: image, 3D, speech, video, and music generation using Sogni AI's decentralized GPU network. Supports personas, persistent memories, custom personality, style transfer, angle synthesis, MiniMax H3/Seedance/HappyHorse/LTX/WAN video, music/lyrics, hosted chat, durable workflows, replay records, and multi-step creative workflows. Invoke when the user asks to "draw", "generate", "create an image", "make a video", "animate", "make music", "apply a style", or "generate me as a superhero"."

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

  1. Install the CLI (one-time): npm install -g @sogni-ai/sogni-creative-agent-skill@latest.
  2. Provide your Sogni API key (get one at https://dashboard.sogni.ai → account menu): either set SOGNI_API_KEY in the environment, or save it to ~/.config/sogni/credentials as SOGNI_API_KEY=<your-key>.
  3. Verify with sogni-agent doctor --json and confirm "success": true before reporting the install as working.
  4. 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

Preserve the requested stage: answer capability questions, deliver drafts for writing/review requests, and create only a still for storyboard-image requests. Continue an explicitly requested images-to-video sequence through its remaining stages unless the user requested a review pause. Preserve exact prompts, source choices, counts, and model choices; repeat shared requirements in every variation. Do not repeat a successful stage or automatically add --no-filter after failure. Honor requests to wait for user input; model-specific policies still apply.

  • Image: sogni-agent "a cat on the moon, cinematic"
  • Image edit: sogni-agent -c <path> "make it night, add fireflies"
  • Object mask: sogni-agent --segment <path> --segment-point 0.5,0.5 -o mask.png (SAM 3; see ../../references/object-selection.md)
  • Video (image-to-video): sogni-agent --video --ref <path> "gentle camera pan" (defaults to wan_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 to ltx25-22b-int8_i2v_distilled and the standard FLF template; no transition LoRA is attached)
  • Seedance 2.5 at 1080p: sogni-agent --video -m seedance2-5 --target-resolution 1080 --duration 8 -o ./seedance-1080p.mp4 "A quiet bookshop, slow camera push-in, soft room ambience" (4–30s; 480p/720p/1080p, native audio; optional --output-format mov and --return-last-frame)
  • Upscale a finished video: sogni-agent --upscale-video ./clip.mp4 --upscale-resolution 1080 -o ./clip-1080p.mp4 (promptless FlashVSR; also supports 1440p)
  • 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"
  • Seedance 2.5 Uncensored, only when asked: sogni-agent --video -m seedance2-5-uncensored --target-resolution 1080 --duration 8 "a slow dolly through a neon street at night" (same limits as Seedance 2.5; error 4103 means the user must accept the one-time likeness and consent agreement in the Sogni app; do not retry)
  • Seedance 2.0 Mini Uncensored, only when asked: sogni-agent --video -m seedance2-mini-uncensored --target-resolution 720 --duration 8 "a slow dolly through a neon street at night" (same limits as Seedance 2.0 Mini; shares the Seedance 2.5 Uncensored agreement, so error 4103 means the user must accept it in the Sogni app; do not retry)
  • 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 (MiniMax Music 3 by default): sogni-agent --music --duration 30 "ambient drone, 60 BPM, D minor"
  • 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, gene
Read the complete source ↗