Sogni Creative Agent

Sogni Creative Agent

Generate images, videos, and music via Sogni AI's decentralized GPU network through the sogni-agent CLI shipped with this plugin.

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=.
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 this plugin unless the user wants a separate personal skill registration in ~/.claude/skills/; using both creates duplicate Claude Code 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-.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 "make it night, add fireflies"
• Video (image-to-video): sogni-agent --video --ref "gentle camera pan"
• 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
• 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 ${CLAUDE_PLUGIN_ROOT}/SKILL.md (the root of this plugin), with deep-dive guides under ${CLAUDE_PLUGIN_ROOT}/references/. 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).

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: Sogni-AI
• Source: Sogni-AI/sogni-creative-agent-skill
• License: MIT

Install and usage instructions live in the source repository linked above.