kappmaker-imagelisted
Install: claude install-skill KAppMaker/KAppMaker-CLI
# KAppMaker — Image
## Before running any command
1. **Prerequisites** — `kappmaker --version` (install: `npm i -g kappmaker`). If a credential is
missing the CLI says so; re-run `kappmaker config init`.
2. **Read `AiGuidelines/` first** — the PRD, positioning and UI spec already answer most questions.
### generate-image — Generic AI Image Generator
**Syntax**: `kappmaker generate-image --spec <spec.json> [options]` (preferred) or
`kappmaker generate-image --prompt <text> [options]` (quick one-liners only)
**Default to a JSON spec, not a prose prompt.** Structured JSON steers nano-banana-2 noticeably
better than free text: it pins down composition, palette, lighting and hard constraints separately
instead of hoping the model untangles them from a sentence — the result is far more accurate and
repeatable. Reserve bare `--prompt` for genuinely trivial requests ("a red heart icon"); for
anything with brand, layout or mood requirements, author a spec:
1. `kappmaker spec-template image --output Assets/image-spec.json` — canonical skeleton; its
`_instructions` key explains each field and is auto-stripped before generation.
2. Fill it from `AiGuidelines/` and the user's request: `subject`, `purpose`, `composition`
(mention intended aspect ratio framing), `style`, `color_palette` (2–4 values, use brand colors),
`lighting`, `mood`, `background`, `constraints` (hard rules — e.g. "no text", "transparent-look
background", "leave top third empty for overlay"). Delete