AGENT SKILL

generate-art

Generate static artwork/illustrations for a repo with Nano Banana Pro (aka "nano banana", Gemini 3 Pro Image) via the bundled generate_art.py — craft a detailed prompt, run the script, view the result, iterate. Use this whenever the user wants to create, generate, or regenerate a visual asset for a project: an architecture diagram, portrait, card/illustration, icon, splash, or any image that lands as a PNG in the repo — even if they don't name the tool or just say "make me an image / a picture of X". Do NOT trigger for application runtime image needs, or for editing source code rather than producing an image file.

License 许可
Apache-2.0
最近更新
2026-09-21
Stars
★ 1
Forks
0

01 前言 Front Matter

name
generate-art
description
Generate static artwork/illustrations for a repo with Nano Banana Pro (aka "nano banana", Gemini 3 Pro Image) via the bundled generate_art.py — craft a detailed prompt, run the script, view the result, iterate. Use this whenever the user wants to create, generate, or regenerate a visual asset for a project: an architecture diagram, portrait, card/illustration, icon, splash, or any image that lands as a PNG in the repo — even if they don't name the tool or just say "make me an image / a picture of X". Do NOT trigger for application runtime image needs, or for editing source code rather than producing an image file.

02 资源文件 2

03 SKILL.md 正文

Generate art

Build-time asset tooling. The engine is scripts/generate_art.py, bundled in this skill; the skill body is the prompt-craft + iterate loop around it.

This skill is a general art generator — it knows how to generate, apply a style, and cast a character, but ships with no project-specific art. A project's house styles live in the project (docs/styles/ by default, see "Style presets"), and the cast pool is just whatever portraits a project points --cast-dir at. Same skill, any repo.

Boundary — build-time only

This is build-time tooling, not application runtime. It produces static PNGs checked into the repo; it should never run inside a shipped application or its request path. Keep the Gemini SDK and GEMINI_API_KEY out of runtime code paths. If a project has rules constraining which LLMs may appear in runtime code, honour them — this script's place is the build/asset pipeline, not the app.

Prerequisites

  • GEMINI_API_KEY (or GOOGLE_API_KEY) set in the environment. The script reads it; do not hardcode keys.
  • uv available. The script is a self-contained PEP 723 script — uv run installs google-genai + pillow into an ephemeral env. No project deps.

Run

Run from the repo root (adjust the path to wherever the skill is installed):

uv run scripts/generate_art.py --prompt "<prompt>" --out <path.png> [--banana pro] [--aspect 16:9] [--size 2K] [--ref existing.png]
  • --prompt / --prompt-file — one is required. For long prompts, write to a temp file and use --prompt-file to avoid shell-quoting pain.
  • --out — required. Save to a tracked dir (be mindful of .gitignore). See output conventions below.
  • --banana — pro (Gemini 3 Pro Image, default) or flash (Gemini 2.5 Flash Image — cheaper/faster, lower fidelity). Use flash for quick drafts/icons, pro for hero/diagram art and anything text-heavy or detail-critical.
  • --model — explicit model id; overrides --banana if a new variant ships.
  • --aspect — 1:1 3:2 2:3 3:4 4:3 4:5 5:4 9:16 16:9 21:9 (default 16:9).
  • --size — 1K | 2K | 4K (default 2K). Pro only; ignored for flash.
  • --style — named style preset from --styles-dir. Appends the distilled house-style block to the prompt. Prefer this over --ref for style matching — see "Style presets" below.
  • --styles-dir — where project style presets live (default docs/styles).
  • --style-file — ad-hoc style preset file; overrides --style.
  • --cast — opt-in: feature a real person's likeness in the art. random picks one; or pass a name (file stem in --cast-dir). Off by default. Great for people/process art where it's nice that the moment happens to a real person. Combine with a --style.
  • --cast-dir — portrait dir for --cast (default assets/portraits).
  • --ref — reference image(s) for style/edit continuity; repeatable. Use to edit an existing image, or to anchor on a specific asset when text alone isn't enough. Note: passing a character portrait as --ref reproduces that person — for generic art prefer --style; for intentional person reuse prefer --cast.

Style presets

Style presets are project content, not part of this skill. The skill is a general art generator; each project keeps its own house styles and points --styles-dir at them (default docs/styles/). A preset is a markdown file of distilled style guidance that --style <name> appends to the prompt, so a house look stays consistent across calls — without passing a character image as --ref (which tends to clone that specific person).

Use a preset: add --style <name> to any call (resolves to docs/styles/<name>.md). The per-asset prompt still carries the scene and composition negatives (no text, no frame, aspect); the preset carries only the look.

Distil a new style (the reusable "capture the look once" step):

  1. Look at 2-3 real reference images with the Read tool — the actual rendered art you want to match, not a written spec (specs drift from reality).
  2. Write what you observe: medium/rendering, linework, shading & light, palette, background treatment, mood. Describe the look, not any scene or subject. Keep composition/negatives out — those are per-asset.
  3. Save it to the project's styles dir as docs/styles/<name>.md with an # Style: <name> heading. (It lives in the project, not the skill.)
  4. Validate: generate one asset with --style <name> and no character --ref, then Read the output and check it matches the references.

Keep presets look-only and subject-agnostic so they compose with any prompt.

Generic vs. casting a real person. Two deliberate paths, both opt-in:

  • Generic in-style (default/standard) — --style <name>, no character ref. The art matches the house look but depicts nobody in particular.
  • Cast a real person (option) — add --cast random (or --cast <name>) to feature an actual portrait from --cast-dir. Nice for people/process art where it lands that the moment happens to a real person. The script logs which portrait it cast. This is an option, not the default — only reach for it when reuse is wanted.

Output conventions

Save assets to a tracked directory and pick the aspect that fits the asset. A common layout:

  • Portraits → assets/portraits/<name>.png, --aspect 3:4. Match an existing roster's style (pass an existing portrait via --ref or a --style).
  • Diagrams / architecture visuals → docs/assets/, --aspect 16:9.
  • Card / icon / illustration art → ask where it should live; default docs/assets/.

Confirm the destination dir is not .gitignored before writing.

Workflow

  1. Clarify the asset — what it depicts, where it lands, aspect, and whether it must match an existing style (if so, use --style; distil a new preset first if none fits).
  2. Craft the prompt yourself. Ground it in the project's design docs and any relevant rules. Be specific about subject, layout, labels, palette, and style; end with negatives (no logos, no paragraphs of text). Long prompts → temp file + --prompt-file.
  3. Run the script.
  4. View the result with the Read tool on the output PNG and judge it against what was asked — do not claim success without looking.
  5. Iterate on the prompt (or add --ref) until it's right. Show the user the image and the final path.

Notes

  • Output is non-deterministic; same prompt varies run to run.
  • If the response has no image (safety filter / refusal), the script exits with an error — adjust the prompt and retry.

04 同仓库更多 Skills

JasperHG90
JasperHG90/shakedown

fake-skill

A skill used only by shakedown's own offline tests.

★ 1
JasperHG90
JasperHG90/shakedown

shakedown-canary

Run the shakedown canary check. Use whenever someone asks to run the canary check, verify the harness, or confirm shakedown is wired up correctly.

★ 1
JasperHG90
JasperHG90/shakedown

create-cases

Author a shakedown cases file (`shakedowns/<slug>.cases.toml`) for an existing agent skill: read the skill, turn what it promises into cases, supply fixtures for the commands it must not really run, and check the result with `shakedown case validate`. Use this whenever someone wants to measure, smoke-test, or add conformance cases for a skill, asks "how do I test this skill", points at a SKILL.md and wants cases written, or is editing a `.cases.toml`. Use it even when they only name the skill ("write cases for connect-agent-to-hub") without mentioning shakedown or TOML.

★ 1
JasperHG90
JasperHG90/shakedown

analyze-results

Read a shakedown report (`shakedown-report.json`) and say which file to open: the measured skill's own `SKILL.md`, the `shakedowns/<slug>.cases.toml` holding its cases, the harness block in `shakedown.toml`, or a flag on the run itself. Use this whenever someone has run `shakedown case run` and wants to know what a number means or what to do about it, pastes a report or the PR comment rendered from one, asks why `skill_fired`, `tool_used`, `artifact_created` or `inputs_resolved` came out low, asks whether a rate is worth acting on, or says a conformance run failed and they cannot tell whose fault it is. Use it even when they only quote the percentage ("my skill scores 60% on inputs_resolved, now what") without naming shakedown or the report file.

★ 1
JasperHG90
JasperHG90/shakedown

add-harness

Add a new agent harness (opencode, Gemini CLI, Codex, Amp, a local Ollama-backed runner, or any CLI that loads skills) to a shakedown config so its skill conformance can be measured, and diagnose a harness that `shakedown doctor` reports as not qualifying. Use this whenever someone wants shakedown to run against a harness it does not yet support, asks why a harness fails doctor, asks how to point an existing harness at a different model or provider, or is editing the `[harness.*]` block of a shakedown.toml. Use it even when they only name the tool ("can this test opencode?") without mentioning config or TOML.

★ 1
JasperHG90
JasperHG90/shakedown

create-cases

Author a shakedown cases file (`shakedowns/<slug>.cases.toml`) for an existing agent skill: read the skill, turn what it promises into cases, supply fixtures for the commands it must not really run, and check the result with `shakedown case validate`. Use this whenever someone wants to measure, smoke-test, or add conformance cases for a skill, asks "how do I test this skill", points at a SKILL.md and wants cases written, or is editing a `.cases.toml`. Use it even when they only name the skill ("write cases for connect-agent-to-hub") without mentioning shakedown or TOML.

★ 1