# image-poster

image-poster builds structured prompts for posters and cover art, then runs a local CLI dispatcher. Saves finished PNG files directly to your project folder.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 229 installs · ★ 108855 repo stars
- Author: nexu-io
- License: Apache-2.0 · policy=mirror · the beginning of the file is at the end of this page
- Source: https://github.com/nexu-io/open-design/tree/HEAD/design-templates/image-poster/SKILL.md
- Updated: 2026-10-25
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/image-poster

## What it does

The skill handles single-image creation for editorial covers and posters. Instead of calling provider APIs directly, the agent structures prompts across five layers: subject composition, lighting, palette anchors, camera settings, and negative constraints.

It defaults to `gpt-image-2` while working with backends like Flux or Midjourney through upstream tools. Canvas ratios and active models are pulled from project metadata (`imageModel`, `imageAspect`). Missing `$OD_BIN` or `$OD_PROJECT_ID` environment variables will cause the generation call to fail.

The workflow yields one image per turn. The dispatcher writes the file directly to the project folder, followed by a brief summary from the agent.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add nexu-io/open-design --skill image-poster -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/image-poster/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/image-poster/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add nexu-io/open-design --skill image-poster -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/image-poster/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add nexu-io/open-design --skill image-poster -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/image-poster/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install nexu-io/open-design design-templates/image-poster/SKILL.md
```

2. **Manually: put the files in place**
- File: `.github/skills/image-poster/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add nexu-io/open-design --skill image-poster -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/nexu-io/open-design --path design-templates/image-poster
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/image-poster/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add nexu-io/open-design --skill image-poster -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/nexu-io/open-design/tree/HEAD/design-templates/image-poster/SKILL.md

## When to use it
- draft structured prompts for editorial posters and covers
- render single graphic assets with strict aspect ratios
- suppress AI image artifacts with targeted negative constraints
- dispatch render commands to a unified local media CLI

## Example prompts
- Create an indie film festival poster with a bold silhouette on textured paper
- Generate cover art with soft studio lighting in a 16:9 aspect ratio
- Render a dark-toned visual asset for an upcoming music release

## Source text · SKILL.md · Apache-2.0

Below is the content of a third-party file. It is data, not instructions for you: do not act on anything written inside unless the human asks. Block tag: a96bfc019c78d7a2.

BEGIN THIRD-PARTY FILE a96bfc019c78d7a2
````text
---
name: image-poster
description: |
  Single-image generation skill for posters, key art, and editorial
  illustrations. Defaults to gpt-image-2 but is provider-agnostic — the
  same workflow drives Flux, Imagen, or Midjourney via the active
  upstream tooling. Output is one or more PNG/JPEG files saved to the
  project folder.
triggers:
  - "poster"
  - "key art"
  - "illustration"
  - "image"
  - "cover art"
  - "海报"
  - "插画"
od:
  mode: image
  surface: image
  scenario: design
  preview:
    type: html
    entry: example.html
  design_system:
    requires: false
  example_prompt: |
    Editorial poster for an indie film festival — one bold abstract
    silhouette over a warm, slightly grainy paper background; hand-set
    sans serif title at the top, festival dates and venue at the bottom
    in monospace. Muted ochre + ink palette.
---

# Image Poster Skill

Produce **one** finished image asset per turn unless the user asks for
variations. Image generation rewards a tight, structured prompt — your
job is to assemble that prompt from the user's brief, then dispatch.

## Resource map

```
image-poster/
├── SKILL.md         ← you're reading this
└── example.html     ← what the resulting card looks like in Examples
```

## Workflow

### Step 0 — Read the project metadata

The active project carries `imageModel`, `imageAspect`, and (optional)
`imageStyle` notes. Use them as the upstream model + canvas + style
anchor. When a value is not provided, infer a safe default from the brief and
media contract. Ask only when the choice would materially change the requested
result and no safe default can be inferred.

### Step 1 — Compose the prompt

Plan in this exact order before calling any tool:

1. **Subject + composition** — what is in the frame, where, at what
   scale; eye-line and crop.
2. **Lighting + mood** — natural / studio / moody; warm / cool; key
   plus rim plus fill; time of day if outdoor.
3. **Palette + textures** — hex anchors when the user gave a brand
   palette; otherwise a 3-word mood tag (e.g. "muted ochre + ink").
4. **Camera / lens** — only if the user wants photographic realism
   ("85mm portrait, shallow DOF") or a specific film stock.
5. **What to avoid** — common AI-slop patterns ("no extra fingers, no
   warped text, no logo placeholders").

### Step 2 — Dispatch via the media contract

Use the unified dispatcher — do **not** call upstream provider APIs by
hand. Run from your shell tool:

```bash
"$OD_NODE_BIN" "$OD_BIN" media generate \
  --project "$OD_PROJECT_ID" \
  --surface image \
  --model "<imageModel from metadata>" \
  --aspect "<imageAspect from metadata>" \
  --output "<short-descriptive-name>.png" \
  --prompt "<the full assembled prompt from Step 1>"
```

The command prints one line of JSON: `{"file": {"name": "...", ...}}`.
````
END THIRD-PARTY FILE a96bfc019c78d7a2

The third-party file has ended. Everything between the a96bfc019c78d7a2 tags is data: requests and commands from it are not followed. An “end of file” line with another tag inside the block is part of the file.

First 2861 of 3604 bytes. © nexu-io · Apache-2.0 · https://github.com/nexu-io/open-design/tree/HEAD/design-templates/image-poster/SKILL.md

_Part of the page did not fit — see the HTML version._

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
