editorial-flatfolk

What this skill does

# /editorial-flatfolk — locked editorial flat-folk illustration

This skill produces one square editorial illustration in a locked hand-drawn naive book-illustration style. The line work, color medium, surface texture, and overall feel are constants. The caller only dials five creative knobs (palette, scene metaphor, perspective, cast, light / weather).

The aesthetic sits in the contemporary editorial / picture-book / pop-folk space — flat saturated color blocks with loose hand-drawn ink line work sitting ON TOP of the color, subtle paper grain across the canvas, and a charming slightly imperfect hand. Adjacent to Pol Mara, Klaus Haapaniemi, and Carson Ellis editorial work. Not anime, not vector, not photoreal, not soft watercolor wash, not flat-vector poster.

## Required model

This style is locked to **`gpt-image-1.5`** (OpenAI image generation through whichever provider the executing tool routes to). The combination of flat saturated color, loose hand-drawn ink overlay, paper grain, and naive architectural depth requires this specific model; it does not survive on harder-line vector models or softer painterly models.

Required generation parameters:

- **Model:** `gpt-image-1.5`
- **Size:** `1024x1024` (square)
- **Quality:** `high` — the paper grain and ink hatching need resolution to read
- **Mode:** **image-to-image** with `ref-harbor.png` (the locked style anchor that lives next to this SKILL.md) passed as the style reference
- **Style:** caller must opt out of stacked style injection (the executing tool should pass `--skip-style` or its equivalent — the SKILL itself is the style)

These are semantic parameters. The executing tool decides the invocation mechanics (CLI command, REST call, gateway, local runtime).

## Reference anchors

Three reference images live alongside this SKILL.md:

- `ref-harbor.png` — **the canonical style anchor** (coastal-peach palette, harbor metaphor, golden-hour light, solo wanderer cast, one-point dock perspective). This is the locked anchor every generation must use for image-to-image style hold.
- `ref-alpine.png` — clean output from the validation batch: winter-cool palette, alpine-village metaphor, snow-midday light, solo child cast, one-point sloped lane perspective.
- `ref-park.png` — clean output from the validation batch: autumn-rust palette, park metaphor, midday light, seated character cast, low-angle hero perspective.

`ref-harbor.png` is the **required** style reference. The other two are exemplars showing how the dials move within the locked style.

## Locked style axes (NEVER vary)

### Color medium
- Flat, saturated color blocks. Each shape is one solid color.
- No airbrush gradients, no soft pastel haze, no internal form modeling, no 3D rendering inside shapes.
- A faint vertical sky gradient is acceptable (warm-to-cool low horizon); everywhere else stays flat.

### Line work
- Loose hand-drawn black ink lines that sit ON TOP of the color blocks — not as outlines that perfectly trace the shape's perimeter.
- Lines wobble slightly, occasionally cross or fall short of a color edge, never look ruler-straight.
- Line weight is fairly uniform; this is not a brush-pen calligraphic style.

### Surface texture
- Subtle paper grain across the entire canvas. Visible but quiet.
- The grain is the ONLY texture allowed; nothing inside any shape should be brushy, impressionistic, or gouache-thick.

### Sky treatment
- Simple ink sun-ray hatching radiating from the sun, OR ink rain ticks for wet scenes, OR ink-tick snowflakes for cold scenes.
- Cloud forms are drawn as simple soft humps with a single optional outline.

### Composition
- A clear depth axis. Default is one-point perspective with two flanking walls of color receding to a vanishing point.
- Tall narrow architecture lines the receding walls when the scene metaphor allows (row houses, harbor-front shops, alpine chalets, market stalls).
- The scene metaphor IS the composition; do not retrofit a generic urban template with relabeled props (see Pitfalls).

### Mood
- Editorial, picture-book, naive, observational. Calm and warm by default; pivots cleanly into rainy, snowy, or twilight tones via the Light dial without changing the underlying flatness.

## Dialable knobs (vary per illustration)

### 1. Palette
Pick one. Always name 4–6 specific anchor colors in the prompt.

- **warm-primary** (default) — mustard yellow / tomato red / cobalt blue / leaf green / terracotta / cream sky.
- **coastal-peach** — soft peach / coral / cobalt / mustard / terracotta / rose-gold sky.
- **jewel-night** — deep indigo / magenta / jade green / lantern yellow / plum / charcoal.
- **winter-cool** — cream snow / pale icy blue / evergreen / plum / terracotta-red roofs / mustard window frames.
- **autumn-rust** — burnt orange / ochre / plum / sage green / deep brick red / cream sky.
- **monsoon-twilight** — slate blue / teal / dusty rose / mustard / cream / charcoal.

### 2. Scene metaphor
The scene IS the metaphor — pick a place that itself embodies the idea. Examples that respect the style:

- **street** — tall narrow row houses lining a cobblestone lane.
- **harbor** — wooden dock between two rows of fishing boats with colored hulls, harbor-front shops behind (the canonical anchor).
- **market** — covered stalls lining a market street, awnings, hanging lanterns.
- **transit** — a small train platform, a tram stop, a ferry terminal.
- **park** — a clearing with a bench, fountain, or stone bridge; tall trees as the flanking depth elements.
- **square** — a town plaza with a clock tower or fountain centered, shopfronts framing the edges.
- **interior** — a small café, library reading room, or shop interior with tall narrow windows.
- **alpine-village** — chalet houses with steep snow-capped roofs along a sloped lane, evergreens flanking.

If the scene metaphor is a pure-nature scene with no buildings, FORCE one architectural anchor element (a bench, a stone bridge, a wooden bandstand, a fountain). Otherwise the style softens — see Pitfalls.

### 3. Perspective
- **one-point street** (default) — straight depth axis with two flanking walls of architecture receding to a vanishing point.
- **frontal facade** — flat parallel composition, one wall of buildings filling the frame.
- **low-angle hero** — looking slightly up at a central figure or structure framed by trees / buildings.
- **isometric** — for top-down map-like scenes; the style still holds but loses the receding-rhythm feel.
- **top-down** — bird's eye map view; use sparingly, only for explicit "map" scenes.

Default to **one-point street** unless the brief explicitly requests another. Composition without a clear depth axis reads flat — see Pitfalls.

### 4. Cast
- **solo wanderer** (default) — a single figure walking, cycling, or standing in the scene, typically rear- or three-quarter-view.
- **paired** — two figures, often sharing an umbrella, walking together, or facing each other.
- **small crowd** — 4–8 background figures plus one foreground anchor figure.
- **none** — no figures, only architecture and atmospheric elements.

Figures are drawn small-to-medium relative to the frame; they anchor the scale of the architecture, they are not portraits.

### 5. Light / weather
- **midday sun** (default) — warm cream sky with simple ink sun-ray hatching.
- **golden hour** — warm peach / rose sky, low sun, longer ink sun rays.
- **rain** — wet cobblestone reflections, ink rain ticks, NO atmospheric haze — see Pitfalls.
- **snow** — pale icy sky, ink-tick snowflakes, snow caps on architecture.
- **blue hour** — deep blue sky with one or two ink-line clouds, lit windows glowing.

## Pitfalls (lock these in the prompt)

These are validated failure modes from the calibration batch:

1. **Dark + wet drift.** At the dark-and-rainy extreme, the model drifts toward impressionist atmospheric texture (Van Gogh nightscape territory). The prompt must explicitly include `flat color blocks, no atmospheric texture, no impressionist brush