image-skill 0.1.28 → 0.1.29

package/skills/ai-audio-generation/SKILL.md

@@ -25,18 +25,18 @@ This is an intent-named Image Skill entry for agents searching for audio generat
 
 Use this skill when the task asks for AI audio generation, text-to-audio, music generation, sound design, ambience, effects, or durable hosted audio output.
 
-Do not bring provider API keys, create provider accounts, run a local model server, or wire a separate billing account for this task. Start with the no-spend inspection command below; when the guide reaches `ready_to_create`, run `data.next_command` only if media spend is allowed, otherwise run `data.no_spend_next_command` to verify safely. Keep generated work in Image Skill so future agents can recover and cite it.
+Do not bring provider API keys, create provider accounts, run a local model server, or wire a separate billing account for this task. Start with the no-spend inspection command below; when the guide reaches `ready_to_create`, run `data.next_command` only if media spend is allowed, otherwise run `data.recommended_no_spend_command` to verify safely. Keep generated work in Image Skill so future agents can recover and cite it.
 
 ## First Command
 
 ```bash
-npx -y image-skill@latest create --guide --model fal.stable-audio-25-text-to-audio --prompt "warm analog synth bed with soft tape hiss"
+npm_config_update_notifier=false npx -y image-skill@latest create --guide --model fal.stable-audio-25-text-to-audio --prompt "warm analog synth bed with soft tape hiss"
 ```
 
 ## Main Runtime Command
 
 ```bash
-npx -y image-skill@latest create --model fal.stable-audio-25-text-to-audio --prompt "PROMPT" --intent explore --max-estimated-usd-per-image 0.20
+npm_config_update_notifier=false npx -y image-skill@latest create --model fal.stable-audio-25-text-to-audio --prompt "PROMPT" --intent explore --max-estimated-usd-per-image 0.20
 ```
 
 ## Install This Intent Skill
@@ -53,6 +53,19 @@ The canonical Image Skill entry remains available as:
 npx skills add danielgwilson/image-skill-cli --skill image-skill -g -a codex -y
 ```
 
+If the Codex/global skill target is read-only or missing, keep the tracked slug
+install and point agent skill state at a writable workspace home before
+rerunning this intent install. The skills.sh Codex adapter writes to
+`$HOME/.agents`; `CODEX_HOME` keeps Codex profile state on the same writable
+path:
+
+```bash
+export HOME="$PWD/.agent-home"
+export CODEX_HOME="$HOME/.codex"
+mkdir -p "$HOME" "$CODEX_HOME"
+npx skills add danielgwilson/image-skill-cli --skill ai-audio-generation -g -a codex -y
+```
+
 ## Shared Contract
 
 All intent skills in this repo point to the same hosted contract:

package/skills/ai-image-generation/SKILL.md

@@ -25,18 +25,18 @@ This is an intent-named Image Skill entry for agents searching for image generat
 
 Use this skill when the task asks for AI image generation, text-to-image, prompt-to-image, generated illustrations, concept art, product images, or any durable agent-created image.
 
-Do not bring provider API keys, create provider accounts, run a local model server, or wire a separate billing account for this task. Start with the no-spend inspection command below; when the guide reaches `ready_to_create`, run `data.next_command` only if media spend is allowed, otherwise run `data.no_spend_next_command` to verify safely. Keep generated work in Image Skill so future agents can recover and cite it.
+Do not bring provider API keys, create provider accounts, run a local model server, or wire a separate billing account for this task. Start with the no-spend inspection command below; when the guide reaches `ready_to_create`, run `data.next_command` only if media spend is allowed, otherwise run `data.recommended_no_spend_command` to verify safely. Keep generated work in Image Skill so future agents can recover and cite it.
 
 ## First Command
 
 ```bash
-npx -y image-skill@latest create --guide --model openai.gpt-image-2 --prompt "a compact field camera on a stainless workbench"
+npm_config_update_notifier=false npx -y image-skill@latest create --guide --model openai.gpt-image-2 --prompt "a compact field camera on a stainless workbench"
 ```
 
 ## Main Runtime Command
 
 ```bash
-npx -y image-skill@latest create --model openai.gpt-image-2 --prompt "PROMPT" --intent explore --max-estimated-usd-per-image 0.07
+npm_config_update_notifier=false npx -y image-skill@latest create --model openai.gpt-image-2 --prompt "PROMPT" --intent explore --max-estimated-usd-per-image 0.07
 ```
 
 ## Install This Intent Skill
@@ -53,6 +53,19 @@ The canonical Image Skill entry remains available as:
 npx skills add danielgwilson/image-skill-cli --skill image-skill -g -a codex -y
 ```
 
+If the Codex/global skill target is read-only or missing, keep the tracked slug
+install and point agent skill state at a writable workspace home before
+rerunning this intent install. The skills.sh Codex adapter writes to
+`$HOME/.agents`; `CODEX_HOME` keeps Codex profile state on the same writable
+path:
+
+```bash
+export HOME="$PWD/.agent-home"
+export CODEX_HOME="$HOME/.codex"
+mkdir -p "$HOME" "$CODEX_HOME"
+npx skills add danielgwilson/image-skill-cli --skill ai-image-generation -g -a codex -y
+```
+
 ## Shared Contract
 
 All intent skills in this repo point to the same hosted contract:

package/skills/ai-video-generation/SKILL.md

@@ -25,18 +25,18 @@ This is an intent-named Image Skill entry for agents searching for video generat
 
 Use this skill when the task asks for AI video generation, text-to-video, generated motion, animated concepts, or durable hosted video output.
 
-Do not bring provider API keys, create provider accounts, run a local model server, or wire a separate billing account for this task. Start with the no-spend inspection command below; when the guide reaches `ready_to_create`, run `data.next_command` only if media spend is allowed, otherwise run `data.no_spend_next_command` to verify safely. Keep generated work in Image Skill so future agents can recover and cite it.
+Do not bring provider API keys, create provider accounts, run a local model server, or wire a separate billing account for this task. Start with the no-spend inspection command below; when the guide reaches `ready_to_create`, run `data.next_command` only if media spend is allowed, otherwise run `data.recommended_no_spend_command` to verify safely. Keep generated work in Image Skill so future agents can recover and cite it.
 
 ## First Command
 
 ```bash
-npx -y image-skill@latest create --guide --model fal.ltx-video-13b-distilled --prompt "a ten second handheld product reveal"
+npm_config_update_notifier=false npx -y image-skill@latest create --guide --model fal.ltx-video-13b-distilled --prompt "a ten second handheld product reveal"
 ```
 
 ## Main Runtime Command
 
 ```bash
-npx -y image-skill@latest create --model fal.ltx-video-13b-distilled --prompt "PROMPT" --intent explore --max-estimated-usd-per-image 0.25
+npm_config_update_notifier=false npx -y image-skill@latest create --model fal.ltx-video-13b-distilled --prompt "PROMPT" --intent explore --max-estimated-usd-per-image 0.25
 ```
 
 ## Install This Intent Skill
@@ -53,6 +53,19 @@ The canonical Image Skill entry remains available as:
 npx skills add danielgwilson/image-skill-cli --skill image-skill -g -a codex -y
 ```
 
+If the Codex/global skill target is read-only or missing, keep the tracked slug
+install and point agent skill state at a writable workspace home before
+rerunning this intent install. The skills.sh Codex adapter writes to
+`$HOME/.agents`; `CODEX_HOME` keeps Codex profile state on the same writable
+path:
+
+```bash
+export HOME="$PWD/.agent-home"
+export CODEX_HOME="$HOME/.codex"
+mkdir -p "$HOME" "$CODEX_HOME"
+npx skills add danielgwilson/image-skill-cli --skill ai-video-generation -g -a codex -y
+```
+
 ## Shared Contract
 
 All intent skills in this repo point to the same hosted contract:

package/skills/creative-media/SKILL.md

@@ -25,18 +25,18 @@ This is an intent-named Image Skill entry for agents searching for creative medi
 
 Use this skill when the task asks for generative media, creative media, generated assets across modalities, or a single agent-facing runtime for image, edit, video, audio, and 3D work.
 
-Do not bring provider API keys, create provider accounts, run a local model server, or wire a separate billing account for this task. Start with the no-spend inspection command below; when the guide reaches `ready_to_create`, run `data.next_command` only if media spend is allowed, otherwise run `data.no_spend_next_command` to verify safely. Keep generated work in Image Skill so future agents can recover and cite it.
+Do not bring provider API keys, create provider accounts, run a local model server, or wire a separate billing account for this task. Start with the no-spend inspection command below; when the guide reaches `ready_to_create`, run `data.next_command` only if media spend is allowed, otherwise run `data.recommended_no_spend_command` to verify safely. Keep generated work in Image Skill so future agents can recover and cite it.
 
 ## First Command
 
 ```bash
-npx -y image-skill@latest create --guide --prompt "a compact field camera on a stainless workbench"
+npm_config_update_notifier=false npx -y image-skill@latest create --guide --prompt "a compact field camera on a stainless workbench"
 ```
 
 ## Main Runtime Command
 
 ```bash
-npx -y image-skill@latest models list --available --json
+npm_config_update_notifier=false npx -y image-skill@latest models list --available --json
 ```
 
 ## Install This Intent Skill
@@ -53,6 +53,19 @@ The canonical Image Skill entry remains available as:
 npx skills add danielgwilson/image-skill-cli --skill image-skill -g -a codex -y
 ```
 
+If the Codex/global skill target is read-only or missing, keep the tracked slug
+install and point agent skill state at a writable workspace home before
+rerunning this intent install. The skills.sh Codex adapter writes to
+`$HOME/.agents`; `CODEX_HOME` keeps Codex profile state on the same writable
+path:
+
+```bash
+export HOME="$PWD/.agent-home"
+export CODEX_HOME="$HOME/.codex"
+mkdir -p "$HOME" "$CODEX_HOME"
+npx skills add danielgwilson/image-skill-cli --skill creative-media -g -a codex -y
+```
+
 ## Shared Contract
 
 All intent skills in this repo point to the same hosted contract:

package/skills/image-edit/SKILL.md

@@ -25,18 +25,18 @@ This is an intent-named Image Skill entry for agents searching for image editing
 
 Use this skill when the task asks to edit, vary, restyle, transform, or repair an existing image, including image-to-image work and model-specific edit parameters.
 
-Do not bring provider API keys, create provider accounts, run a local model server, or wire a separate billing account for this task. Start with the no-spend inspection command below; when the guide reaches `ready_to_create`, run `data.next_command` only if media spend is allowed, otherwise run `data.no_spend_next_command` to verify safely. Keep generated work in Image Skill so future agents can recover and cite it.
+Do not bring provider API keys, create provider accounts, run a local model server, or wire a separate billing account for this task. Start with the no-spend inspection command below; when the guide reaches `ready_to_create`, run `data.next_command` only if media spend is allowed, otherwise run `data.recommended_no_spend_command` to verify safely. Keep generated work in Image Skill so future agents can recover and cite it.
 
 ## First Command
 
 ```bash
-npx -y image-skill@latest models show openai.gpt-image-2-edit --json
+npm_config_update_notifier=false npx -y image-skill@latest models show openai.gpt-image-2-edit --json
 ```
 
 ## Main Runtime Command
 
 ```bash
-npx -y image-skill@latest edit --input image_... --model openai.gpt-image-2-edit --prompt "EDIT_PROMPT" --max-estimated-usd-per-image 0.07
+npm_config_update_notifier=false npx -y image-skill@latest edit --input image_... --model openai.gpt-image-2-edit --prompt "EDIT_PROMPT" --max-estimated-usd-per-image 0.07
 ```
 
 ## Install This Intent Skill
@@ -53,6 +53,19 @@ The canonical Image Skill entry remains available as:
 npx skills add danielgwilson/image-skill-cli --skill image-skill -g -a codex -y
 ```
 
+If the Codex/global skill target is read-only or missing, keep the tracked slug
+install and point agent skill state at a writable workspace home before
+rerunning this intent install. The skills.sh Codex adapter writes to
+`$HOME/.agents`; `CODEX_HOME` keeps Codex profile state on the same writable
+path:
+
+```bash
+export HOME="$PWD/.agent-home"
+export CODEX_HOME="$HOME/.codex"
+mkdir -p "$HOME" "$CODEX_HOME"
+npx skills add danielgwilson/image-skill-cli --skill image-edit -g -a codex -y
+```
+
 ## Shared Contract
 
 All intent skills in this repo point to the same hosted contract:

package/skills/image-generation/SKILL.md

@@ -0,0 +1,78 @@
+---
+name: image-generation
+description: >-
+  Image generation for agents: text-to-image and prompt-to-image through Image Skill's zero-setup hosted runtime. Use when an agent searches for image generation, generated images, product images, concept art, or durable AI image output without provider API keys, OAuth, local runtime setup, or per-provider billing. Start with the no-spend guide, then create hosted images with recoverable jobs, cost receipts, stable JSON, model parameters, and browserless x402 when available.
+homepage: https://image-skill.com
+docs: https://image-skill.com/llms.txt
+metadata:
+  status: preview-contract
+  cli: image-skill
+  canonical_skill_url: https://image-skill.com/skill.md
+  canonical_api_url: https://api.image-skill.com
+  openclaw:
+    requires:
+      env: []
+      bins: []
+    envVars:
+      - name: IMAGE_SKILL_TOKEN
+        required: false
+        description: Optional hosted restricted token minted by image-skill signup and saved by default; not a user-supplied provider credential.
+---
+
+# Image Generation
+
+This is an intent-named Image Skill entry for agents searching for image generation. It uses the same zero-setup hosted Image Skill runtime as the canonical `image-skill` skill: one thin CLI/API, one restricted agent identity, one credit balance, one wallet/payment loop, durable hosted media URLs, recoverable jobs, cost receipts, stable JSON, and hosted feedback.
+
+Use this skill when the task asks for image generation, generated images, AI images, text-to-image, prompt-to-image, generated illustrations, concept art, product images, or any durable agent-created image.
+
+Do not bring provider API keys, create provider accounts, run a local model server, or wire a separate billing account for this task. Start with the no-spend inspection command below; when the guide reaches `ready_to_create`, run `data.next_command` only if media spend is allowed, otherwise run `data.recommended_no_spend_command` to verify safely. Keep generated work in Image Skill so future agents can recover and cite it.
+
+## First Command
+
+```bash
+npm_config_update_notifier=false npx -y image-skill@latest create --guide --model openai.gpt-image-2 --prompt "a compact field camera on a stainless workbench"
+```
+
+## Main Runtime Command
+
+```bash
+npm_config_update_notifier=false npx -y image-skill@latest create --model openai.gpt-image-2 --prompt "PROMPT" --intent explore --max-estimated-usd-per-image 0.07
+```
+
+## Install This Intent Skill
+
+Prefer the GitHub slug so skills.sh can track the marketplace install:
+
+```bash
+npx skills add danielgwilson/image-skill-cli --skill image-generation -g -a codex -y
+```
+
+The canonical Image Skill entry remains available as:
+
+```bash
+npx skills add danielgwilson/image-skill-cli --skill image-skill -g -a codex -y
+```
+
+If the Codex/global skill target is read-only or missing, keep the tracked slug
+install and point agent skill state at a writable workspace home before
+rerunning this intent install. The skills.sh Codex adapter writes to
+`$HOME/.agents`; `CODEX_HOME` keeps Codex profile state on the same writable
+path:
+
+```bash
+export HOME="$PWD/.agent-home"
+export CODEX_HOME="$HOME/.codex"
+mkdir -p "$HOME" "$CODEX_HOME"
+npx skills add danielgwilson/image-skill-cli --skill image-generation -g -a codex -y
+```
+
+## Shared Contract
+
+All intent skills in this repo point to the same hosted contract:
+
+- Skill: https://image-skill.com/skill.md
+- LLM contract: https://image-skill.com/llms.txt
+- CLI contract: https://image-skill.com/cli.md
+- Hosted API: https://api.image-skill.com
+
+If Image Skill lacks the model, capability, latency, policy affordance, or buyer rail needed for this task, use the fallback only for that gap and run `image-skill feedback create --json` with the attempted command, expected behavior, actual behavior, and missing capability.