@sogni-ai/sogni-creative-agent-skill 2.0.1 → 2.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -2,9 +2,9 @@
2
2
  <img src="https://raw.githubusercontent.com/Sogni-AI/sogni-creative-agent-skill/main/docs/screenshot.jpg" alt="Telegram image render workflow" width="320" />
3
3
  </p>
4
4
 
5
- # Sogni Creative Agent Skill: Creative AI Superpowers for All AI Agent Runtimes
5
+ # Sogni Creative Agent Skill: Image & Video Generation for Agents
6
6
 
7
- **Sogni Creative Agent Skill** gives any AI agent runtime Claude Code, Claude Desktop,
7
+ **Sogni Creative Agent Skill** gives AI agent runtimes such as Claude Code,
8
8
  [OpenClaw](https://github.com/OpenClaw/OpenClaw),
9
9
  [Hermes Agent](https://hermes-agent.nousresearch.com/),
10
10
  [Manus AI](https://manus.im), and more — image generation, video generation, and
@@ -15,9 +15,8 @@ Drop it into the setup you already have:
15
15
  - as a standalone Node.js CLI
16
16
  - as a skill source for **Hermes Agent**, **Manus AI**, and other agent frameworks
17
17
  - as an [OpenClaw](https://github.com/OpenClaw/OpenClaw) plugin
18
- - optionally as an [MCP server](https://modelcontextprotocol.io/) for **Claude Code**, **Claude Desktop**, and any MCP-compatible agent
19
18
 
20
- For generic install requests, use the CLI plus skill setup by default. Configure MCP only when specifically requested.
19
+ For install requests, use the CLI plus skill setup by default.
21
20
 
22
21
  With Sogni Creative Agent Skill, an agent can:
23
22
  - generate images from prompts
@@ -47,14 +46,14 @@ Then ask your agent to do something simple, for example:
47
46
 
48
47
  ## Installation
49
48
 
50
- Default install behavior: when someone asks to install Sogni Creative Agent Skill, install the command-line tool and skill source. Do not configure MCP unless they specifically ask for MCP, Claude MCP, or Claude Desktop integration.
49
+ Default install behavior: when someone asks to install Sogni Creative Agent Skill, install the command-line tool and skill source.
51
50
 
52
51
  ```bash
53
52
  npm install -g @sogni-ai/sogni-creative-agent-skill
54
53
  sogni-agent --version
55
54
  ```
56
55
 
57
- Then point the agent/runtime at this repository's [`SKILL.md`](./SKILL.md). MCP setup is optional and documented separately below.
56
+ Then point the agent/runtime at this repository's [`SKILL.md`](./SKILL.md).
58
57
 
59
58
  ### OpenClaw Plugin
60
59
 
@@ -92,7 +91,7 @@ Do not run `openclaw plugins install -l "$PWD"` from the repository root. The ro
92
91
 
93
92
  ### Hermes Agent / Manus / Other Frameworks
94
93
 
95
- Point the agent to this repository's [`SKILL.md`](./SKILL.md) for behavior guidance and [`llm.txt`](https://raw.githubusercontent.com/Sogni-AI/sogni-creative-agent-skill/main/llm.txt) for install/setup help. By default, the agent should invoke the globally installed `sogni-agent` CLI. Configure MCP only when specifically requested.
94
+ Point the agent to this repository's [`SKILL.md`](./SKILL.md) for behavior guidance and [`llm.txt`](https://raw.githubusercontent.com/Sogni-AI/sogni-creative-agent-skill/main/llm.txt) for install/setup help. By default, the agent should invoke the globally installed `sogni-agent` CLI.
96
95
 
97
96
  ### Manual Installation
98
97
 
@@ -128,36 +127,7 @@ You can also skip the file and set `SOGNI_API_KEY`, or `SOGNI_USERNAME` + `SOGNI
128
127
 
129
128
  ### Filesystem Paths and Overrides
130
129
 
131
- Defaults live under `~/.config/sogni/` for credentials, last-render metadata, personas, memories, and personality. Advanced path overrides are available through `SOGNI_CREDENTIALS_PATH`, `SOGNI_LAST_RENDER_PATH`, `SOGNI_MEDIA_INBOUND_DIR`, `OPENCLAW_CONFIG_PATH`, and MCP-specific download settings.
132
-
133
- ## Claude Code and Claude Desktop MCP (Optional)
134
-
135
- This section is only for users who specifically want MCP. For a generic install request, use the command-line tool plus skill setup above.
136
-
137
- ### Claude Code (one command)
138
-
139
- ```bash
140
- claude mcp add sogni -- npx -y -p @sogni-ai/sogni-creative-agent-skill sogni-agent-mcp
141
- ```
142
-
143
- ### Claude Desktop
144
-
145
- Add to `~/Library/Application Support/Claude/claude_desktop_config.json`:
146
-
147
- ```json
148
- {
149
- "mcpServers": {
150
- "sogni": {
151
- "command": "npx",
152
- "args": ["-y", "-p", "@sogni-ai/sogni-creative-agent-skill", "sogni-agent-mcp"]
153
- }
154
- }
155
- }
156
- ```
157
-
158
- Restart Claude Desktop after saving.
159
-
160
- The MCP server exposes the same core image/video/edit/persona/balance workflows as the CLI, plus local helpers such as last-frame extraction and video stitching.
130
+ Defaults live under `~/.config/sogni/` for credentials, last-render metadata, personas, memories, and personality. Advanced path overrides are available through `SOGNI_CREDENTIALS_PATH`, `SOGNI_LAST_RENDER_PATH`, `SOGNI_MEDIA_INBOUND_DIR`, and `OPENCLAW_CONFIG_PATH`.
161
131
 
162
132
  ## Usage
163
133
 
package/SKILL.md CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  name: sogni-creative-agent-skill
3
- version: "2.0.1"
4
- description: Sogni Creative Agent Skill: Creative AI superpowers for all AI agent runtimes. Generates images and videos using Sogni AI's decentralized GPU network. Supports personas (named people with saved reference photos and voice clips), persistent memories (user preferences across sessions), custom personality, style transfer, angle synthesis, and multi-step creative workflows. Ask the agent to "draw", "generate", "create an image", "make a video/animate", "apply a style", or "generate me as a superhero".
3
+ version: "2.1.0"
4
+ description: Sogni Creative Agent Skill: agent skill and CLI for image and video generation using Sogni AI's decentralized GPU network. Supports personas (named people with saved reference photos and voice clips), persistent memories (user preferences across sessions), custom personality, style transfer, angle synthesis, and multi-step creative workflows. Ask the agent to "draw", "generate", "create an image", "make a video/animate", "apply a style", or "generate me as a superhero".
5
5
  homepage: https://sogni.ai
6
6
  metadata:
7
7
  clawdbot:
@@ -21,9 +21,6 @@ metadata:
21
21
  - "OPENCLAW_CONFIG_PATH"
22
22
  - "OPENCLAW_PLUGIN_CONFIG"
23
23
  - "FFMPEG_PATH"
24
- - "SOGNI_DOWNLOADS_DIR"
25
- - "SOGNI_MCP_SAVE_DOWNLOADS"
26
- - "SOGNI_ALLOWED_DOWNLOAD_HOSTS"
27
24
  config:
28
25
  - "~/.config/sogni/credentials"
29
26
  - "~/.openclaw/openclaw.json"
@@ -43,7 +40,7 @@ Generate **images and videos** using Sogni AI's decentralized GPU network.
43
40
 
44
41
  ## Install Request Policy
45
42
 
46
- When a user asks to install this plugin, skill, or Sogni Creative Agent Skill without specifically asking for MCP, install it as the command-line tool plus this skill by default. Do not add Claude MCP, Claude Desktop MCP, or an MCP server registration unless the user explicitly asks for MCP.
43
+ When a user asks to install this plugin, skill, or Sogni Creative Agent Skill, install it as the command-line tool plus this skill.
47
44
 
48
45
  Default install path:
49
46
 
@@ -54,10 +51,6 @@ sogni-agent --version
54
51
 
55
52
  Then configure the agent/runtime to use this `SKILL.md` and invoke the `sogni-agent` CLI.
56
53
 
57
- ## Runtime Routing
58
-
59
- If sogni MCP tools are already available in your session (e.g., `generate_image`, `manage_personas`), **prefer MCP tools over direct CLI invocation**. MCP tools handle input validation, credential checking, file downloads, and result formatting automatically. Only fall back to the CLI (`node sogni-agent.mjs ...`) if MCP tools are not registered in your environment. This runtime preference does not change the install default above.
60
-
61
54
  ## Setup
62
55
 
63
56
  1. **Get Sogni credentials** at https://app.sogni.ai/
@@ -81,7 +74,7 @@ npm install -g @sogni-ai/sogni-creative-agent-skill
81
74
  sogni-agent --version
82
75
  ```
83
76
 
84
- Configure the agent/runtime to use this `SKILL.md`. Do not configure MCP unless the user specifically asks for MCP.
77
+ Configure the agent/runtime to use this `SKILL.md`.
85
78
 
86
79
  4. **Install dependencies if working from a clone:**
87
80
  ```bash
@@ -107,7 +100,6 @@ Default file paths used by this skill:
107
100
  - Last render metadata (read/write): `~/.config/sogni/last-render.json`
108
101
  - OpenClaw config (read): `~/.openclaw/openclaw.json`
109
102
  - Media listing for `--list-media` (read): `~/.clawdbot/media/inbound`
110
- - MCP local result copies (write): `~/Downloads/sogni`
111
103
 
112
104
  Path override environment variables:
113
105
 
@@ -115,9 +107,6 @@ Path override environment variables:
115
107
  - `SOGNI_LAST_RENDER_PATH`
116
108
  - `SOGNI_MEDIA_INBOUND_DIR`
117
109
  - `OPENCLAW_CONFIG_PATH`
118
- - `SOGNI_DOWNLOADS_DIR` (MCP)
119
- - `SOGNI_MCP_SAVE_DOWNLOADS=0` to disable MCP local file writes
120
- - `SOGNI_ALLOWED_DOWNLOAD_HOSTS` to override which HTTPS hosts the MCP server may auto-download and save locally
121
110
 
122
111
  ## Usage (Images & Video)
123
112
 
@@ -905,7 +894,7 @@ node {{skillDir}}/sogni-agent.mjs --angles-360 -c subject.jpg "same subject"
905
894
  - "Apply a different style" → `-c <result> "Apply style: ..."`
906
895
  - "Change the angle" → `--multi-angle -c <result>`
907
896
  - "Generate variations" → `-n 3 "{style1|style2|style3}"`
908
- - "Refine at higher quality" → use `refine_result` MCP tool or `-Q pro`
897
+ - "Refine at higher quality" → use `-Q pro`
909
898
 
910
899
  ### After Video Generation — Suggest Next Steps:
911
900
  - "Try different motion" → re-generate with adjusted prompt
package/llm.txt CHANGED
@@ -1,15 +1,12 @@
1
1
  # sogni-creative-agent-skill
2
2
 
3
- Creative AI superpowers for all AI agent runtimes Claude Code, Claude Desktop,
4
- OpenClaw, Hermes Agent, Manus AI, and more. Powered by Sogni AI's decentralized
5
- GPU network.
3
+ Agent skill and CLI for Sogni AI image and video generation. Works as a skill
4
+ source for Claude Code, OpenClaw, Hermes Agent, Manus AI, and other agent
5
+ runtimes.
6
6
 
7
7
  ## Install (pick the integration that matches your environment)
8
8
 
9
9
  ```bash
10
- # MCP server (Claude Code)
11
- claude mcp add sogni -- npx -y -p @sogni-ai/sogni-creative-agent-skill sogni-agent-mcp
12
-
13
10
  # OpenClaw plugin
14
11
  openclaw plugins install sogni-creative-agent-skill
15
12
 
@@ -31,7 +28,7 @@ openclaw gateway restart
31
28
 
32
29
  # Hermes Agent / Manus / other agent frameworks
33
30
  # Point the agent at https://github.com/Sogni-AI/sogni-creative-agent-skill — use SKILL.md as
34
- # the behavior source and invoke the CLI/MCP server.
31
+ # the behavior source and invoke the CLI.
35
32
 
36
33
  # Standalone Node CLI
37
34
  npm install -g @sogni-ai/sogni-creative-agent-skill
@@ -65,5 +62,4 @@ https://github.com/Sogni-AI/sogni-creative-agent-skill
65
62
  - `SKILL.md` — agent behavior and usage rules (load this into your agent)
66
63
  - `openclaw.plugin.json` — OpenClaw plugin manifest and config schema
67
64
  - `.openclaw-link/` — generated OpenClaw link target for local development only
68
- - `sogni-agent.mjs` — CLI used by the skill / MCP server
69
- - `mcp-server.mjs` — MCP server entry point
65
+ - `sogni-agent.mjs` — CLI used by the skill
@@ -1,8 +1,8 @@
1
1
  {
2
2
  "id": "sogni-creative-agent-skill",
3
3
  "name": "Sogni Creative Agent Skill — Image & Video Generation",
4
- "description": "Creative AI superpowers for all AI agent runtimes, powered by Sogni AI.",
5
- "version": "2.0.1",
4
+ "description": "Agent skill and CLI for Sogni AI image and video generation.",
5
+ "version": "2.1.0",
6
6
  "skills": [
7
7
  "."
8
8
  ],
package/package.json CHANGED
@@ -1,12 +1,11 @@
1
1
  {
2
2
  "name": "@sogni-ai/sogni-creative-agent-skill",
3
- "version": "2.0.1",
4
- "description": "Sogni Creative Agent Skill: creative AI superpowers for all AI agent runtimes (Claude Code, Claude Desktop, OpenClaw, Hermes Agent, Manus AI, and more). Powered by Sogni AI's decentralized GPU network.",
3
+ "version": "2.1.0",
4
+ "description": "Sogni Creative Agent Skill: agent skill and CLI for Sogni AI image and video generation.",
5
5
  "type": "module",
6
6
  "main": "sogni-agent.mjs",
7
7
  "bin": {
8
- "sogni-agent": "sogni-agent.mjs",
9
- "sogni-agent-mcp": "mcp-server.mjs"
8
+ "sogni-agent": "sogni-agent.mjs"
10
9
  },
11
10
  "scripts": {
12
11
  "openclaw:sync": "node scripts/sync-openclaw-plugin.mjs",
@@ -21,13 +20,11 @@
21
20
  "agent",
22
21
  "image-generation",
23
22
  "video-generation",
24
- "mcp",
25
23
  "openclaw",
26
24
  "hermes-agent",
27
25
  "manus",
28
26
  "claude",
29
- "claude-code",
30
- "claude-desktop"
27
+ "claude-code"
31
28
  ],
32
29
  "author": "Mauvis Ledford",
33
30
  "license": "MIT",
@@ -54,16 +51,9 @@
54
51
  "openclaw.plugin.json",
55
52
  "env.mjs",
56
53
  "ssrf-guard.mjs",
57
- "mcp-server.mjs",
58
- "sogni-agent.mjs",
59
- "Support/Claude/claude_desktop_config.json",
60
- "desktop-extension/manifest.json",
61
- "desktop-extension/server/mcp-server.mjs",
62
- "desktop-extension/server/sogni-agent.mjs",
63
- "desktop-extension/server/package.json"
54
+ "sogni-agent.mjs"
64
55
  ],
65
56
  "dependencies": {
66
- "@modelcontextprotocol/sdk": "^1.0.0",
67
57
  "@sogni-ai/sogni-client-wrapper": "^1.5.2",
68
58
  "execa": "^9.6.1",
69
59
  "json5": "^2.2.3",
@@ -3,7 +3,6 @@
3
3
  "private": true,
4
4
  "type": "module",
5
5
  "dependencies": {
6
- "@modelcontextprotocol/sdk": "^1.0.0",
7
6
  "@sogni-ai/sogni-client-wrapper": "^1.5.2",
8
7
  "execa": "^9.6.1",
9
8
  "json5": "^2.2.3",
package/sogni-agent.mjs CHANGED
@@ -4863,4 +4863,10 @@ async function main() {
4863
4863
  process.exit(exitCode);
4864
4864
  }
4865
4865
 
4866
- main();
4866
+ main().then(
4867
+ () => process.exit(0),
4868
+ (error) => {
4869
+ console.error(`Error: ${error?.message || error}`);
4870
+ process.exit(1);
4871
+ }
4872
+ );
package/version.mjs CHANGED
@@ -1 +1 @@
1
- export const PACKAGE_VERSION = '2.0.1';
1
+ export const PACKAGE_VERSION = '2.1.0';
@@ -1,8 +0,0 @@
1
- {
2
- "mcpServers": {
3
- "sogni": {
4
- "command": "npx",
5
- "args": ["-y", "-p", "@sogni-ai/sogni-creative-agent-skill", "sogni-agent-mcp"]
6
- }
7
- }
8
- }
@@ -1,114 +0,0 @@
1
- {
2
- "manifest_version": "0.3",
3
- "name": "sogni-creative-agent-skill",
4
- "version": "2.0.1",
5
- "display_name": "Sogni Creative Agent Skill — Image & Video Generation",
6
- "description": "Creative AI superpowers for all AI agent runtimes, powered by Sogni AI's decentralized GPU network",
7
- "long_description": "Sogni Creative Agent Skill gives any AI agent (Claude Code/Desktop, OpenClaw, Hermes Agent, Manus AI, and more) image generation, image editing, video generation, photobooth face transfer, persona memory, and other creative-media tools. Uses Spark tokens — claim 50 free daily at https://app.sogni.ai/",
8
- "author": {
9
- "name": "Sogni AI",
10
- "url": "https://sogni.ai"
11
- },
12
- "repository": {
13
- "type": "git",
14
- "url": "https://github.com/Sogni-AI/sogni-creative-agent-skill.git"
15
- },
16
- "homepage": "https://sogni.ai",
17
- "support": "https://github.com/Sogni-AI/sogni-creative-agent-skill/issues",
18
- "license": "MIT",
19
- "keywords": ["image-generation", "video-generation", "ai", "sogni", "agent", "mcp"],
20
- "server": {
21
- "type": "node",
22
- "entry_point": "server/mcp-server.mjs",
23
- "mcp_config": {
24
- "command": "node",
25
- "args": ["${__dirname}/server/mcp-server.mjs"],
26
- "env": {
27
- "SOGNI_USERNAME": "${user_config.sogni_username}",
28
- "SOGNI_PASSWORD": "${user_config.sogni_password}",
29
- "SOGNI_CREDENTIALS_PATH": "${user_config.sogni_credentials_path}",
30
- "SOGNI_LAST_RENDER_PATH": "${user_config.sogni_last_render_path}",
31
- "SOGNI_MEDIA_INBOUND_DIR": "${user_config.sogni_media_inbound_dir}",
32
- "SOGNI_DOWNLOADS_DIR": "${user_config.sogni_downloads_dir}",
33
- "SOGNI_MCP_SAVE_DOWNLOADS": "${user_config.sogni_mcp_save_downloads}"
34
- }
35
- }
36
- },
37
- "user_config": {
38
- "sogni_username": {
39
- "type": "string",
40
- "title": "Sogni Username",
41
- "description": "Your Sogni AI username (sign up at https://app.sogni.ai/)",
42
- "required": false
43
- },
44
- "sogni_password": {
45
- "type": "string",
46
- "title": "Sogni Password",
47
- "description": "Your Sogni AI password",
48
- "required": false,
49
- "sensitive": true
50
- },
51
- "sogni_credentials_path": {
52
- "type": "string",
53
- "title": "Credentials File Path",
54
- "description": "Optional override for credentials file path (default: ~/.config/sogni/credentials)",
55
- "required": false
56
- },
57
- "sogni_last_render_path": {
58
- "type": "string",
59
- "title": "Last Render Path",
60
- "description": "Optional path for last-render metadata (default: ~/.config/sogni/last-render.json)",
61
- "required": false
62
- },
63
- "sogni_media_inbound_dir": {
64
- "type": "string",
65
- "title": "Inbound Media Directory",
66
- "description": "Directory used by --list-media (default: ~/.clawdbot/media/inbound)",
67
- "required": false
68
- },
69
- "sogni_downloads_dir": {
70
- "type": "string",
71
- "title": "MCP Downloads Directory",
72
- "description": "Where MCP saves local media copies (default: ~/Downloads/sogni)",
73
- "required": false
74
- },
75
- "sogni_mcp_save_downloads": {
76
- "type": "string",
77
- "title": "Save MCP Downloads",
78
- "description": "Set to 0 to disable writing local MCP media copies",
79
- "required": false
80
- }
81
- },
82
- "tools": [
83
- {
84
- "name": "generate_image",
85
- "description": "Generate an image from a text prompt"
86
- },
87
- {
88
- "name": "generate_video",
89
- "description": "Generate a video from a text prompt or reference image"
90
- },
91
- {
92
- "name": "edit_image",
93
- "description": "Edit an existing image with a text instruction"
94
- },
95
- {
96
- "name": "photobooth",
97
- "description": "Generate stylized portraits from a face photo"
98
- },
99
- {
100
- "name": "check_balance",
101
- "description": "Check Sogni token balances (SPARK and SOGNI)"
102
- },
103
- {
104
- "name": "list_models",
105
- "description": "List available image and video models"
106
- }
107
- ],
108
- "compatibility": {
109
- "platforms": ["darwin", "win32", "linux"],
110
- "runtimes": {
111
- "node": ">=22.11.0"
112
- }
113
- }
114
- }
@@ -1,4 +0,0 @@
1
- #!/usr/bin/env node
2
-
3
- // Keep desktop-extension entrypoint in sync by delegating to the root MCP server.
4
- import '../../mcp-server.mjs';
@@ -1,9 +0,0 @@
1
- {
2
- "name": "sogni-creative-agent-skill-desktop-server",
3
- "version": "2.0.1",
4
- "private": true,
5
- "type": "module",
6
- "engines": {
7
- "node": ">=22.11.0"
8
- }
9
- }
@@ -1,4 +0,0 @@
1
- #!/usr/bin/env node
2
-
3
- // Keep desktop-extension entrypoint in sync by delegating to the root CLI.
4
- import '../../sogni-agent.mjs';