image-skill 0.1.27 → 0.1.29

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

@@ -0,0 +1,78 @@
+---
+name: ai-audio-generation
+description: >-
+  AI audio generation for agents through Image Skill's zero-setup hosted creative runtime. Use when a prompt should become music, sound, or audio without provider credentials, OAuth, local runtime, or per-provider billing. Start with the no-spend guide, choose an audio model, and keep durable hosted audio URLs, recoverable jobs, cost receipts, stable JSON, payments, and feedback in one loop.
+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.
+---
+
+# AI Audio Generation
+
+This is an intent-named Image Skill entry for agents searching for audio 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 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.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 fal.stable-audio-25-text-to-audio --prompt "warm analog synth bed with soft tape hiss"
+```
+
+## Main Runtime Command
+
+```bash
+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
+
+Prefer the GitHub slug so skills.sh can track the marketplace install:
+
+```bash
+npx skills add danielgwilson/image-skill-cli --skill ai-audio-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 ai-audio-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.

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

@@ -0,0 +1,78 @@
+---
+name: ai-image-generation
+description: >-
+  AI image generation for agents: text-to-image and prompt-to-image through Image Skill's zero-setup hosted runtime. Use when an agent needs a generated image with no provider API key, OAuth, local runtime, or per-provider billing account. Start with the no-spend guide, then create durable hosted images with recoverable jobs, cost receipts, model parameters, stable JSON, 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.
+---
+
+# AI 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 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.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 ai-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 ai-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.

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

@@ -0,0 +1,78 @@
+---
+name: ai-video-generation
+description: >-
+  AI video generation for agents through Image Skill's zero-setup hosted creative runtime. Use when a prompt should become a durable hosted video without provider credentials, OAuth, local runtime, or per-provider billing. Start with the no-spend guide, choose a video model, and keep model discovery, jobs, costs, URLs, JSON recovery, payments, and feedback in one loop.
+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.
+---
+
+# AI Video Generation
+
+This is an intent-named Image Skill entry for agents searching for video 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 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.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 fal.ltx-video-13b-distilled --prompt "a ten second handheld product reveal"
+```
+
+## Main Runtime Command
+
+```bash
+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
+
+Prefer the GitHub slug so skills.sh can track the marketplace install:
+
+```bash
+npx skills add danielgwilson/image-skill-cli --skill ai-video-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 ai-video-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.

package/skills/creative-media/SKILL.md

@@ -0,0 +1,78 @@
+---
+name: creative-media
+description: >-
+  Creative media for agents over one zero-setup Image Skill runtime: image generation, image editing, video, audio, and image-to-3D assets with no provider API key, OAuth, local runtime, or per-provider billing account. Use when an agent needs generated media plus durable hosted URLs, recoverable jobs, cost receipts, model parameters, stable JSON, payments, and feedback through one identity and one wallet.
+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.
+---
+
+# Creative Media
+
+This is an intent-named Image Skill entry for agents searching for creative media. 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 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.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 --prompt "a compact field camera on a stainless workbench"
+```
+
+## Main Runtime Command
+
+```bash
+npm_config_update_notifier=false npx -y image-skill@latest models list --available --json
+```
+
+## 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 creative-media -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 creative-media -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.

package/skills/image-edit/SKILL.md

@@ -0,0 +1,78 @@
+---
+name: image-edit
+description: >-
+  Image editing for agents: image-to-image edits, variations, and image-conditioned transforms through Image Skill's zero-setup hosted runtime. Use when an agent needs to edit an existing image without provider credentials, OAuth, local runtime, or per-provider billing. Inspect the edit model, upload or reuse an input image, then return durable hosted assets, jobs, cost receipts, stable JSON, and feedback.
+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 Edit
+
+This is an intent-named Image Skill entry for agents searching for image editing. 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 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.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 models show openai.gpt-image-2-edit --json
+```
+
+## Main Runtime Command
+
+```bash
+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
+
+Prefer the GitHub slug so skills.sh can track the marketplace install:
+
+```bash
+npx skills add danielgwilson/image-skill-cli --skill image-edit -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-edit -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.

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.