		@@ -11,5 +11,8 @@ <!-- PARITY: this file mirrors getMusicPromptSystemPrompt() in

		Wants an EXISTING track, not a new song? ("background music", "stock music", "royalty-free track") → don't generate. Use `search_stock_media` with `mediaType: "music"` (semantic vibe query — "tense cinematic pulse", "uplifting corporate background") → `get_stock_asset` for download URLs. Free, no credits. The older `*_music_library` tools are deprecated adapters over the stock library — prefer the stock tools.

		## CRITICAL Kolbo Platform Rules

		- Model version, duration, and instrumental toggle are MCP-tool params. Don't write `v4.5`, `30 seconds`, or `instrumental: true` inside the prompt fields themselves.
		- Exact track length = `duration_seconds` (clamped 5–300s). Only length-controllable models honor it (e.g. ElevenLabs Music, `music-v1`) — without it those models default to a ~10s track, so ALWAYS pass it for jingles/beds on those models. Suno ignores it and picks its own length.
		- Suno generations have two separate input fields: a Style / Description field (`style` param) and a Lyrics field (`lyrics` param). Output your prompt as TWO separate fenced code blocks so the user (and the tool call) know exactly what goes where.
		@@ -89,3 +92,3 @@ - Tell the user to run the prompt multiple times — Suno output varies significantly between generations, that's a feature. Use `num_generations` if the tool supports it, or fire 2–4 parallel `generate_music` calls.
		- `lyrics`: 2–4 short lines max, often just chorus
		- Pass the shortest `duration` the tool supports.
		- Pass the shortest `duration` the tool supports — or, on a length-controllable model (ElevenLabs Music), pass the exact `duration_seconds` (e.g. `15` or `30`).

		@@ -92,0 +95,0 @@ ### Cinematic trailer / score

+2

-0

skills/kolbo/references/workflows/cost-and-validation.md

		@@ -51,2 +51,4 @@ # Cost Awareness, Validation & Constraints

		After generating, report cost only — never "credits remaining". Coding/chat usage also deducts credits, so any balance you compute (opening balance − generation costs) is wrong by the time you say it. Quote `credits_used` per generation / batch total; if the user asks what's left, run `check_credits` fresh at that moment and quote that number.

		## ⚠️ Quote Real Cost, Never Estimates (CRITICAL)
		@@ -53,0 +55,0 @@

+4

-0

skills/kolbo/references/workflows/troubleshooting.md

		@@ -33,2 +33,6 @@ # Troubleshooting

		## Checking generation status without spinning

		`get_generation_status` supports `wait=true` (blocks server-side until the generation reaches a final state, up to ~3 min) and `generation_ids` (many ids in one call → returns `all_done`, `still_processing`, and per-generation results). Never call it repeatedly in a loop — one `wait=true` call replaces the loop. If some generations are still running after the wait window, call it ONCE more with `wait=true` and only the `still_processing` ids.

		## Failure envelope from `get_generation_status`
		@@ -35,0 +39,0 @@

+13

-7

skills/kolbo/SKILL.md

		---
		version: 0.5.0
		version: 0.5.1
		name: kolbo
		@@ -38,3 +38,3 @@ description: \|
		2. If `list_models` returns empty, MCP isn't wired — same fix.
		3. Remember the credit balance for the session; don't re-check on every turn.
		3. Use the balance ONLY for the low-balance check at this moment. Never quote a "credits remaining" number later in the session — coding/chat usage also deducts credits, so any remembered or computed balance is stale. Report only what each generation cost (`credits_used`); if the user asks what's left, run `check_credits` fresh right then.

		@@ -117,2 +117,3 @@ If the user is on a whitelabel build (`sapir`, etc.), they must use their branded command — not `kolbo`. See `references/workflows/troubleshooting.md`.
		\| `list_moodboards` / `get_moodboard` / `list_presets` \| Style overlays \|
		\| `search_stock_media` / `get_stock_sources` / `get_stock_categories` / `get_stock_collections` / `get_stock_asset` / `analyze_script_for_stock` / `import_stock_asset` \| Stock library (free, no credits) — EXISTING photos / videos / 3D / SFX / music. For stock music use `search_stock_media` with `mediaType: "music"` (semantic vibe query, e.g. "uplifting corporate background") → `get_stock_asset` for downloads. The older `*_music_library` tools are deprecated adapters over this — prefer the stock tools. \|
		\| `chat_send_message` / `chat_list_conversations` / `chat_get_messages` \| Kolbo chat with optional `media_urls` (up to 10 per call) \|
		@@ -154,8 +155,9 @@ \| `app_builder_*` (9 tools) \| Full React app generation — see `workflows/app-builder.md` \|
		3. Pick the model:
		- User named one → use it.
		- User named one → use it. Model identifiers resolve leniently — shorthand like `"z-image"` or `"nano banana 2"` auto-resolves to the exact identifier, so don't over-engineer exact-id lookups (`list_models` is still authoritative for constraints, caps, and pricing).
		- Auto-select → only from "Auto-selectable" section (models with a `summary`). Cheapest fit. Prefer `[RECOMMENDED]` when cost is similar.
		- Never auto-select from "Named-only" section.
		4. Validate inputs against model caps — see `references/workflows/cost-and-validation.md`.
		5. How calls work: each tool blocks until generation is fully complete. Images: seconds. Video: minutes. Multiple tool calls in one response run concurrently. If a call times out, use `get_generation_status` with the returned generation ID.
		6. Share the URL after success. Never fabricate URLs.
		5. How calls work: each tool blocks until generation is fully complete. Images: seconds. Video: minutes. Multiple tool calls in one response run concurrently. On hosts with live widgets the tool instead returns `submitted` instantly — the card updates on its own; you only need `get_generation_status` when a follow-up step needs the output URLs.
		6. Checking status — NEVER poll in a loop: `get_generation_status` takes `wait=true` (blocks server-side until done, ~3 min) and `generation_ids` (check MANY generations in ONE call — returns `all_done` + which are still running). One `wait=true` call replaces any polling loop. If it comes back with some still processing, call it ONCE more with `wait=true` and the remaining ids.
		7. Share the URL after success. Never fabricate URLs.

		@@ -172,2 +174,3 @@ Model types for `list_models`: `text_to_img`, `image_editing`, `text_to_video`, `img_to_video`, `draw_to_video`, `video_to_video`, `elements`, `firstlastgenerations`, `lipsync-image`, `lipsync-video`, `music_gen`, `text_to_speech`, `text_to_sound`, `stt`, `text`, `3d_text_to_model`, `3d_image_to_model`, `3d_multi_image_to_model`, `3d_world`.
		- Quote real cost: after firing, log `credits_used` (from the tool result) to `.kolbo/production.md` — never `base × count`.
		- Never state "credits remaining" from arithmetic (opening balance − generation costs). Coding/chat usage deducts credits too, so the math is always wrong. Report cost only; if the user asks for their balance, call `check_credits` fresh at that moment.

		@@ -177,3 +180,4 @@ ## Rate Limiting & Batch Generation
		- `generate_image`: 30/min. All other generation tools: 10/min per type. 300/min global. `upload_media`: 300/min, no credit cost.
		- ⚠️ NEVER re-fire a generation you already called. Aborted / timed-out calls still process server-side. Run `get_generation_status` before retrying.
		- ⚠️ NEVER re-fire a generation you already called. Aborted / timed-out calls still process server-side. Run `get_generation_status` (with `wait=true`) before retrying.
		- Tracking a batch: check ALL in-flight ids in ONE `get_generation_status` call with `generation_ids` + `wait=true`. Read `all_done` / `still_processing` from the response — do not check ids one by one, and never re-call without `wait`.
		- Batch ≤10 items: output ALL tool calls in one response — they run concurrently.
		@@ -211,2 +215,4 @@ - Bulk >10 items: real-world ceilings — `generate_image` 8–10 in-flight, image-edit 5–8, video tools 3–5, `generate_video_from_video` 3, music/speech/sound 5–8. Fire one batch → wait → fire next. Persist every `generation_id` in `.kolbo/production.md`.

		Motion-control / animate-move models invert the inputs: `reference_images[0]` = the CHARACTER IMAGE to animate, `source_video` = the driving/reference video whose motion is transferred. Omitting the character image returns a `MOTION_CONTROL_INPUTS` error.

		Do NOT decompose into frames. Do NOT re-fire if the first call returned URLs.
		@@ -230,3 +236,3 @@
		2. Tool returns `completed` but `urls` is empty — silent failure (NSFW filter, model OOM, upstream 5xx). Tell user "completed without an output — retrying" and re-fire ONCE. Do NOT log to `.kolbo/production.md`. Do NOT claim it worked.
		3. Tool hangs / never returns — MCP poll timed out. Call `get_generation_status(generation_id)` IMMEDIATELY. The server might be done.
		3. Tool hangs / never returns — MCP poll timed out. Call `get_generation_status(generation_id, wait=true)` IMMEDIATELY. The server might be done.

		@@ -233,0 +239,0 @@ Always:

+1

-1

skills/kolbo/VERSION

		@@ -1,1 +0,1 @@
		0.5.0
		0.5.1

bin/kolbo

Sorry, the diff of this file is not supported yet

		---
		version: 0.5.0
		version: 0.5.1
		name: kolbo
		@@ -38,3 +38,3 @@ description: \|
		2. If `list_models` returns empty, MCP isn't wired — same fix.
		3. Remember the credit balance for the session; don't re-check on every turn.
		3. Use the balance ONLY for the low-balance check at this moment. Never quote a "credits remaining" number later in the session — coding/chat usage also deducts credits, so any remembered or computed balance is stale. Report only what each generation cost (`credits_used`); if the user asks what's left, run `check_credits` fresh right then.

		@@ -117,2 +117,3 @@ If the user is on a whitelabel build (`sapir`, etc.), they must use their branded command — not `kolbo`. See `references/workflows/troubleshooting.md`.
		\| `list_moodboards` / `get_moodboard` / `list_presets` \| Style overlays \|
		\| `search_stock_media` / `get_stock_sources` / `get_stock_categories` / `get_stock_collections` / `get_stock_asset` / `analyze_script_for_stock` / `import_stock_asset` \| Stock library (free, no credits) — EXISTING photos / videos / 3D / SFX / music. For stock music use `search_stock_media` with `mediaType: "music"` (semantic vibe query, e.g. "uplifting corporate background") → `get_stock_asset` for downloads. The older `*_music_library` tools are deprecated adapters over this — prefer the stock tools. \|
		\| `chat_send_message` / `chat_list_conversations` / `chat_get_messages` \| Kolbo chat with optional `media_urls` (up to 10 per call) \|
		@@ -154,8 +155,9 @@ \| `app_builder_*` (9 tools) \| Full React app generation — see `workflows/app-builder.md` \|
		3. Pick the model:
		- User named one → use it.
		- User named one → use it. Model identifiers resolve leniently — shorthand like `"z-image"` or `"nano banana 2"` auto-resolves to the exact identifier, so don't over-engineer exact-id lookups (`list_models` is still authoritative for constraints, caps, and pricing).
		- Auto-select → only from "Auto-selectable" section (models with a `summary`). Cheapest fit. Prefer `[RECOMMENDED]` when cost is similar.
		- Never auto-select from "Named-only" section.
		4. Validate inputs against model caps — see `references/workflows/cost-and-validation.md`.
		5. How calls work: each tool blocks until generation is fully complete. Images: seconds. Video: minutes. Multiple tool calls in one response run concurrently. If a call times out, use `get_generation_status` with the returned generation ID.
		6. Share the URL after success. Never fabricate URLs.
		5. How calls work: each tool blocks until generation is fully complete. Images: seconds. Video: minutes. Multiple tool calls in one response run concurrently. On hosts with live widgets the tool instead returns `submitted` instantly — the card updates on its own; you only need `get_generation_status` when a follow-up step needs the output URLs.
		6. Checking status — NEVER poll in a loop: `get_generation_status` takes `wait=true` (blocks server-side until done, ~3 min) and `generation_ids` (check MANY generations in ONE call — returns `all_done` + which are still running). One `wait=true` call replaces any polling loop. If it comes back with some still processing, call it ONCE more with `wait=true` and the remaining ids.
		7. Share the URL after success. Never fabricate URLs.

		@@ -172,2 +174,3 @@ Model types for `list_models`: `text_to_img`, `image_editing`, `text_to_video`, `img_to_video`, `draw_to_video`, `video_to_video`, `elements`, `firstlastgenerations`, `lipsync-image`, `lipsync-video`, `music_gen`, `text_to_speech`, `text_to_sound`, `stt`, `text`, `3d_text_to_model`, `3d_image_to_model`, `3d_multi_image_to_model`, `3d_world`.
		- Quote real cost: after firing, log `credits_used` (from the tool result) to `.kolbo/production.md` — never `base × count`.
		- Never state "credits remaining" from arithmetic (opening balance − generation costs). Coding/chat usage deducts credits too, so the math is always wrong. Report cost only; if the user asks for their balance, call `check_credits` fresh at that moment.

		@@ -177,3 +180,4 @@ ## Rate Limiting & Batch Generation
		- `generate_image`: 30/min. All other generation tools: 10/min per type. 300/min global. `upload_media`: 300/min, no credit cost.
		- ⚠️ NEVER re-fire a generation you already called. Aborted / timed-out calls still process server-side. Run `get_generation_status` before retrying.
		- ⚠️ NEVER re-fire a generation you already called. Aborted / timed-out calls still process server-side. Run `get_generation_status` (with `wait=true`) before retrying.
		- Tracking a batch: check ALL in-flight ids in ONE `get_generation_status` call with `generation_ids` + `wait=true`. Read `all_done` / `still_processing` from the response — do not check ids one by one, and never re-call without `wait`.
		- Batch ≤10 items: output ALL tool calls in one response — they run concurrently.
		@@ -211,2 +215,4 @@ - Bulk >10 items: real-world ceilings — `generate_image` 8–10 in-flight, image-edit 5–8, video tools 3–5, `generate_video_from_video` 3, music/speech/sound 5–8. Fire one batch → wait → fire next. Persist every `generation_id` in `.kolbo/production.md`.

		Motion-control / animate-move models invert the inputs: `reference_images[0]` = the CHARACTER IMAGE to animate, `source_video` = the driving/reference video whose motion is transferred. Omitting the character image returns a `MOTION_CONTROL_INPUTS` error.

		Do NOT decompose into frames. Do NOT re-fire if the first call returned URLs.
		@@ -230,3 +236,3 @@
		2. Tool returns `completed` but `urls` is empty — silent failure (NSFW filter, model OOM, upstream 5xx). Tell user "completed without an output — retrying" and re-fire ONCE. Do NOT log to `.kolbo/production.md`. Do NOT claim it worked.
		3. Tool hangs / never returns — MCP poll timed out. Call `get_generation_status(generation_id)` IMMEDIATELY. The server might be done.
		3. Tool hangs / never returns — MCP poll timed out. Call `get_generation_status(generation_id, wait=true)` IMMEDIATELY. The server might be done.

		@@ -233,0 +239,0 @@ Always:

@kolbo/kolbo-code-linux-x64 - npm Package Compare versions

Improved metrics