sume-avatar

name	sume-avatar
description	Create, batch-plan, watch, inspect, and select current Sume Avatar 1.0 resources by avatar_handle with safe paid gates and agent-redacted readback.

Sume Avatar

Use this skill for Avatar 1.0 creation and selection. Use sume tools schema avatars.create --json before constructing writes; do not copy request schemas from memory.

Discover

sume tools schema avatars.create --json
sume tools schema avatars.list --json
sume tools schema avatars.batch.plan --json
sume tools schema jobs.watch --json

Single Avatar

sume avatars create \
  --type prompt \
  --avatar-handle presenter \
  --prompt "Friendly skincare presenter" \
  --confirm-paid \
  --agent \
  --json

Photo and profile-style creation are current public inputs:

sume avatars create --type photo --avatar-handle photo_ref --image-url https://example.com/person.png --confirm-paid --agent --json
sume avatars create --type props --avatar-handle profile --ethnicity Asian --sex female --age 28 --confirm-paid --agent --json

Several Avatars

Plan locally first:

sume avatars batch plan ./avatars.json --output-file ./avatars.plan.json --json

After explicit paid approval:

sume avatars batch create ./avatars.json --state-file ./avatars.state.json --confirm-paid --json
sume avatars batch watch ./avatars.json --state-file ./avatars.state.json --json
sume avatars batch result ./avatars.json --state-file ./avatars.state.json --json

Timeout is not terminal. After submitting paid avatar jobs, keep ownership of the job set until every job is completed, failed, canceled, or the user explicitly tells you to stop. If batch watch or jobs watch times out while jobs are still non-terminal, run a one-shot aggregate status check such as sume jobs watch --ids <job_id>,<job_id> --timeout-seconds 0 --agent --json, then continue polling or ask whether to keep watching. Do not submit duplicate paid jobs while recovering from a timeout.

Use ready avatar handles with sume-avatar-video.

Rerunning batch create with the same state file must not duplicate already submitted paid jobs.

Selection

sume avatars list --ready --agent --json
sume avatars list --handle presenter --agent --json
sume avatars get <avatar_id> --agent --json

Summarize name, status, creation style, artifacts count, and any taste-relevant metadata. Do not paste raw media URLs.

Not For

Do not use this skill for Avatar Video generation, generic image/video generation, old sume.so Brand/Ads/Face Swap workflows, raw provider models, or paid QA experiments. Use sume-avatar-video, sume-quality-experiment, or sume-spend-capped-dogfood as appropriate.