pneuma-skills: Skill for Codex

/showcase — Generate Mode Showcase Materials

Generate showcase marketing images and metadata for a Pneuma mode's launcher gallery.

Input

The user provides a mode name (e.g. remotion, draw). If not specified, ask.

Step 1: Analyze the Mode

Read the mode's manifest and skill to understand:

• modes/<name>/manifest.ts — displayName, description, icon, key features
• modes/<name>/skill/ — what the mode does, its workflow, unique capabilities
• modes/<name>/showcase/showcase.json — existing showcase data (if any)

Identify 3 key selling points — the features that would make someone want to try this mode. Think from a user's perspective: what's exciting? what's unique?

Step 2: Write showcase.json

Create modes/<name>/showcase/showcase.json:

{
  "tagline": "Short punchy tagline (5-10 words)",
  "hero": "hero.png",
  "highlights": [
    {
      "title": "Feature Name",
      "description": "1-2 sentence description of the feature and why it matters.",
      "media": "feature-name.png",
      "mediaType": "image"
    }
  ]
}

Rules:

• Tagline: short, evocative, no period at end
• 3 highlights (occasionally 4 for complex modes)
• Titles: 2-4 words, punchy, title case
• Descriptions: concrete, benefit-focused, 1-2 sentences
• Media filenames: kebab-case, descriptive

Step 3: Generate Showcase Images

Generate 4 images (1 hero + 3 highlights) using modes/_shared/scripts/generate_image.mjs through OpenRouter (OPENROUTER_API_KEY). New images default to GPT Image 2.5 Flare; pass --model sunburst when generation needs greater precision. Use edit_image.mjs for edits (Sunburst by default), or generate_image.mjs --model sunburst --image-urls ... for edits with multiple references. Inspect reference images first. If OpenRouter image generation is unavailable, complete the metadata and report which assets still need generation.

Image specs:

• Dimensions: 1376×768 pixels (16:9)
• Save to: modes/<name>/showcase/

Visual style — "Ethereal Tech Dark Mockup":