image-skill 0.1.34 → 0.1.36

package/skills/image-skill/SKILL.md

@@ -39,7 +39,7 @@ JSON is the default. Do not add `--json` to examples.
 npm_config_update_notifier=false npx -y image-skill@latest create --guide --prompt "a compact field camera on a stainless workbench"
 ```
 
-The guide is a free, zero-spend planning call. Given current auth, quota, and payment state, it returns one concrete `data.next_command` to run, plus `data.stage`, `data.guide_warning`, `data.next_command_effect`, `data.auth_ready`, `data.no_spend_evaluation`, `data.recommended_no_spend_command` (alias of `data.no_spend_next_command`), `data.no_spend_next_command_effect`, `data.self_fund_next_command`, `data.self_fund_handoff`, `data.auth_handoff`, and `data.mutation`. Read `data.guide_warning` before running `data.next_command`: `next_command_safety` names whether the command is no-spend setup, read-only inspection, live-money payment action, or live media create. Run that next command when the warning says it is safe for your spend policy. Repeat until `data.stage` is `ready_to_create`. At `ready_to_create`, `data.auth_ready.ready` and `data.auth_ready.next_command_auth_ready` are `true`: the returned create can reuse saved config, env token, or stdin token context without exposing a raw token. When `data.guide_warning.next_command_safety` is `live_media_create_credit_debit` and `data.no_spend_evaluation.stop_here` is `true`, `data.next_command` is the live create: run it only if media spend is allowed, otherwise stop before it and run `data.recommended_no_spend_command` for no-spend proof. The no-spend command is an authenticated hosted dry-run: it may create a recoverable `job.planned` receipt, but it has no provider call, credit debit, downloadable asset, or media write.
+The guide is a free, zero-spend planning call. Given current auth, quota, and payment state, it returns `data.next_command`, `data.next_command_copy_runnable`, `data.next_command_missing_inputs`, `data.stage`, `data.guide_warning`, `data.next_command_effect`, `data.auth_ready`, `data.no_spend_evaluation`, `data.recommended_no_spend_command` (alias of `data.no_spend_next_command`), `data.no_spend_next_command_effect`, `data.self_fund_next_command`, `data.self_fund_handoff`, `data.auth_handoff`, and `data.mutation`. Read `data.guide_warning` before running `data.next_command`: `next_command_safety` names whether the command is no-spend setup, read-only inspection, live-money payment action, or live media create. Run that next command only when `data.next_command_copy_runnable` is `true` and the warning says it is safe for your spend policy; when it is `false`, fill `data.next_command_missing_inputs` first. Repeat until `data.stage` is `ready_to_create`. At `ready_to_create`, `data.auth_ready.ready` and `data.auth_ready.next_command_auth_ready` are `true`: the returned create can reuse saved config, env token, or stdin token context without exposing a raw token. When `data.guide_warning.next_command_safety` is `live_media_create_credit_debit` and `data.no_spend_evaluation.stop_here` is `true`, `data.next_command` is the live create: run it only if media spend is allowed, otherwise stop before it and run `data.recommended_no_spend_command` for no-spend proof. The no-spend command is an authenticated hosted dry-run: it may create a recoverable `job.planned` receipt, but it has no provider call, credit debit, downloadable asset, or media write.
 
 Minimum success envelope on a create or edit:
 
@@ -133,7 +133,7 @@ image-skill usage quota
 
 If the runtime supports stdin secret handoff, prefer `--token-stdin` over `--token` for `whoami`, `usage quota`, `create`, and `feedback create`. The guide returns `data.auth_handoff` with copy-safe env and stdin command templates so the token never lands in prompts, logs, or feedback.
 
-If the default config home is read-only, set `IMAGE_SKILL_CONFIG_PATH` to a writable path before `signup`. Do not fall back to another tool because the install or default config directory is blocked. `create --guide` detects this and makes `data.next_command` a normal saved-config signup prefixed with `IMAGE_SKILL_CONFIG_PATH="$PWD/.image-skill/config.json"`; the `--show-token --no-save` plus `--token-stdin` route stays available only as structured fallback recovery.
+If the default config home is read-only, set `IMAGE_SKILL_CONFIG_PATH` to a writable path before `signup`. Do not fall back to another tool because the install or default config directory is blocked. `create --guide` detects this and makes `data.next_command` a saved-config signup template prefixed with `IMAGE_SKILL_CONFIG_PATH="$PWD/.image-skill/config.json"`; fill `data.next_command_missing_inputs` before running it. The `--show-token --no-save` plus `--token-stdin` route stays available only as structured fallback recovery.
 
 Install paths, in order of preference:
 
@@ -195,6 +195,8 @@ image-skill models list --available --modality video --operation video.generate
 image-skill models show openai.gpt-image-2
 ```
 
+`models list` is the compact, summary-first action menu. Use `models show MODEL_ID` for one model's full capability schema, or `models list --details` only when you intentionally need every model's full schema at once.
+
 `--available` filters to runnable rows (`status:"available"` and `execution.model_execution_status:"executable"`). Do not treat provider-level `status:"available"` as runnable. `--catalog-only` exposes research rows that are not runnable yet; inspect them, do not pass them to create or edit.
 
 Pass model-specific controls through validated JSON, not invented top-level flags:

package/skills/image-skill/references/cli.md

@@ -69,6 +69,11 @@ copyable commands, proof URL placeholders, and redaction guarantees.
 Use `trust` when deciding whether Image Skill is current and honest enough to
 select. It is not a required setup step before the first image; the canonical
 fresh-agent creative entrypoint remains `image-skill create --guide`.
+Agents may also use modality-first aliases when that is the natural wording:
+`image-skill image create --guide`, `image-skill video create --guide`,
+`image-skill audio create --guide`, and `image-skill 3d create --guide` all
+route into the same `create --guide` flow, with video/audio/3D intent hints
+added only when the agent did not already provide `--intent`.
 
 If package metadata, hosted docs, API health, or model availability cannot be
 verified, the command still returns a packet with explicit `unreachable`,
@@ -129,7 +134,8 @@ should omit it.
 Use the no-spend guide first. It is the only required first command for a fresh
 agent. It checks health, executable model availability, auth/quota when a token
 already exists, and payment rails, then returns one primary
-`data.next_command` plus machine-readable `data.next_command_effect`,
+`data.next_command` plus machine-readable `data.next_command_copy_runnable`,
+`data.next_command_missing_inputs`, `data.next_command_effect`,
 `data.guide_warning`, `data.auth_ready`, and `data.no_spend_evaluation`. Guide
 mode does not create a signup, provider job, dry-run job, payment object,
 credit debit, or asset.
@@ -138,22 +144,28 @@ credit debit, or asset.
 image-skill create --guide --prompt "a compact field camera on a stainless workbench"
 ```
 
-Read `data.stage` and `data.guide_warning`, run `data.next_command` when
-`data.guide_warning.next_command_safety` is safe for the current spend policy,
-and rerun the guide only after auth or payment state changes. Do not run
+Read `data.stage` and `data.guide_warning`, run `data.next_command` only when
+`data.next_command_copy_runnable` is `true` and
+`data.guide_warning.next_command_safety` is safe for the current spend policy.
+When `data.next_command_copy_runnable` is `false`, fill
+`data.next_command_missing_inputs` first. Rerun the guide only after auth or
+payment state changes. Do not run
 `doctor`, `models list`, `signup`, `whoami`, `usage quota`, `create --dry-run`,
 or payment commands as a setup checklist before the guide asks for them.
 
-- `prompt_required`: rerun `data.next_command` with the real prompt.
-- `auth_required`: run `data.next_command`, then rerun guide once. Hosted
-  signup saves auth to config by default. If the runtime intentionally used
+- `prompt_required`: fill `data.next_command_missing_inputs` with the real
+  prompt, then rerun `data.next_command`.
+- `auth_required`: fill `data.next_command_missing_inputs` when present, run
+  `data.next_command`, then rerun guide once. Hosted signup saves auth to
+  config by default. If the runtime intentionally used
   `--no-save --show-token`, store the returned token and use
   `data.auth_handoff.rerun_guide.with_env` or
   `data.auth_handoff.rerun_guide.with_stdin`. In this stage,
   `data.auth_ready.ready` is `false`, and
   `data.guide_warning.next_command_safety` is
   `hosted_signup_no_spend_setup`.
-- `quota_required`: run `data.self_fund_next_command` to start the top-up.
+- `quota_required`: fill `data.next_command_missing_inputs` when present, then
+  run `data.self_fund_next_command` to start the top-up.
   It aliases `data.next_command` and is the first payment command, usually an
   x402 or Stripe quote. If the guide authenticated from env or stdin, prefer
   `data.self_fund_handoff.auth.next_command.with_env` or
@@ -762,7 +774,7 @@ capability-preserving schema for one model.
 ```bash
 image-skill models --json
 image-skill models list --json
-image-skill models list --summary --json
+image-skill models list --details --json
 image-skill models list --available --operation image.generate --json
 image-skill models list --available --operation image.edit --json
 image-skill models list --available --modality video --operation video.generate --json
@@ -793,20 +805,23 @@ inspect the recommended create surface without knowing a provider-specific
 model id. The list response also returns `summary` with total, returned,
 available, executable, catalog-only, provider split,
 `execution_availability`, first actionable model ids, recommended filter
-commands, and catalog-inclusion flags. Default list output excludes
-catalog-only rows so fresh agents see executable candidates first. Use
-`--summary` when you need a compact, sortable model menu: each row keeps the
-model id, flat `estimated_usd_per_image`, `credits_required`, lightweight
-`task_tags`, status, provider, max output count/resolution, storage, and
-`show_command`, while omitting full parameter schemas. Use `--available` for
-currently usable executable rows, `--modality image|video|audio|3d` for media
-type, `--operation image.generate`, `--operation image.edit`,
-`--operation video.generate`, `--operation audio.generate`, or
-`--operation 3d.generate` for the task, `--provider fal|xai|openai` to narrow by
-provider, and `--catalog-only` when you intentionally want source-backed rows
-that are inspectable but not runnable yet. Provider-level availability is not
-the same thing as model executability; for runnable choices require both
-`status:"available"` and
+commands, and catalog-inclusion flags. Default list output is a compact,
+sortable model menu and excludes catalog-only rows so fresh agents see
+executable candidates first. Each row keeps the model id, flat
+`estimated_usd_per_image`, `credits_required`, lightweight `task_tags`, status,
+provider, max output count/resolution, storage, and `show_command`, while
+omitting full parameter schemas. Use `models show MODEL_ID --json` for one
+model's full capability schema, or `models list --details --json` only when you
+intentionally need the full list with capability schemas for compatibility or
+offline analysis. `--summary` is still accepted as a compatibility alias for the
+default compact list. Use `--available` for currently usable executable rows,
+`--modality image|video|audio|3d` for media type, `--operation
+image.generate`, `--operation image.edit`, `--operation video.generate`,
+`--operation audio.generate`, or `--operation 3d.generate` for the task,
+`--provider fal|xai|openai` to narrow by provider, and `--catalog-only` when you
+intentionally want source-backed rows that are inspectable but not runnable yet.
+Provider-level availability is not the same thing as model executability; for
+runnable choices require both `status:"available"` and
 `execution.model_execution_status:"executable"`. If a reachable provider has no
 runnable model for the requested operation, `summary.execution_availability`
 says so directly and includes the fastest `--available --operation ...`
@@ -894,13 +909,15 @@ image-skill create --guide --prompt "A compact field camera on a stainless workb
 ```
 
 `create --guide` returns `schema: image-skill.create-guide.v1`,
-`stage`, `next_command`, `guide_warning`, `auth_ready`, `no_spend_evaluation`,
-`recommended_no_spend_command`,
+`stage`, `next_command`, `next_command_copy_runnable`,
+`next_command_missing_inputs`, `guide_warning`, `auth_ready`,
+`no_spend_evaluation`, `recommended_no_spend_command`,
 `self_fund_next_command`, `self_fund_handoff`, `escape_hatches`, selected
 executable model and cost, auth/quota/payment blockers, and mutation flags. All
 mutation flags must be false in guide mode: no provider call, hosted create,
 signup, payment object, credit debit, or media write.
-For next-command safety, read `guide_warning.next_command_safety` before
+For next-command safety, read `next_command_copy_runnable`,
+`next_command_missing_inputs`, and `guide_warning.next_command_safety` before
 acting: `hosted_signup_no_spend_setup` is no-spend auth setup,
 `live_money_payment_action` is top-up/payment work, and
 `live_media_create_credit_debit` is a live create that can call a provider,

package/skills/image-skill/references/commands.json

@@ -0,0 +1,515 @@
+{
+  "schema": "image-skill.public-command-manifest.v1",
+  "command_prefix": "image-skill",
+  "product_frame": "Image Skill is a hosted thin CLI and public contract for agent-native durable creative media.",
+  "skill_url": "https://image-skill.com/skill.md",
+  "docs_url": "https://image-skill.com/cli.md",
+  "llms_url": "https://image-skill.com/llms.txt",
+  "commands": [
+    {
+      "id": "doctor",
+      "docs_anchor": "image-skill-doctor",
+      "surface": "client",
+      "mutation": false,
+      "spend": false
+    },
+    {
+      "id": "trust",
+      "docs_anchor": "image-skill-trust",
+      "surface": "client",
+      "mutation": false,
+      "spend": false
+    },
+    {
+      "id": "signup",
+      "docs_anchor": "image-skill-signup-agent",
+      "surface": "hosted_cli",
+      "mutation": true,
+      "spend": false
+    },
+    {
+      "id": "whoami",
+      "docs_anchor": "image-skill-whoami",
+      "surface": "hosted_cli",
+      "mutation": false,
+      "spend": false
+    },
+    {
+      "id": "usage",
+      "docs_anchor": "image-skill-usage",
+      "surface": "hosted_cli",
+      "mutation": false,
+      "spend": false,
+      "subcommands": ["quota"]
+    },
+    {
+      "id": "quota",
+      "docs_anchor": "image-skill-quota",
+      "surface": "hosted_cli",
+      "mutation": false,
+      "spend": false
+    },
+    {
+      "id": "credits",
+      "docs_anchor": "image-skill-credits",
+      "surface": "hosted_cli",
+      "mutation": true,
+      "spend": true,
+      "subcommands": ["methods", "packs list", "quote", "buy", "status"]
+    },
+    {
+      "id": "capabilities",
+      "docs_anchor": "image-skill-capabilities",
+      "surface": "hosted_cli",
+      "mutation": false,
+      "spend": false,
+      "subcommands": ["list", "show"]
+    },
+    {
+      "id": "models",
+      "docs_anchor": "image-skill-models",
+      "surface": "hosted_cli",
+      "mutation": false,
+      "spend": false,
+      "subcommands": ["list", "show"]
+    },
+    {
+      "id": "create",
+      "docs_anchor": "image-skill-create",
+      "surface": "hosted_cli",
+      "mutation": true,
+      "spend": true
+    },
+    {
+      "id": "upload",
+      "docs_anchor": "image-skill-upload",
+      "surface": "client",
+      "mutation": true,
+      "spend": false
+    },
+    {
+      "id": "edit",
+      "docs_anchor": "image-skill-edit",
+      "surface": "client",
+      "mutation": true,
+      "spend": true
+    },
+    {
+      "id": "assets",
+      "docs_anchor": "image-skill-assets",
+      "surface": "hosted_cli",
+      "mutation": false,
+      "spend": false,
+      "subcommands": ["show", "get"]
+    },
+    {
+      "id": "jobs",
+      "docs_anchor": "image-skill-jobs",
+      "surface": "hosted_cli",
+      "mutation": false,
+      "spend": false,
+      "subcommands": ["show", "wait"]
+    },
+    {
+      "id": "activity",
+      "docs_anchor": "image-skill-activity",
+      "surface": "hosted_cli",
+      "mutation": false,
+      "spend": false,
+      "subcommands": ["list", "show"]
+    },
+    {
+      "id": "feedback",
+      "docs_anchor": "image-skill-feedback",
+      "surface": "hosted_cli",
+      "mutation": true,
+      "spend": false,
+      "subcommands": ["create"]
+    }
+  ],
+  "modality_aliases": [
+    { "alias": "image", "command": "create", "intent": null },
+    { "alias": "video", "command": "create", "intent": "video" },
+    { "alias": "audio", "command": "create", "intent": "audio" },
+    { "alias": "3d", "command": "create", "intent": "image-to-3d" },
+    { "alias": "image-to-3d", "command": "create", "intent": "image-to-3d" },
+    { "alias": "three-d", "command": "create", "intent": "image-to-3d" }
+  ],
+  "help_entries": [
+    {
+      "key": "",
+      "help": {
+        "command": "help",
+        "usage": "image-skill <doctor|trust|signup|whoami|usage|quota|credits|capabilities|models|create|upload|edit|assets|jobs|activity|feedback> --json",
+        "docs_url": "https://image-skill.com/cli.md",
+        "commands": [
+          "doctor",
+          "trust",
+          "signup --agent --agent-contact --agent-name NAME --runtime RUNTIME",
+          "whoami",
+          "usage quota",
+          "quota",
+          "credits methods",
+          "credits quote",
+          "credits packs list",
+          "credits buy",
+          "credits status",
+          "capabilities",
+          "capabilities list",
+          "capabilities show",
+          "models",
+          "models list",
+          "models show",
+          "create --guide",
+          "image create --guide",
+          "video create --guide",
+          "audio create --guide",
+          "3d create --guide",
+          "create --dry-run",
+          "create",
+          "image edit",
+          "upload",
+          "edit",
+          "assets show",
+          "assets get",
+          "jobs show",
+          "jobs wait",
+          "activity list",
+          "activity show",
+          "feedback create"
+        ]
+      }
+    },
+    {
+      "key": "doctor",
+      "help": {
+        "command": "image-skill doctor help",
+        "usage": "image-skill doctor --json",
+        "docs_url": "https://image-skill.com/cli.md#image-skill-doctor",
+        "description": "Check hosted API reachability, CLI version, auth state, and health."
+      }
+    },
+    {
+      "key": "trust",
+      "help": {
+        "command": "image-skill trust help",
+        "usage": "image-skill trust --json",
+        "docs_url": "https://image-skill.com/cli.md#image-skill-trust",
+        "description": "Return npm provenance, hosted contract hashes, API health, and model availability evidence."
+      }
+    },
+    {
+      "key": "signup",
+      "help": {
+        "command": "image-skill signup help",
+        "usage": "image-skill signup --agent --agent-contact AGENT_OR_OPERATOR_INBOX --agent-name NAME --runtime RUNTIME --json",
+        "docs_url": "https://image-skill.com/cli.md#image-skill-signup-agent",
+        "required_flags": [
+          "--agent",
+          "--agent-contact",
+          "--agent-name",
+          "--runtime"
+        ],
+        "optional_flags": ["--show-token", "--no-save", "--token-stdin"]
+      }
+    },
+    {
+      "key": "whoami",
+      "help": {
+        "command": "image-skill whoami help",
+        "usage": "image-skill whoami --json",
+        "docs_url": "https://image-skill.com/cli.md#image-skill-whoami"
+      }
+    },
+    {
+      "key": "usage",
+      "help": {
+        "command": "image-skill usage help",
+        "usage": "image-skill usage quota --json",
+        "docs_url": "https://image-skill.com/cli.md#image-skill-usage",
+        "subcommands": ["quota"]
+      }
+    },
+    {
+      "key": "usage quota",
+      "help": {
+        "command": "image-skill usage quota help",
+        "usage": "image-skill usage quota --json",
+        "docs_url": "https://image-skill.com/cli.md#image-skill-usage"
+      }
+    },
+    {
+      "key": "quota",
+      "help": {
+        "command": "image-skill quota help",
+        "usage": "image-skill quota --json",
+        "docs_url": "https://image-skill.com/cli.md#image-skill-quota"
+      }
+    },
+    {
+      "key": "credits",
+      "help": {
+        "command": "image-skill credits help",
+        "usage": "image-skill credits <methods|packs list|quote|buy|status> --json",
+        "docs_url": "https://image-skill.com/cli.md#image-skill-credits",
+        "subcommands": ["methods", "packs list", "quote", "buy", "status"]
+      }
+    },
+    {
+      "key": "credits methods",
+      "help": {
+        "command": "image-skill credits methods help",
+        "usage": "image-skill credits methods",
+        "docs_url": "https://image-skill.com/cli.md#image-skill-credits"
+      }
+    },
+    {
+      "key": "credits packs",
+      "help": {
+        "command": "image-skill credits packs help",
+        "usage": "image-skill credits packs list --json",
+        "docs_url": "https://image-skill.com/cli.md#image-skill-credits",
+        "subcommands": ["list"]
+      }
+    },
+    {
+      "key": "credits quote",
+      "help": {
+        "command": "image-skill credits quote help",
+        "usage": "image-skill credits quote --pack PACK_ID --payment-method stripe_x402.exact.usdc --json",
+        "docs_url": "https://image-skill.com/cli.md#image-skill-credits",
+        "required_flags": ["--pack or --credits", "--payment-method"],
+        "optional_flags": ["--idempotency-key"]
+      }
+    },
+    {
+      "key": "credits buy",
+      "help": {
+        "command": "image-skill credits buy help",
+        "usage": "image-skill credits buy --provider stripe_x402 --quote-id QUOTE_ID --idempotency-key KEY --json",
+        "docs_url": "https://image-skill.com/cli.md#image-skill-credits",
+        "required_flags": ["--provider", "--quote-id", "--idempotency-key"],
+        "supported_providers": ["stripe", "stripe_x402"]
+      }
+    },
+    {
+      "key": "credits status",
+      "help": {
+        "command": "image-skill credits status help",
+        "usage": "image-skill credits status --payment-attempt-id PAYMENT_ATTEMPT_ID --json",
+        "docs_url": "https://image-skill.com/cli.md#image-skill-credits",
+        "required_flags": ["--payment-attempt-id"]
+      }
+    },
+    {
+      "key": "capabilities",
+      "help": {
+        "command": "image-skill capabilities help",
+        "usage": "image-skill capabilities <list|show> --json",
+        "docs_url": "https://image-skill.com/cli.md#image-skill-capabilities",
+        "subcommands": ["list", "show"]
+      }
+    },
+    {
+      "key": "capabilities list",
+      "help": {
+        "command": "image-skill capabilities list help",
+        "usage": "image-skill capabilities list --json",
+        "docs_url": "https://image-skill.com/cli.md#image-skill-capabilities"
+      }
+    },
+    {
+      "key": "capabilities show",
+      "help": {
+        "command": "image-skill capabilities show help",
+        "usage": "image-skill capabilities show CAPABILITY_ID --json",
+        "docs_url": "https://image-skill.com/cli.md#image-skill-capabilities"
+      }
+    },
+    {
+      "key": "models",
+      "help": {
+        "command": "image-skill models help",
+        "usage": "image-skill models <list|show> --json",
+        "docs_url": "https://image-skill.com/cli.md#image-skill-models",
+        "subcommands": ["list", "show"]
+      }
+    },
+    {
+      "key": "models list",
+      "help": {
+        "command": "image-skill models list help",
+        "usage": "image-skill models list --available --operation image.generate --json",
+        "docs_url": "https://image-skill.com/cli.md#image-skill-models",
+        "optional_flags": [
+          "--available",
+          "--executable",
+          "--catalog-only",
+          "--operation",
+          "--modality",
+          "--provider",
+          "--summary",
+          "--details"
+        ]
+      }
+    },
+    {
+      "key": "models show",
+      "help": {
+        "command": "image-skill models show help",
+        "usage": "image-skill models show MODEL_ID --json",
+        "docs_url": "https://image-skill.com/cli.md#image-skill-models"
+      }
+    },
+    {
+      "key": "create",
+      "help": {
+        "command": "image-skill create help",
+        "usage": "image-skill create --prompt \"...\" --intent explore --max-estimated-usd-per-image 0.07 --json",
+        "docs_url": "https://image-skill.com/cli.md#image-skill-create",
+        "optional_flags": [
+          "--guide",
+          "--dry-run",
+          "--model",
+          "--aspect-ratio",
+          "--output-count",
+          "--element-frontal",
+          "--element-reference",
+          "--reference-image",
+          "--model-parameters-json",
+          "--idempotency-key"
+        ]
+      }
+    },
+    {
+      "key": "upload",
+      "help": {
+        "command": "image-skill upload help",
+        "usage": "image-skill upload PATH_OR_URL --json",
+        "docs_url": "https://image-skill.com/cli.md#image-skill-upload"
+      }
+    },
+    {
+      "key": "edit",
+      "help": {
+        "command": "image-skill edit help",
+        "usage": "image-skill edit --input image_... --prompt \"...\" --json",
+        "docs_url": "https://image-skill.com/cli.md#image-skill-edit",
+        "required_flags": ["--input"],
+        "optional_flags": [
+          "--dry-run",
+          "--prompt",
+          "--model",
+          "--mask",
+          "--element-reference",
+          "--element-frontal",
+          "--reference-image",
+          "--model-parameters-json",
+          "--idempotency-key"
+        ]
+      }
+    },
+    {
+      "key": "assets",
+      "help": {
+        "command": "image-skill assets help",
+        "usage": "image-skill assets <show|get> ASSET_ID_OR_URL --json",
+        "docs_url": "https://image-skill.com/cli.md#image-skill-assets",
+        "subcommands": ["show", "get"]
+      }
+    },
+    {
+      "key": "assets show",
+      "help": {
+        "command": "image-skill assets show help",
+        "usage": "image-skill assets show ASSET_ID_OR_URL --json",
+        "docs_url": "https://image-skill.com/cli.md#image-skill-assets"
+      }
+    },
+    {
+      "key": "assets get",
+      "help": {
+        "command": "image-skill assets get help",
+        "usage": "image-skill assets get ASSET_ID_OR_URL --output PATH --json",
+        "docs_url": "https://image-skill.com/cli.md#image-skill-assets"
+      }
+    },
+    {
+      "key": "jobs",
+      "help": {
+        "command": "image-skill jobs help",
+        "usage": "image-skill jobs <show|wait> JOB_ID --json",
+        "docs_url": "https://image-skill.com/cli.md#image-skill-jobs",
+        "subcommands": ["show", "wait"]
+      }
+    },
+    {
+      "key": "jobs show",
+      "help": {
+        "command": "image-skill jobs show help",
+        "usage": "image-skill jobs show JOB_ID --json",
+        "docs_url": "https://image-skill.com/cli.md#image-skill-jobs"
+      }
+    },
+    {
+      "key": "jobs wait",
+      "help": {
+        "command": "image-skill jobs wait help",
+        "usage": "image-skill jobs wait JOB_ID --timeout-ms 30000 --json",
+        "docs_url": "https://image-skill.com/cli.md#image-skill-jobs"
+      }
+    },
+    {
+      "key": "activity",
+      "help": {
+        "command": "image-skill activity help",
+        "usage": "image-skill activity <list|show> --json",
+        "docs_url": "https://image-skill.com/cli.md#image-skill-activity",
+        "subcommands": ["list", "show"]
+      }
+    },
+    {
+      "key": "activity list",
+      "help": {
+        "command": "image-skill activity list help",
+        "usage": "image-skill activity list --subject JOB_ID --json",
+        "docs_url": "https://image-skill.com/cli.md#image-skill-activity"
+      }
+    },
+    {
+      "key": "activity show",
+      "help": {
+        "command": "image-skill activity show help",
+        "usage": "image-skill activity show REFERENCE --json",
+        "docs_url": "https://image-skill.com/cli.md#image-skill-activity"
+      }
+    },
+    {
+      "key": "feedback",
+      "help": {
+        "command": "image-skill feedback help",
+        "usage": "image-skill feedback create --title TITLE --body BODY --json",
+        "docs_url": "https://image-skill.com/cli.md#image-skill-feedback",
+        "subcommands": ["create"]
+      }
+    },
+    {
+      "key": "feedback create",
+      "help": {
+        "command": "image-skill feedback create help",
+        "usage": "image-skill feedback create --title TITLE --body BODY --type user_feedback --json",
+        "docs_url": "https://image-skill.com/cli.md#image-skill-feedback",
+        "optional_flags": [
+          "--title",
+          "--body",
+          "--type",
+          "--severity",
+          "--confidence",
+          "--expected",
+          "--actual",
+          "--command"
+        ]
+      }
+    }
+  ]
+}