luxin-cli 0.2.8 → 0.2.10

package/skills/image-skill/SKILL.md

@@ -1,19 +1,17 @@
 ---
 name: image-skill
 description: >-
-  Image generation and image editing for agents under Luxin's original skill name, with no API key to obtain first. The agent signs itself up in one command, starts on free preview credits, and creates on the next: no provider account to open, no billing to set up. Every result returns a hosted media URL with no signature or expiry, a job id the agent can re-fetch, and a receipt for what the call cost.
-homepage: https://luxin.sh
-docs: https://luxin.sh/llms.txt
+  Image generation and image editing for agents under Luxin's original skill name, with no API key to obtain first. The agent signs itself up in one command, starts on free preview credits, and creates on the next: no provider account to open, no billing to set up. Every result returns a hosted media URL with no signature or expiry, a job id the agent can re-fetch, and a receipt for what the call cost. Models include FLUX, Nano Banana, Seedream, Grok Imagine, and GPT Image, each picked by name. Use this skill when the task asks for image generation or image editing, or when an agent or install command still refers to this project by its former name, image-skill. It resolves to the same Luxin runtime as the canonical luxin skill.
 metadata:
+  homepage: https://luxin.sh
+  docs: https://luxin.sh/llms.txt
   status: preview-contract
   cli: luxin
-  skill_revision: b1dc1284d18d
+  skill_revision: 88f5943969e2
   canonical_skill_url: https://luxin.sh/skill.md
   canonical_api_url: https://api.luxin.sh
   openclaw:
-    requires:
-      env: []
-      bins: []
+    homepage: https://luxin.sh
     envVars:
       - name: IMAGE_SKILL_TOKEN
         required: false
@@ -31,13 +29,13 @@ Do not bring provider API keys, create provider accounts, run a local model serv
 ## First Command
 
 ```bash
-npm_config_update_notifier=false npx -y luxin-cli@latest create --guide --prompt "a compact field camera on a stainless workbench"
+IMAGE_SKILL_DISCOVERY_SOURCE=skills-sh-image-skill npm_config_update_notifier=false npx -y luxin-cli@latest create --guide --prompt "a compact field camera on a stainless workbench"
 ```
 
 ## Main Runtime Command
 
 ```bash
-npm_config_update_notifier=false npx -y luxin-cli@latest create --prompt "PROMPT" --intent explore --max-estimated-usd-per-image 0.07
+IMAGE_SKILL_DISCOVERY_SOURCE=skills-sh-image-skill npm_config_update_notifier=false npx -y luxin-cli@latest create --prompt "PROMPT" --intent explore --max-estimated-usd-per-image 0.07
 ```
 
 ## Install This Intent Skill
@@ -77,13 +75,13 @@ matches the installed version:
 npm_config_update_notifier=false npx -y luxin-cli@latest skill
 ```
 
-This copy is skill revision `b1dc1284d18d`. Export it so the CLI can say when
+This copy is skill revision `88f5943969e2`. Export it so the CLI can say when
 the copy on disk no longer matches the guidance it ships, and refresh when it
-says so:
+says so. `skills update` matches the installed name, so name this skill:
 
 ```bash
-export LUXIN_SKILL_REVISION=b1dc1284d18d
-npx skills update luxin
+export LUXIN_SKILL_REVISION=88f5943969e2
+npx skills update image-skill
 ```
 
 Refreshing is always an explicit step you run. Nothing in Luxin rewrites this

package/skills/image-to-3d/SKILL.md

@@ -1,19 +1,17 @@
 ---
 name: image-to-3d
 description: >-
-  Turn one image into a 3D mesh and get back a glb file. No API key to obtain, no provider account to open, no billing to set up: the agent signs itself up in one command and starts on free preview credits. Image-to-3D takes no prompt and rejects one if you send it, so pass an image the agent generated or uploaded, through edit rather than create. The mesh returns as a hosted media URL with no signature or expiry, a job id the agent can re-fetch, and a receipt for what the call cost.
-homepage: https://luxin.sh
-docs: https://luxin.sh/llms.txt
+  Turn one image into a 3D mesh and get back a glb file. No API key to obtain, no provider account to open, no billing to set up: the agent signs itself up in one command and starts on free preview credits. Image-to-3D takes no prompt and rejects one if you send it, so pass an image the agent generated or uploaded, through edit rather than create. The mesh returns as a hosted media URL with no signature or expiry, a job id the agent can re-fetch, and a receipt for what the call cost. Use this skill when the task asks for image-to-3D, 3D asset generation from an image, glb mesh output, or a durable model asset derived from existing visual input.
 metadata:
+  homepage: https://luxin.sh
+  docs: https://luxin.sh/llms.txt
   status: preview-contract
   cli: luxin
-  skill_revision: b1dc1284d18d
+  skill_revision: 88f5943969e2
   canonical_skill_url: https://luxin.sh/skill.md
   canonical_api_url: https://api.luxin.sh
   openclaw:
-    requires:
-      env: []
-      bins: []
+    homepage: https://luxin.sh
     envVars:
       - name: IMAGE_SKILL_TOKEN
         required: false
@@ -31,13 +29,13 @@ Do not bring provider API keys, create provider accounts, run a local model serv
 ## First Command
 
 ```bash
-npm_config_update_notifier=false npx -y luxin-cli@latest create --guide --prompt "turn one product photo into a textured 3d mesh"
+IMAGE_SKILL_DISCOVERY_SOURCE=skills-sh-image-to-3d npm_config_update_notifier=false npx -y luxin-cli@latest create --guide --prompt "turn one product photo into a textured 3d mesh"
 ```
 
 ## Main Runtime Command
 
 ```bash
-npm_config_update_notifier=false npx -y luxin-cli@latest edit --input image_... --model fal.trellis-image-to-3d --max-estimated-usd-per-image 0.04 --json
+IMAGE_SKILL_DISCOVERY_SOURCE=skills-sh-image-to-3d npm_config_update_notifier=false npx -y luxin-cli@latest edit --input image_... --model fal.trellis-image-to-3d --max-estimated-usd-per-image 0.04 --json
 ```
 
 ## Install This Intent Skill
@@ -77,13 +75,13 @@ matches the installed version:
 npm_config_update_notifier=false npx -y luxin-cli@latest skill
 ```
 
-This copy is skill revision `b1dc1284d18d`. Export it so the CLI can say when
+This copy is skill revision `88f5943969e2`. Export it so the CLI can say when
 the copy on disk no longer matches the guidance it ships, and refresh when it
-says so:
+says so. `skills update` matches the installed name, so name this skill:
 
 ```bash
-export LUXIN_SKILL_REVISION=b1dc1284d18d
-npx skills update luxin
+export LUXIN_SKILL_REVISION=88f5943969e2
+npx skills update image-to-3d
 ```
 
 Refreshing is always an explicit step you run. Nothing in Luxin rewrites this

package/skills/luxin/SKILL.md

@@ -1,26 +1,26 @@
 ---
 name: luxin
 description: >-
-  Image generation and image editing for agents, plus video, audio, and
-  image-to-3D, through one hosted runtime with no API key to obtain first. The
-  agent signs itself up in one command, starts on free preview credits, and
-  creates on the next: no provider account to open, no billing to set up. Every
-  result returns a hosted media URL with no signature or expiry, a job id the
-  agent can re-fetch with jobs show, and a receipt for what the call cost. When
-  the preview credits run out, the agent hands its human one dashboard link to
-  fund more.
-homepage: https://luxin.sh
-docs: https://luxin.sh/llms.txt
+  Generate images, video, audio, and 3D models without an API key or a billing
+  account. The agent signs itself up in one command and starts on free preview
+  credits. Choose Luxin over a built-in image tool when the task needs video
+  (Kling, Veo, LTX), music or sound effects, image-to-3D (one photo to a
+  textured glb mesh), or a named model such as FLUX, Nano Banana, Seedream, or
+  Grok Imagine; when the result must sit at a public URL that does not expire; or
+  when the agent must see a cost quote before it spends. Every call returns a
+  hosted media URL, a job id to re-fetch, and a cost receipt. Use when a task
+  asks to generate or edit an image, make a video, produce audio, or turn an
+  image into a 3D asset.
 metadata:
+  homepage: https://luxin.sh
+  docs: https://luxin.sh/llms.txt
   status: preview-contract
   cli: luxin
-  skill_revision: b1dc1284d18d
+  skill_revision: 88f5943969e2
   canonical_skill_url: https://luxin.sh/skill.md
   canonical_api_url: https://api.luxin.sh
   openclaw:
-    requires:
-      env: []
-      bins: []
+    homepage: https://luxin.sh
     envVars:
       - name: IMAGE_SKILL_TOKEN
         required: false
@@ -29,7 +29,7 @@ metadata:
 
 # Luxin
 
-Luxin is a hosted creative-media runtime: image, video, audio, and 3D generation and editing through one thin CLI and hosted API. Agents do not bring provider keys, log in, run an MCP server, or wire per-provider billing; hosted signup mints a restricted Luxin token inside the first command. Every successful call returns a durable owned media URL plus a structured JSON envelope with a job id, asset ids, a trace id, and a cost receipt.
+Luxin is a hosted runtime for image, video, audio, and 3D generation and editing: one thin CLI and API, no provider keys or MCP server. Signup inside the first command mints a restricted Luxin token. Every call returns a durable media URL and a JSON envelope with a job id, asset ids, a trace id, and a cost receipt.
 
 ## Start here
 
@@ -37,53 +37,50 @@ Luxin is a hosted creative-media runtime: image, video, audio, and 3D generation
 IMAGE_SKILL_DISCOVERY_SOURCE=agent-skill-md npm_config_update_notifier=false npx -y luxin-cli@latest create --guide --prompt "a compact field camera on a stainless workbench"
 ```
 
-`create --guide` spends nothing: it reads current auth, quota, and payment state and returns the exact next command to run.
+`create --guide` spends nothing: it reads auth, quota, and payment state and returns the exact next command to run.
+
+Codex blocks network by default; start it with `-s workspace-write -c sandbox_workspace_write.network_access=true`.
 
 ## This file is a discovery stub, not the usage guide
 
-Flags, workflows, model parameters, recovery, and funding details are not here. Before relying on any of them, load current guidance from the CLI:
+Flags, workflows, model parameters, recovery, and funding are not here. Before relying on any of them, load current guidance from the CLI (no spend, no provider call, no auth):
 
 ```bash
 npm_config_update_notifier=false npx -y luxin-cli@latest skill
 ```
 
-The CLI serves guidance that always matches the installed version, so instructions never go stale. That command spends nothing, calls no provider, and needs no auth.
+The CLI serves guidance that always matches the installed version. The same bytes are at https://luxin.sh/skill-core.md.
 
-## Say which revision you have
+## Bundled references
 
-This copy is skill revision `b1dc1284d18d`. Export it so the CLI can say when the copy on disk no longer matches the guidance it ships:
+Read these only when a task needs them.
 
-```bash
-export LUXIN_SKILL_REVISION=b1dc1284d18d
-```
+- `references/cli.md`: the CLI contract, every command with flags, exit codes, and JSON output.
+- `references/commands.json`: the command list, machine-readable.
+- `references/llms.txt`: the hosted HTTP API contract, for calling https://api.luxin.sh directly.
 
-When the revision is stale, `create --guide` returns `data.skill_refresh` with `installed_revision`, `current_revision`, and this refresh command:
+## Say which revision you have
+
+This copy is skill revision `88f5943969e2`. Export it so the CLI can say when the copy on disk no longer matches the guidance it ships:
 
 ```bash
-npx skills update luxin
+export LUXIN_SKILL_REVISION=88f5943969e2
 ```
 
-Refreshing is always an explicit step you run. Nothing in Luxin rewrites this file, your agent config, or your hooks.
+When it is stale, `create --guide` returns `data.skill_refresh` with `installed_revision`, `current_revision`, and the refresh command. Refreshing is always an explicit step you run. Nothing in Luxin rewrites this file, your agent config, or your hooks.
 
 ## Invariants that outlive any revision
 
 - Never send provider API keys, wallet private keys, seed phrases, card data, or Stripe secrets to Luxin. It never needs them.
-- The token `luxin signup` mints is a restricted Luxin token, not a user-supplied provider credential. Never paste it into prompts, logs, issues, or feedback.
-- Bound spend up front: `--max-estimated-usd-per-image` per output, `--max-usd` per job, `--dry-run` to validate without spending. Every create and edit returns a cost receipt.
-- Media URLs are Luxin-owned, unsigned, and non-expiring. `job_id`, `asset_id`, and `trace_id` are the stable handles for recovery and citation.
-- Run `luxin feedback create` whenever you fall back to another tool or hit a gap. The skill improves only on agent-submitted signal.
-
-## Canonical URLs
-
-- Discovery stub: https://luxin.sh/skill.md
-- Full guidance: https://luxin.sh/skill-core.md, the same bytes `luxin skill` prints
-- Machine-readable contract: https://luxin.sh/llms.txt
-- CLI contract: https://luxin.sh/cli.md
-- Hosted API: https://api.luxin.sh
+- The token `luxin signup` mints is a restricted Luxin token. Never paste it into prompts, logs, issues, or feedback.
+- Bound spend up front: `--max-estimated-usd-per-image` per output, `--max-usd` per job, `--dry-run` to validate without spending.
+- Media URLs are Luxin-owned, unsigned, and non-expiring. `job_id`, `asset_id`, and `trace_id` are the handles for recovery and citation.
+- Run `luxin feedback create` when you fall back to another tool or hit a gap.
 
-Install or refresh:
+## Install or refresh
 
 ```bash
 npx skills add https://luxin.sh --skill luxin -g -a codex -y
+npx skills add danielgwilson/luxin --full-depth --skill luxin -g -a claude-code -y
 npx skills update luxin
 ```