Update to Kling AI for Terminal

SKILL.md text changes

− removed · + added

--- before
+++ after
@@ -1,38 +1,67 @@
 ---
 name: kling-ai-generate-image
-description: Generate or edit Kling images through the Global CLI, including references, product images, portraits, posters, variants, and reusable Elements.
+description: Use Kling AI in Codex for text-to-image, image-to-image, editing, repainting, and controlled variants, including posters, products, ads, portraits, and social visuals. For existing tasks, use the core Skill's shared query workflow.
 ---
 
-# Kling image generation
+# Kling AI image generation
 
-Follow [the core workflow](../kling-ai/SKILL.md) and [CLI contract](../kling-ai/references/cli-contract.md); submit each authorized step at most once. Read [Element rules](../kling-ai/references/elements-motion-feedback.md) only when using reusable subjects.
+Turn a creative request into one well-specified Kling image request. Follow the [core Skill](../kling-ai/SKILL.md) and [CLI contract](../kling-ai/references/cli-contract.md). Invoke the CLI only, with live command/model definitions.
 
-- Use `text_to_image` for a new image; use `image_to_image` when source media controls identity, structure, composition, or style. Assign each reference a role and preserve the order of repeatable `--image` arguments.
-- For editing, state what changes and what stays fixed. Preserve identity, product geometry, logos, and exact supplied copy. Write concrete composition, lighting, and material choices; avoid unnecessary prompt embellishment.
-- Choose a live `--model`; use `--omni` only when explicitly requested and supported. Preserve the model's declared resolution default. Use only live-supported ratio and count values; default to one image unless more were requested.
-- For Element binding, inspect the subject type and both live tool restrictions and model parameters. Use `<<<id>>>` plus `--elements`; stop if declarations conflict. Do not probe compatibility with a paid task.
-- Resolve references, check credits, submit, poll, and return results using the core workflow. Status requests use `query_tasks` and create no generation.
+## Operating rules
 
-## Quality workflow
+- Use CLI browser OAuth. Never request or expose API keys, tokens, cookies, authorization headers, or upload tickets. Requested preview/download URLs may be delivered, but never logged or used as permanent identities.
+- Before paid generation, show the final tool/model, prompt summary, resolution or duration, ratio, count, reference roles, and actual billing information when available. Obtain explicit confirmation of these settings immediately before submission; an already confirmed unchanged step needs no repeated confirmation.
+- Submit each explicitly authorized step once. Run distinct tasks and cross-media dependencies serially through the shared workflow. Never blindly retry failed or ambiguous submissions.
+- Discover live definitions before selecting tools, models, input names, or enum values. Live provider fields override examples.
+- Prefer images pasted or attached directly in the conversation. Resolve their actual local paths and pass supported CLI resource flags for auto-upload; no separate upload is needed.
 
-Before every image generation, read [prompt construction](references/prompt-construction.md). For product, advertising, portrait, cover, or reference-edit requests, also read the relevant section of [scene patterns](references/scene-patterns.md). User facts and requested changes take precedence over these profiles.
+Read [asset workflows](../kling-ai/references/asset-workflows.md) for subjects, motions, or reference preparation.
 
-1. Identify the subject, destination, required copy, reference roles, and protected identity/product facts. Ask only for missing information that materially changes the result.
-2. Select one primary quality profile: product/ecommerce, advertising/poster, portrait/fashion, cinematic concept, or reference edit. Add another only when the request crosses contexts; profiles guide visible quality, not model cost.
-3. Build one coherent prompt covering the subject and allowed change, composition, lighting, color, and material response. Translate “premium” or “cinematic” into observable choices. Keep model, ratio, resolution, and count in flags.
-4. For references, separate identity/product structure from style/composition. Preserve source perspective, geometry, labels, and supplied text; define which areas may change. Do not redescribe a source so broadly that locked facts drift.
-5. Before submission, check focal hierarchy, crop/copy-safe space, reference order, protected details, exact spelling, and the chosen profile's acceptance criteria. Prefer clean artwork with reserved text space unless generated copy is required; include required copy exactly once.
-6. Inspect the result when available before claiming visual QA. Report visible mismatches honestly; a quality defect does not authorize automatic regeneration.
+Before generation, obtain candidates through [capability discovery](../kling-ai/references/capability-discovery.md) and honor [account visibility](../kling-ai/SKILL.md#account-visibility-and-rollout). After selection, read the [parameter module table](../kling-ai/references/model-parameters.md), loading only applicable files. Submit through [generation submission](../kling-ai/references/tool-workflows.md). For existing tasks, go directly to [task results](../kling-ai/references/task-results.md).
 
-## Minimal calls
+## Workflow
 
-These show arguments after the npm command prefix in the CLI contract. Replace `<model>` with the selected live model; resolve real paths before calling. Append the shared telemetry flags.
+Skip generation steps for an existing-task query.
 
-```bash
-kling text_to_image --model <model> "A red panda in a vintage spacesuit, lit by Earth's blue glow"
-kling image_to_image --model <model> --image ./reference.png "Restyle in watercolor; preserve the subject and composition"
-```
+1. Determine candidate entry points from the mode table and supplied assets. Discover relevant models and check required capabilities before choosing one or constructing parameters.
+2. Load only applicable parameter modules. Skip output-selection advice only when all relevant specification fields have a single legal value. Resolve unsupported requirements before reading detailed instructions for an unavailable feature.
+3. Read [prompt construction](references/prompt-construction.md) for every new generation, edit, or variant. Select a quality profile to decide visible facts and acceptance checks. Only read-only queries and authorized retries with unchanged parameters may skip it. Add [scene patterns](references/scene-patterns.md) when further scene decisions are needed. An existing complete plan is not a reason to skip prompt construction.
+4. Internally establish intended use, locked facts, and creative scope. Ask only about missing critical identity/copy or conflicting requirements; choose ordinary lighting, backgrounds, and unspecified optional settings reasonably.
+5. Align the prompt with the selected model and actual asset bindings, submit once through the shared workflow, then follow task results. Do not redefine polling or retry behavior here.
 
-For multiple references, repeat `--image` in the intended order. Add `--imageCount`, `--imgResolution`, or `--aspectRatio` only when declared by the selected model and required by the request; preserve defaults otherwise. Choose a product's factual reference over a style reference for identity and structure.
+## Generation modes
 
-Before execution: resolve references → `who_am_i` → choose model and flags → `account` → submit once → `query_tasks <generationId>` → return selected `works[]` with task number and work index. An upload failure does not authorize text-to-image fallback.
+| Intent | Mode | Interpretation |
+| --- | --- | --- |
+| Text-to-image | New image | Build from text without using a source image to control identity or composition. |
+| Image-to-image | Edit or reference-guided image | At least one image controls content, identity, structure, composition, or style. Assign a role to each input. |
+| Element reference | An available image entry point | Read the Element and use `who_am_i` to verify its type, binding parameters, and required inputs. Do not allow or forbid it based only on tool name. |
+| Variant/restyle | Image-to-image with a defined change scope | State every allowed change and lock other facts. Use a single change dimension only when the user has not specified the scope. |
+| Browse/preview motions | Read-only asset query | Use `motion_library_list` and the [motion workflow](../kling-ai/references/asset-workflows.md#motion-library-and-motion-control) for real results and previews; do not generate. |
+| Apply a saved motion/reference video | Motion-control video | Use the [video Skill](../kling-ai-generate-video/SKILL.md) with `motion_control`: a subject image and exactly one library `motionId` or source video, with model/required parameters from `who_am_i`. Do not submit as image-to-image. |
+| Progress/status | Read-only | Query the existing task without generation. |
+
+Do not silently change modes. An attachment does not automatically imply image-to-image: ignore it only after establishing that it is unrelated to the requested new image. Never downgrade an explicit image-to-image request to text-to-image after upload or schema validation fails.
+
+Before calling tools, internally check mode, ratio, reference roles, and allowed changes. Do not show process messages unless creative clarification is necessary.
+
+## Creative constraints
+
+Use selected-model modules for specification values; do not add fields or tiers from examples. Add new text only when requested. Preserve labels, logos, and product structure outside the edit scope. Variants follow all authorized changes while retaining other facts. Never invent efficacy, certifications, prices, or statistics.
+
+## Quality gates
+
+Before submission, align change scope, copy, ratio, and count across the request, prompt, parameters, and references. Keep a clear focal hierarchy and compatible composition/lighting; do not add details merely to fill a template.
+
+When the host can inspect original outputs, check identity, product structure, text/labels, counts/anatomy, crops/layout, and obvious distortion against intended use. Low-resolution thumbnails cannot validate fine text. Deliver issues through [inspection and iteration](../kling-ai/references/task-results.md), without automatic regeneration.
+
+## Failure handling
+
+- Authorization: run the pinned CLI `login`, then verify with `who_am_i`.
+- Unsupported parameters: refresh capabilities and prepare a correction, without automatically resubmitting a prior generation.
+- Insufficient credits: explain and stop until recharged; do not retry automatically.
+- Lost response: recover or report unknown through task results; never replay blindly.
+- Provider failure: summarize safely, retain the task ID, and do not automatically resubmit.
+
+
+Submit at most once per confirmed paid step. Runtime, polling, and link delivery follow the core CLI workflow.