home / skills / yoanbernabeu / producthunt-skills / ph-gallery-assets

ph-gallery-assets skill

/skills/content/ph-gallery-assets

This skill helps you design and optimize Product Hunt gallery images to showcase features, tell a compelling story, and maximize conversions.

npx playbooks add skill yoanbernabeu/producthunt-skills --skill ph-gallery-assets

Review the files below or copy the command above to add this skill to your agents.

Files (1)
SKILL.md
9.6 KB
---
name: ph-gallery-assets
description: Create compelling gallery images for Product Hunt. Use this skill to plan, design, and optimize the image gallery that showcases your product's features, benefits, and value proposition to potential users.
---

# Product Hunt Gallery Assets

This skill helps you create a compelling gallery that tells your product's story, showcases key features, and convinces visitors to try your product.

## When to Use This Skill

- Planning your gallery image sequence
- Creating feature showcase images
- Designing before/after comparisons
- Including video in your gallery
- Optimizing gallery for conversion

## Gallery Requirements

### Technical Specs
- **Minimum images:** 2 (required)
- **Recommended:** 4-6 images
- **Formats:** PNG, JPG, GIF
- **Video:** YouTube links only
- **Order:** Drag-and-drop reorderable

### Best Practices
- Tell a story from first to last image
- Show actual product, not just marketing
- Include at least one video/demo if possible
- Make each image standalone yet connected

## The Gallery Story Framework

### Image Sequence Strategy

```
IMAGE 1: The Hook
↓ "What is this?"
IMAGE 2: The Problem
↓ "I have this problem!"
IMAGE 3: The Solution
↓ "This solves it!"
IMAGE 4: Key Feature 1
↓ "That's impressive"
IMAGE 5: Key Feature 2
↓ "Even more value"
IMAGE 6: Social Proof / CTA
→ "I should try this"
```

## Image-by-Image Guide

### Image 1: The Hook (REQUIRED)

**Purpose:** Stop the scroll, explain what this is

**Options:**
- Hero shot with tagline overlay
- Product in action (GIF)
- Bold value proposition statement

**Template:**
```
┌────────────────────────────────┐
│                                │
│     [PRODUCT NAME]             │
│                                │
│     [Tagline/Value Prop]       │
│                                │
│     [Product Screenshot]       │
│                                │
└────────────────────────────────┘
```

**Checklist:**
- [ ] Product name visible
- [ ] Core value proposition clear
- [ ] Product UI/interface shown
- [ ] Visually compelling

---

### Image 2: The Problem/Context

**Purpose:** Establish the pain point you solve

**Options:**
- Before state visualization
- Problem statistics
- "The old way" frustration

**Templates:**

**A) The Frustration**
```
┌────────────────────────────────┐
│                                │
│   😫 Sound familiar?           │
│                                │
│   • Pain point 1               │
│   • Pain point 2               │
│   • Pain point 3               │
│                                │
│   There's a better way →       │
│                                │
└────────────────────────────────┘
```

**B) The Statistics**
```
┌────────────────────────────────┐
│                                │
│      [Shocking Stat]           │
│           ↓                    │
│   "[Problem costs X hours/     │
│    dollars per week]"          │
│                                │
└────────────────────────────────┘
```

---

### Image 3: The Solution

**Purpose:** Show how your product solves the problem

**Options:**
- After state visualization
- Product in action (GIF/video)
- Before → After comparison

**Template: Before/After**
```
┌────────────────────────────────┐
│   BEFORE     │     AFTER       │
│              │                 │
│   [Chaos]    │   [Order]       │
│   [Complex]  │   [Simple]      │
│   [Slow]     │   [Fast]        │
│              │                 │
│   ────────── → ──────────     │
│         With [Product]         │
└────────────────────────────────┘
```

---

### Image 4-5: Key Features

**Purpose:** Highlight 2-3 most impressive features

**For Each Feature:**
- Feature name (bold)
- What it does (brief)
- Why it matters (benefit)
- Visual demonstration

**Template:**
```
┌────────────────────────────────┐
│                                │
│   ⚡ [Feature Name]            │
│                                │
│   [Screenshot/Demo]            │
│                                │
│   [One-line benefit]           │
│                                │
└────────────────────────────────┘
```

**Feature Selection Criteria:**
- Most unique/differentiating
- Most requested by users
- Hardest to build (shows effort)
- Most visual/demonstrable

---

### Image 6: Social Proof / CTA

**Purpose:** Build trust, encourage action

**Options:**

**A) Testimonials**
```
┌────────────────────────────────┐
│                                │
│   ⭐⭐⭐⭐⭐                     │
│                                │
│   "[Quote from user]"          │
│                                │
│   — Name, Title @ Company      │
│     [Logo]                     │
│                                │
└────────────────────────────────┘
```

**B) Metrics**
```
┌────────────────────────────────┐
│                                │
│   Trusted by                   │
│                                │
│   10,000+ │ 4.9/5 │ 50+ Cos   │
│   Users   │ Rating │ trust us  │
│                                │
│   [Company logos row]          │
│                                │
└────────────────────────────────┘
```

**C) CTA**
```
┌────────────────────────────────┐
│                                │
│   Ready to [benefit]?          │
│                                │
│   ┌──────────────────────┐    │
│   │   Get Started Free   │    │
│   └──────────────────────┘    │
│                                │
│   🎁 PH Special: [Offer]       │
│                                │
└────────────────────────────────┘
```

## Gallery Types by Product

### SaaS/Web App
1. Hero with dashboard
2. Key workflow demo (GIF)
3. Feature highlight 1
4. Feature highlight 2
5. Integration showcase
6. Pricing/testimonials

### Mobile App
1. App on device mockup
2. Key screens (3-up or carousel)
3. Feature 1 demo
4. Feature 2 demo
5. User reviews/ratings
6. Download CTA

### Developer Tool
1. Code/terminal example
2. Before/after code comparison
3. Integration simplicity
4. Performance metrics
5. Documentation preview
6. GitHub stars/adoption

### AI Product
1. AI in action (GIF)
2. Input → Output example
3. Accuracy/quality metrics
4. Use case 1
5. Use case 2
6. API/integration options

## Video Integration

### YouTube Video in Gallery
- Creates more engagement
- Shows product in motion
- PH algorithm favors video

**Video Requirements:**
- YouTube link only
- Not set to private
- Upload before launch day
- Test embed works

**Ideal Video Content:**
- 30-90 second demo
- Hook in first 5 seconds
- Show the "aha" moment
- End with CTA

### Interactive Demos
Use tools like:
- Arcade
- Supademo
- Storylane
- Hexus

## Design Best Practices

### Do:
- ✓ Maintain consistent style/branding
- ✓ Use high-resolution images
- ✓ Include annotations/callouts
- ✓ Show real product, not mockups
- ✓ Test on mobile viewing
- ✓ Use dark mode screenshots if product has it

### Don't:
- ✗ Use stock photos
- ✗ Include tiny unreadable text
- ✗ Make images too text-heavy
- ✗ Use different visual styles
- ✗ Include outdated UI
- ✗ Skip quality control

## Gallery Checklist

### Content
- [ ] First image explains what product does
- [ ] Problem is clearly established
- [ ] Solution is demonstrated
- [ ] 2-3 key features highlighted
- [ ] Social proof included
- [ ] CTA or offer visible

### Quality
- [ ] All images high resolution
- [ ] Consistent brand styling
- [ ] No typos or errors
- [ ] Looks good at all sizes
- [ ] Video tested and working

### Flow
- [ ] Tells coherent story
- [ ] Each image has clear purpose
- [ ] Logical progression
- [ ] Ends with strong impression

## Output Format

```
GALLERY PLAN FOR: [Product Name]

TOTAL IMAGES: [Number]
VIDEO INCLUDED: [Yes/No]

IMAGE SEQUENCE:

1. [Type: Hook/Hero]
   Content: [Description]
   Message: [What viewer should understand]

2. [Type: Problem]
   Content: [Description]
   Message: [What viewer should feel]

3. [Type: Solution]
   Content: [Description]
   Message: [The "aha" moment]

4. [Type: Feature]
   Feature: [Name]
   Content: [Description]

5. [Type: Feature]
   Feature: [Name]
   Content: [Description]

6. [Type: Social Proof/CTA]
   Content: [Description]
   Message: [Final impression]

VISUAL STYLE:
- Primary colors: [Colors]
- Typography: [Fonts]
- Screenshot style: [Dark/Light mode]

TOOLS TO USE:
[Recommended design tools]
```

Overview

This skill guides you to plan, design, and optimize Product Hunt gallery images that tell a clear product story and drive conversions. It focuses on sequence, visual templates, and conversion-minded messaging to make each image work alone and as part of a whole. Use it to create a polished, mobile-friendly gallery that highlights features, benefits, and social proof.

How this skill works

The skill inspects your product narrative, feature set, and assets to recommend a 4–6 image sequence and visual templates for each slot (hook, problem, solution, features, social proof/CTA). It provides technical specs, a checklist for quality control, and video integration guidance to ensure images load correctly and tell a coherent story. It also suggests gallery types by product category and quick design do/don't rules.

When to use it

  • Planning the image sequence for a Product Hunt launch
  • Designing hero and feature images to highlight core value
  • Creating before/after or problem→solution comparisons
  • Adding a demo video or GIF to increase engagement
  • Optimizing gallery order and CTAs for conversion

Best practices

  • Start with a strong hook that names the product and core value
  • Use real product screenshots or GIFs, not stock photos
  • Limit text, use readable callouts and consistent branding
  • Include 2–3 standout features with one-line benefits each
  • Add social proof or a clear CTA on the final image
  • Test images and video on mobile before launch

Example use cases

  • SaaS launch: hero + dashboard + workflow GIF + integrations + testimonials
  • Mobile app: device mockup, key screens, feature demos, app-store CTA
  • Developer tool: code example, before/after, performance metrics, docs preview
  • AI product: input→output demo, accuracy metrics, multiple use cases, API options

FAQ

How many images should I include?

Aim for 4–6 images. Minimum is 2, but four gives you space for hook, problem, solution, and social proof.

Can I add video in the gallery?

Yes. Product Hunt accepts YouTube links only. Use a 30–90s demo with a hook in the first 5 seconds and test the embed before launch.

Should I use mockups or real UI?

Prefer real UI screenshots or GIFs. Mockups are OK for device context, but show the real product to build trust.