{"id":109633,"plugin_id":"plugins_6a86c3ff68a08191be42add5a9567875","kind":"skill","collection_source":"plugin_package","comparison_source":"plugin_package","observed_at":"2026-11-21T18:11:11.655Z","digest":"a4b89904f29d394faff760e8c8ad1b771a968bcacb42058423ec33838a31bc04","against":41340,"payload":{"description":"Write or refine Kling image prompts, or prepare and generate approved images and edits, including product photography, portraits, posters, variants, Elements, and continuous image series.","included_files":[{"relative_path":"agents/openai.yaml","size_in_bytes":307},{"relative_path":"references/prompt-construction.md","size_in_bytes":5471},{"relative_path":"references/scene-patterns.md","size_in_bytes":3383}],"name":"kling-ai-generate-image","skill_md_contents":"---\nname: kling-ai-generate-image\ndescription: Write or refine Kling image prompts, or prepare and generate approved images and edits, including product photography, portraits, posters, variants, Elements, and continuous image series.\n---\n\n# Kling image generation\n\nFor prompt-only work, use [prompt construction](references/prompt-construction.md) and return the requested prompt. Ask for a missing required image before model discovery. Follow the [core workflow](../kling-ai/SKILL.md) for preparation, billing and results. For local calls use the [CLI contract](../kling-ai/references/cli-contract.md). Submit each authorized task at most once.\n\n## Choose the mode and model\n\n- Use `text_to_image` for a new image or series. Use `image_to_image` when source media controls editable content, identity, product geometry, composition, or style. Preserve each reference's role, slot and order.\n- When model selection is open, prefer Kling Image 4.0 if the live tool lists it and it fits the request. Otherwise prefer a compatible live `defaultModel`, then another compatible model advertised for the same tool. Honor a specific model or a request to use the service default.\n- A continuous image series needs a model that supports series generation at the requested count and resolution in one task. For Kling Image 4.0, use `story_mode` when declared and set `imageCount` when the selected mode honors it. If the model infers the series length from the prompt, state that the count is approximate and get approval before relaxing an exact count. Check that 8K, when requested, is available with the selected mode and count. Multiple independent images cannot fulfill a continuous series.\n- For Elements, use [binding rules](../kling-ai/references/elements-motion-feedback.md#bind-an-element-to-generation). Verify type, required slots and combined reference limits using [live settings](../kling-ai/references/generation-settings.md).\n\n## Quality workflow\n\n1. Use [prompt construction](references/prompt-construction.md) to review the user's prompt. Read the relevant [scene pattern](references/scene-patterns.md) for product, advertising, portrait, cover, or reference editing when useful. Use a suitable supplied prompt verbatim.\n2. State the visible subject, composition, lighting, and material. For editing, identify the requested changes and protect source identity, product geometry, logos, supplied copy and protected areas. Reserve copy-safe space when called for.\n3. Preserve the live resolution default unless the user requests another value or approves a recommendation. Infer a supported ratio from the destination and choose one result by default. Check the exact wording of on-image text and the reference roles.\n4. Follow the core workflow to check balance, submit once and inspect the media when available before claiming visual QA. An unavailable reference pauses the original request. Use the edit task's own ID to recover its output.\n\n## Local CLI examples\n\nReplace `<model>` with the canonical ID and use the verified executable from the CLI contract.\n\n```bash\nkling-plugin text_to_image --model <model> \"A red panda in a vintage spacesuit, lit by Earth's blue glow\"\nkling-plugin image_to_image --model <model> --image ./reference.png \"Restyle in watercolor; preserve subject and composition\"\n```\n"},"changes":[{"path":"/description","type":"changed","before":"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.","after":"Write or refine Kling image prompts, or prepare and generate approved images and edits, including product photography, portraits, posters, variants, Elements, and continuous image series."},{"path":"/included_files","type":"changed","before":[{"relative_path":"agents/openai.yaml","size_in_bytes":255},{"relative_path":"references/prompt-construction.md","size_in_bytes":7387},{"relative_path":"references/scene-patterns.md","size_in_bytes":3672}],"after":[{"relative_path":"agents/openai.yaml","size_in_bytes":307},{"relative_path":"references/prompt-construction.md","size_in_bytes":5471},{"relative_path":"references/scene-patterns.md","size_in_bytes":3383}]},{"path":"/skill_md_contents","type":"changed","before":"---\nname: kling-ai-generate-image\ndescription: 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.\n---\n\n# Kling AI image generation\n\nTurn 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.\n\n## Operating rules\n\n- 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.\n- 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.\n- 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.\n- Discover live definitions before selecting tools, models, input names, or enum values. Live provider fields override examples.\n- 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.\n\nRead [asset workflows](../kling-ai/references/asset-workflows.md) for subjects, motions, or reference preparation.\n\nBefore 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).\n\n## Workflow\n\nSkip generation steps for an existing-task query.\n\n1. Determine candidate entry points from the mode table and supplied assets. Discover relevant models and check required capabilities before choosing one or constructing parameters.\n2. 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.\n3. 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.\n4. 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.\n5. 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.\n\n## Generation modes\n\n| Intent | Mode | Interpretation |\n| --- | --- | --- |\n| Text-to-image | New image | Build from text without using a source image to control identity or composition. |\n| 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. |\n| 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. |\n| 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. |\n| 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. |\n| 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. |\n| Progress/status | Read-only | Query the existing task without generation. |\n\nDo 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.\n\nBefore calling tools, internally check mode, ratio, reference roles, and allowed changes. Do not show process messages unless creative clarification is necessary.\n\n## Creative constraints\n\nUse 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.\n\n## Quality gates\n\nBefore 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.\n\nWhen 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.\n\n## Failure handling\n\n- Authorization: run the pinned CLI `login`, then verify with `who_am_i`.\n- Unsupported parameters: refresh capabilities and prepare a correction, without automatically resubmitting a prior generation.\n- Insufficient credits: explain and stop until recharged; do not retry automatically.\n- Lost response: recover or report unknown through task results; never replay blindly.\n- Provider failure: summarize safely, retain the task ID, and do not automatically resubmit.\n\n\nSubmit at most once per confirmed paid step. Runtime, polling, and link delivery follow the core CLI workflow.\n","after":"---\nname: kling-ai-generate-image\ndescription: Write or refine Kling image prompts, or prepare and generate approved images and edits, including product photography, portraits, posters, variants, Elements, and continuous image series.\n---\n\n# Kling image generation\n\nFor prompt-only work, use [prompt construction](references/prompt-construction.md) and return the requested prompt. Ask for a missing required image before model discovery. Follow the [core workflow](../kling-ai/SKILL.md) for preparation, billing and results. For local calls use the [CLI contract](../kling-ai/references/cli-contract.md). Submit each authorized task at most once.\n\n## Choose the mode and model\n\n- Use `text_to_image` for a new image or series. Use `image_to_image` when source media controls editable content, identity, product geometry, composition, or style. Preserve each reference's role, slot and order.\n- When model selection is open, prefer Kling Image 4.0 if the live tool lists it and it fits the request. Otherwise prefer a compatible live `defaultModel`, then another compatible model advertised for the same tool. Honor a specific model or a request to use the service default.\n- A continuous image series needs a model that supports series generation at the requested count and resolution in one task. For Kling Image 4.0, use `story_mode` when declared and set `imageCount` when the selected mode honors it. If the model infers the series length from the prompt, state that the count is approximate and get approval before relaxing an exact count. Check that 8K, when requested, is available with the selected mode and count. Multiple independent images cannot fulfill a continuous series.\n- For Elements, use [binding rules](../kling-ai/references/elements-motion-feedback.md#bind-an-element-to-generation). Verify type, required slots and combined reference limits using [live settings](../kling-ai/references/generation-settings.md).\n\n## Quality workflow\n\n1. Use [prompt construction](references/prompt-construction.md) to review the user's prompt. Read the relevant [scene pattern](references/scene-patterns.md) for product, advertising, portrait, cover, or reference editing when useful. Use a suitable supplied prompt verbatim.\n2. State the visible subject, composition, lighting, and material. For editing, identify the requested changes and protect source identity, product geometry, logos, supplied copy and protected areas. Reserve copy-safe space when called for.\n3. Preserve the live resolution default unless the user requests another value or approves a recommendation. Infer a supported ratio from the destination and choose one result by default. Check the exact wording of on-image text and the reference roles.\n4. Follow the core workflow to check balance, submit once and inspect the media when available before claiming visual QA. An unavailable reference pauses the original request. Use the edit task's own ID to recover its output.\n\n## Local CLI examples\n\nReplace `<model>` with the canonical ID and use the verified executable from the CLI contract.\n\n```bash\nkling-plugin text_to_image --model <model> \"A red panda in a vintage spacesuit, lit by Earth's blue glow\"\nkling-plugin image_to_image --model <model> --image ./reference.png \"Restyle in watercolor; preserve subject and composition\"\n```\n"}],"summary":"Fields changed: 3. /description, /included_files, /skill_md_contents.","summary_kind":"deterministic","summary_metadata":{}}