Teach the sprite skills what a kept background costs

.agents/skills/sprite-sheet-from-reference/SKILL.md

@@ -7,5 +7,5 @@ description: "Turn one character, object or effect reference into an animated sp
 
 Read [the workflow contract](references/workflow-contract.md) for setup, billing, recovery and output checks.
 
-Read the workflow contract, then current sprite_pricing in capabilities. Exactly one reference and one of action (walk/run/idle) or animation_prompt (1–4000 chars) are required. Choose frame_count 7–100 and square frame_size 32,64,128,256,512,720,1080. action defaults to loop; custom animation defaults to once; explicitly set animation_mode when needed. Quote in integer cents: min(n,14)*14 + max(n-14,0)*7, divide by 17 cents per credit, round the WHOLE order upward once to 0.1 credit. Treat these as the current example values, and recompute from live capabilities. 7 frames currently cost 5.8 credits; 12 cost 9.9. Set max_credits within the user's authorized cap. Compare to available balance, not the separately rounded funding buckets. Sprites have no customer cancellation. Save execution and poll/resume; failed/expired work restores the hold. Download .zip, inspect its manifest and preview, and validate frame count/alpha/timing. Do not claim pixel-grid preservation, perfect anatomy, eight directions, editable Aseprite layers or production quality. For engine import use the matching engine skill. CLI: dreamlayer sprite reference.png --action walk --frames 7 --frame-size 128 --max-credits 5.8 --out walk.zip --json
+Read the workflow contract, then current sprite_pricing in capabilities. Exactly one reference and one of action (walk/run/idle) or animation_prompt (1–4000 chars) are required. Choose frame_count 7–100 and square frame_size 32,64,128,256,512,720,1080. action defaults to loop; custom animation defaults to once; explicitly set animation_mode when needed. Frames are transparent unless you ask for background keep. Quote transparent frames in integer cents: min(n,14)*14 + max(n-14,0)*7. Quote kept-background frames at the flat plain_frame_cents with no tier: n*7. Either way divide by 17 cents per credit and round the WHOLE order upward once to 0.1 credit. Treat these as the current example values, and recompute from live capabilities. 7 transparent frames currently cost 5.8 credits; 12 cost 9.9; the same 12 kept cost 5.0. Offer keep only when the user does not need transparency, and only if your client exposes the field (background in options, --background on the CLI) and capabilities advertise plain_frame_cents; an older client cannot order it. A frame the service cannot cut out is retried at nearby moments of the same clip, and one stubborn frame ships with its background rather than failing the sheet, listed in atlas.json as kept_background_frames: check that list before promising a fully transparent sheet. Set max_credits within the user's authorized cap. Compare to available balance, not the separately rounded funding buckets. Sprites have no customer cancellation. Save execution and poll/resume; failed/expired work restores the hold. Download .zip, inspect its manifest and preview, and validate frame count/alpha/timing. Do not claim pixel-grid preservation, perfect anatomy, eight directions, editable Aseprite layers or production quality. For engine import use the matching engine skill. CLI: dreamlayer sprite reference.png --action walk --frames 7 --frame-size 128 --max-credits 5.8 --out walk.zip --json
 

.cline/skills/sprite-sheet-from-reference/SKILL.md

@@ -7,5 +7,5 @@ description: "Turn one character, object or effect reference into an animated sp
 
 Read [the workflow contract](references/workflow-contract.md) for setup, billing, recovery and output checks.
 
-Read the workflow contract, then current sprite_pricing in capabilities. Exactly one reference and one of action (walk/run/idle) or animation_prompt (1–4000 chars) are required. Choose frame_count 7–100 and square frame_size 32,64,128,256,512,720,1080. action defaults to loop; custom animation defaults to once; explicitly set animation_mode when needed. Quote in integer cents: min(n,14)*14 + max(n-14,0)*7, divide by 17 cents per credit, round the WHOLE order upward once to 0.1 credit. Treat these as the current example values, and recompute from live capabilities. 7 frames currently cost 5.8 credits; 12 cost 9.9. Set max_credits within the user's authorized cap. Compare to available balance, not the separately rounded funding buckets. Sprites have no customer cancellation. Save execution and poll/resume; failed/expired work restores the hold. Download .zip, inspect its manifest and preview, and validate frame count/alpha/timing. Do not claim pixel-grid preservation, perfect anatomy, eight directions, editable Aseprite layers or production quality. For engine import use the matching engine skill. CLI: dreamlayer sprite reference.png --action walk --frames 7 --frame-size 128 --max-credits 5.8 --out walk.zip --json
+Read the workflow contract, then current sprite_pricing in capabilities. Exactly one reference and one of action (walk/run/idle) or animation_prompt (1–4000 chars) are required. Choose frame_count 7–100 and square frame_size 32,64,128,256,512,720,1080. action defaults to loop; custom animation defaults to once; explicitly set animation_mode when needed. Frames are transparent unless you ask for background keep. Quote transparent frames in integer cents: min(n,14)*14 + max(n-14,0)*7. Quote kept-background frames at the flat plain_frame_cents with no tier: n*7. Either way divide by 17 cents per credit and round the WHOLE order upward once to 0.1 credit. Treat these as the current example values, and recompute from live capabilities. 7 transparent frames currently cost 5.8 credits; 12 cost 9.9; the same 12 kept cost 5.0. Offer keep only when the user does not need transparency, and only if your client exposes the field (background in options, --background on the CLI) and capabilities advertise plain_frame_cents; an older client cannot order it. A frame the service cannot cut out is retried at nearby moments of the same clip, and one stubborn frame ships with its background rather than failing the sheet, listed in atlas.json as kept_background_frames: check that list before promising a fully transparent sheet. Set max_credits within the user's authorized cap. Compare to available balance, not the separately rounded funding buckets. Sprites have no customer cancellation. Save execution and poll/resume; failed/expired work restores the hold. Download .zip, inspect its manifest and preview, and validate frame count/alpha/timing. Do not claim pixel-grid preservation, perfect anatomy, eight directions, editable Aseprite layers or production quality. For engine import use the matching engine skill. CLI: dreamlayer sprite reference.png --action walk --frames 7 --frame-size 128 --max-credits 5.8 --out walk.zip --json
 

.github/skills/sprite-sheet-from-reference/SKILL.md

@@ -7,5 +7,5 @@ description: "Turn one character, object or effect reference into an animated sp
 
 Read [the workflow contract](references/workflow-contract.md) for setup, billing, recovery and output checks.
 
-Read the workflow contract, then current sprite_pricing in capabilities. Exactly one reference and one of action (walk/run/idle) or animation_prompt (1–4000 chars) are required. Choose frame_count 7–100 and square frame_size 32,64,128,256,512,720,1080. action defaults to loop; custom animation defaults to once; explicitly set animation_mode when needed. Quote in integer cents: min(n,14)*14 + max(n-14,0)*7, divide by 17 cents per credit, round the WHOLE order upward once to 0.1 credit. Treat these as the current example values, and recompute from live capabilities. 7 frames currently cost 5.8 credits; 12 cost 9.9. Set max_credits within the user's authorized cap. Compare to available balance, not the separately rounded funding buckets. Sprites have no customer cancellation. Save execution and poll/resume; failed/expired work restores the hold. Download .zip, inspect its manifest and preview, and validate frame count/alpha/timing. Do not claim pixel-grid preservation, perfect anatomy, eight directions, editable Aseprite layers or production quality. For engine import use the matching engine skill. CLI: dreamlayer sprite reference.png --action walk --frames 7 --frame-size 128 --max-credits 5.8 --out walk.zip --json
+Read the workflow contract, then current sprite_pricing in capabilities. Exactly one reference and one of action (walk/run/idle) or animation_prompt (1–4000 chars) are required. Choose frame_count 7–100 and square frame_size 32,64,128,256,512,720,1080. action defaults to loop; custom animation defaults to once; explicitly set animation_mode when needed. Frames are transparent unless you ask for background keep. Quote transparent frames in integer cents: min(n,14)*14 + max(n-14,0)*7. Quote kept-background frames at the flat plain_frame_cents with no tier: n*7. Either way divide by 17 cents per credit and round the WHOLE order upward once to 0.1 credit. Treat these as the current example values, and recompute from live capabilities. 7 transparent frames currently cost 5.8 credits; 12 cost 9.9; the same 12 kept cost 5.0. Offer keep only when the user does not need transparency, and only if your client exposes the field (background in options, --background on the CLI) and capabilities advertise plain_frame_cents; an older client cannot order it. A frame the service cannot cut out is retried at nearby moments of the same clip, and one stubborn frame ships with its background rather than failing the sheet, listed in atlas.json as kept_background_frames: check that list before promising a fully transparent sheet. Set max_credits within the user's authorized cap. Compare to available balance, not the separately rounded funding buckets. Sprites have no customer cancellation. Save execution and poll/resume; failed/expired work restores the hold. Download .zip, inspect its manifest and preview, and validate frame count/alpha/timing. Do not claim pixel-grid preservation, perfect anatomy, eight directions, editable Aseprite layers or production quality. For engine import use the matching engine skill. CLI: dreamlayer sprite reference.png --action walk --frames 7 --frame-size 128 --max-credits 5.8 --out walk.zip --json
 

clawhub/dreamlayer-image-workflows/SKILL.md

@@ -104,7 +104,10 @@ output acceptance.
 Ordinary completed image operations currently cost one credit each; read the live figure from
 capabilities rather than assuming. Sprite jobs are a beta with frame-based pricing: read
 `sprite_pricing`, round the whole quote up once to a tenth of a credit, and pass it as
-`max_credits`. Sprite jobs cannot be cancelled by the customer; failed or expired jobs restore
+`max_credits`. Transparent frames use the tier in `first_tier_cents` and
+`additional_frame_cents`; a sheet that keeps its background costs the flat
+`plain_frame_cents` per frame, roughly half, and is ordered with `background: "keep"` by a
+client that exposes the field. Sprite jobs cannot be cancelled by the customer; failed or expired jobs restore
 the hold.
 
 Stop, keep the recoverable state, and report rather than looping paid retries when you hit:

plugins/dreamlayer/skills/sprite-sheet-from-reference/SKILL.md

@@ -7,5 +7,5 @@ description: "Turn one character, object or effect reference into an animated sp
 
 Read [the workflow contract](references/workflow-contract.md) for setup, billing, recovery and output checks.
 
-Read the workflow contract, then current sprite_pricing in capabilities. Exactly one reference and one of action (walk/run/idle) or animation_prompt (1–4000 chars) are required. Choose frame_count 7–100 and square frame_size 32,64,128,256,512,720,1080. action defaults to loop; custom animation defaults to once; explicitly set animation_mode when needed. Quote in integer cents: min(n,14)*14 + max(n-14,0)*7, divide by 17 cents per credit, round the WHOLE order upward once to 0.1 credit. Treat these as the current example values, and recompute from live capabilities. 7 frames currently cost 5.8 credits; 12 cost 9.9. Set max_credits within the user's authorized cap. Compare to available balance, not the separately rounded funding buckets. Sprites have no customer cancellation. Save execution and poll/resume; failed/expired work restores the hold. Download .zip, inspect its manifest and preview, and validate frame count/alpha/timing. Do not claim pixel-grid preservation, perfect anatomy, eight directions, editable Aseprite layers or production quality. For engine import use the matching engine skill. CLI: dreamlayer sprite reference.png --action walk --frames 7 --frame-size 128 --max-credits 5.8 --out walk.zip --json
+Read the workflow contract, then current sprite_pricing in capabilities. Exactly one reference and one of action (walk/run/idle) or animation_prompt (1–4000 chars) are required. Choose frame_count 7–100 and square frame_size 32,64,128,256,512,720,1080. action defaults to loop; custom animation defaults to once; explicitly set animation_mode when needed. Frames are transparent unless you ask for background keep. Quote transparent frames in integer cents: min(n,14)*14 + max(n-14,0)*7. Quote kept-background frames at the flat plain_frame_cents with no tier: n*7. Either way divide by 17 cents per credit and round the WHOLE order upward once to 0.1 credit. Treat these as the current example values, and recompute from live capabilities. 7 transparent frames currently cost 5.8 credits; 12 cost 9.9; the same 12 kept cost 5.0. Offer keep only when the user does not need transparency, and only if your client exposes the field (background in options, --background on the CLI) and capabilities advertise plain_frame_cents; an older client cannot order it. A frame the service cannot cut out is retried at nearby moments of the same clip, and one stubborn frame ships with its background rather than failing the sheet, listed in atlas.json as kept_background_frames: check that list before promising a fully transparent sheet. Set max_credits within the user's authorized cap. Compare to available balance, not the separately rounded funding buckets. Sprites have no customer cancellation. Save execution and poll/resume; failed/expired work restores the hold. Download .zip, inspect its manifest and preview, and validate frame count/alpha/timing. Do not claim pixel-grid preservation, perfect anatomy, eight directions, editable Aseprite layers or production quality. For engine import use the matching engine skill. CLI: dreamlayer sprite reference.png --action walk --frames 7 --frame-size 128 --max-credits 5.8 --out walk.zip --json