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 · 已有静态检查记录
安装与使用
运行命令前先阅读来源与依赖说明。复制命令不会自动安装或执行。
npx skills add Sogni-AI/sogni-creative-agent-skill --skill sogni-creative-agent技能说明
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
- 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
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 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) - 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 movand--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