AgentKit
DocsKitsCLI ReferenceDesktop App
BetaYou are reading docs for the beta channel (2.13.0-beta.20). Features may change before the next stable release.Switch to stable →

Skills

Generate visual concepts with ak:ai-artist

Refine a visual brief, search curated prompt patterns, and render reviewable image variations through an approved provider.

Use ak:ai-artist to turn a visual concept into a refined Nano Banana prompt and one or more generated PNG assets. The Skill searches a bundled collection of 129 prompt patterns, validates the intended style, mood, and color direction, then routes rendering through the ak:ai-multimodal backend to Google or OpenRouter-backed Google image models.

Choose prompt-led image generation

Use ak:ai-artist when

  • You need a product mockup, campaign visual, social asset, banner, infographic, avatar, concept art, or style exploration.
  • A curated prompt can anchor a consistent visual direction.
  • You want a close match, a remix of several patterns, or an experimental style transformation.
  • You want to inspect the assembled prompt before provider generation.

Choose another workflow when

  • You need to inspect or transform existing image, audio, video, or document inputs. Use ak:ai-multimodal.
  • You need deterministic local resizing, compositing, encoding, or background removal. Use ak:media-processing.
  • You need layout, typography, accessibility, and implementation guidance for a product interface. Use ak:frontend-design.
  • You cannot send the concept or reference material to an external AI provider.

Prepare the brief and provider

Before you start:

  • Complete Onboarding, and confirm Engineer Kit is installed for the current runtime and scope.
  • Provide the subject, audience, use case, style, mood, palette, composition, aspect ratio, exact in-image text, exclusions, and output location.
  • Decide whether the validation interview may be bypassed with --skip. Without that explicit option, the Skill must refine the brief before generation.
  • Make Python 3 and npx available. The rendering script fetches and runs the npm-latest @mrgoonie/multix package.
  • Configure GEMINI_API_KEY for direct Google or OPENROUTER_API_KEY for the OpenRouter route, then approve provider terms, network use, and budget.
  • Confirm that the prompt and any brand information may leave the local machine.
RuntimeInvocationAvailability boundary
Claude Code/ak:ai-artist ...The Skill can run its Python workflow and provider subprocess when local tools, credentials, and network are approved.
Cursor/ak:ai-artist ...Slash invocation is user-verified; equivalent subprocess, credential, and artifact handling depend on the Cursor session.
Codex$ak:ai-artist ...Native discovery is supported; external image tools, provider access, and approval behavior are not automatically equivalent.

Generate a reviewable variation

/ak:ai-artist "Create a 16:9 launch banner for a developer CLI: dark background, restrained steel-blue glow, terminal-inspired geometry, no logos, no people, and no text; use search mode and save a PNG"

Select the generation shape

Input or optionBehaviorObservable output
No mode, or --mode searchUses the highest-ranked matching curated promptOne image at the requested output path
--mode creativeRemixes structure and style hints from the top matching promptsOne combined interpretation
--mode wildRandomly applies an experimental artistic transformationOne non-deterministic interpretation
--mode allRuns search, creative, and wildThree files suffixed -search, -creative, and -wild
--provider autoHonors IMAGE_GEN_PROVIDER; otherwise selects from configured Google or OpenRouter credentialsProvider used should appear in verbose evidence
`--model flash2flashpro`
-ar, --aspect-ratioSelects one of the supported ratios such as 1:1, 16:9, or 9:16Image with the requested composition ratio
`--size 1K2K4K`
--dry-runBuilds and prints the prompt without calling image generationPrompt evidence, no image file
--skip on the Skill invocationBypasses the mandatory validation interviewThe generation script itself does not define this flag

Observe the creative stages

  1. The Skill validates the brief. Unless --skip was explicit, it resolves material gaps in subject, style, mood, color, text, and output intent.
  2. It searches local patterns. BM25 matching ranks the bundled prompt rows against the concept; search mode falls back to a basic prompt when no row scores above zero.
  3. It adapts the prompt. Placeholders are replaced with the concept and negative constraints are added when the source lacks them.
  4. It applies the selected mode. Creative mode combines matched hints; wild mode selects a random transformation; all mode prepares three variants.
  5. It resolves the provider and model. The script chooses the direct Google or OpenRouter command from explicit options, environment, and credentials.
  6. It renders the file. A subprocess sends the prompt and parameters to the provider and writes the requested PNG path, with a five-minute script timeout.
  7. It returns evidence. The final prompt when requested, provider, model, output paths, failures, and visual review notes are reported.

Control privacy, rights, cost, and randomness

Generation sends creative material to an external provider

Prompts, brand details, exact text, and any provider metadata leave the local environment. Do not include secrets, private customer data, protected source assets, or identity references without permission and appropriate rights.

  • npx can download and execute the npm-latest rendering package; generation uses network, provider quota, compute, and potentially billable requests.
  • --mode all makes three provider calls. Failed or timed-out requests may still consume provider resources; check the provider account before retrying.
  • Wild mode is random, and provider generation is not guaranteed reproducible. Preserve selected files and the prompt rather than assuming a rerun matches.
  • Generated text, logos, anatomy, factual diagrams, and exact brand elements can be wrong. Inspect the pixels; prompt success is not asset approval.
  • Validate usage rights, likeness consent, trademarks, and required disclosure before publishing. The Skill does not grant rights to source prompts or output.
  • Generation writes files but does not publish, upload, commit, or deploy them unless a separate authorized workflow performs that action.

Verify the output

A complete result should include:

  • The validated brief, selected mode, aspect ratio, size, provider, and model.
  • The final prompt or a safe summary, including exact requested text and negative constraints.
  • Every output path and the relationship between each file and its mode.
  • Visual checks for subject, composition, text, unwanted elements, artifacts, and brand constraints.
  • Provider errors, timeouts, missing credentials, cost-sensitive retries, and any rights or privacy review still needed.

Stable and beta ship identical prompt data, scripts, and ak:ai-artist source. No directly scoped release test proves provider availability, output quality, cross-runtime process parity, or deterministic pixels.

Troubleshoot and interpret limits

SymptomSafe next step
The concept matches the wrong promptUse a more specific subject and use case, inspect with --dry-run, or select creative mode deliberately.
--skip fails when passed to generate.pyKeep --skip on the ak:ai-artist invocation; the Python renderer does not accept it.
No provider credential is availableConfigure the approved route or stop at --dry-run; do not paste a secret into the prompt or repository.
npx or Python is unavailableInstall the missing local prerequisite only with approval and record the environment gap.
Generation times out or returns an errorPreserve the provider error, check quota and network, and ask before a potentially billable retry.
Mode all produced several filesReview each suffixed output independently; do not treat variation count as quality evidence.
In-image text or layout is wrongStrengthen exact text and placement constraints, then regenerate only with approved cost; edit locally when deterministic correction is better.
You need to edit an existing assetSwitch to ak:ai-multimodal or a deterministic ak:media-processing workflow.
The runtime does not recognize the SkillConfirm target and scope, restart the runtime session, then follow Runtime cannot find a Skill or Agent.