Agent skills
We designed the Sume CLI commands to make agent automation explicit and auditable.
Use read-only first
While you plan, use read commands first:
Require confirmation for writes
Agents must not create resources without explicit operator confirmation. Agents must not submit paid provider work without explicit operator confirmation.
| Gate | Use for |
|---|---|
--confirm-submit | Non-paid writes such as job cancellation or asset registration. |
--confirm-paid | Generation that can reserve or spend credits (Avatar / Avatar Video). |
At this time, the CLI has no submit commands for Image, Video, and Music generation. For those families, agents must call the Developer API. Agents can still use CLI job recovery when it helps.
Redact sensitive output
When automation reads command output, use --agent --json. Where the CLI
supports it, agent mode redacts or summarizes URL-like fields and
account/workspace details.
Bundled skills
Use these commands to install or refresh the packaged Sume skill in the local agent skill directories:
sume skills install writes into .agents/skills or .claude/skills. Use
export to examine the source files before a custom install.
MCP for agents
For Cursor/Claude remote connectors, the best choice is
hosted MCP (https://mcp.sume.com/mcp). Local sume mcp is not
available in current CLI releases. Refer to sume mcp doctor --json and the
CLI command reference.
Recommended loop
- Examine the catalog and the local readiness.
- Use a read-only/schema command to validate the payload.
- Before writes or paid work, ask for confirmation.
- Submit one bounded job (the CLI for Avatar, the API for Image/Video/Music).
- Use the job status/events/result commands to recover.
- Summarize the outputs. Do not paste secrets or signed URLs.