Slack GIF Creator - Flexible Toolkit

A toolkit for creating animated GIFs optimized for Slack. Provides validators for Slack's constraints, composable animation primitives, and optional helper utilities. Apply these tools however needed to achieve the creative vision.

Slack's Requirements

Slack has specific requirements for GIFs based on their use:

Message GIFs:

Max size: ~2MB
Optimal dimensions: 480x480
Typical FPS: 15-20
Color limit: 128-256
Duration: 2-5s

Emoji GIFs:

Max size: 64KB (strict limit)
Optimal dimensions: 128x128
Typical FPS: 10-12
Color limit: 32-48
Duration: 1-2s

Emoji GIFs are challenging - the 64KB limit is strict. Strategies that help:

Limit to 10-15 frames total
Use 32-48 colors maximum
Keep designs simple
Avoid gradients
Validate file size frequently

Toolkit Structure

This skill provides three types of tools:

Validators - Check if a GIF meets Slack's requirements
Animation Primitives - Composable building blocks for motion (shake, bounce, move, kaleidoscope)
Helper Utilities - Optional functions for common needs (text, colors, effects)

Complete creative freedom is available in how these tools are applied.

Core Validators

To ensure a GIF meets Slack's constraints, use these validators:

from core.gif_builder import GIFBuilder
 
# After creating your GIF, check if it meets requirements
builder = GIFBuilder(width=128, height=128, fps=10)
# ... add your frames however you want ...
 
# Save and check size
info = builder.save('emoji.gif', num_colors=48,

File size validator:

from core.validators import check_slack_size
 
# Check if GIF meets size limits
passes, info = check_slack_size('emoji.gif', is_emoji=True)
# Returns: (True/False, dict with size details)

Dimension validator:

from core.validators import validate_dimensions
 
# Check dimensions
passes, info = validate_dimensions(128, 128, is_emoji=True)
# Returns: (True/False, dict with dimension details)

Complete validation:

from core.validators import validate_gif, is_slack_ready
 
# Run all validations
all_pass, results = validate_gif('emoji.gif', is_emoji=True)
 
# Or quick check
if is_slack_ready('emoji.gif', is_emoji=True):
    print("Ready to upload!")

Animation Primitives

These are composable building blocks for motion. Apply these to any object in any combination:

Shake

from templates.shake import create_shake_animation
 
# Shake an emoji
frames = create_shake_animation(
    object_type='emoji',
    object_data={'emoji': '😱', 'size': 80},
    num_frames=20,
    shake_intensity=15,
    direction='both'

Bounce

from templates.bounce import create_bounce_animation
 
# Bounce a circle
frames = create_bounce_animation(
    object_type='circle',
    object_data={'radius': 40, 'color': (255, 100, 100)},
    num_frames=30,
    bounce_height=150

Spin / Rotate

from templates.spin import create_spin_animation, create_loading_spinner
 
# Clockwise spin
frames = create_spin_animation(
    object_type='emoji',
    object_data={'emoji': '🔄', 'size': 100},
    rotation_type='clockwise',
    full_rotations=2
)

Pulse / Heartbeat

from templates.pulse import create_pulse_animation, create_attention_pulse
 
# Smooth pulse
frames = create_pulse_animation(
    object_data={'emoji': '❤️', 'size': 100},
    pulse_type='smooth',
    scale_range=(0.8, 1.2)
)

Fade

from templates.fade import create_fade_animation, create_crossfade
 
# Fade in
frames = create_fade_animation(fade_type='in')
 
# Fade out
frames = create_fade_animation(fade_type='out')
 
# Crossfade between two emojis
frames = create_crossfade(
    object1_data={'emoji': '😊',

Zoom

from templates.zoom import create_zoom_animation, create_explosion_zoom
 
# Zoom in dramatically
frames = create_zoom_animation(
    zoom_type='in',
    scale_range=(0.1, 2.0),
    add_motion_blur=True
)
 
# Zoom out
frames = create_zoom_animation(zoom_type='out')

Explode / Shatter

from templates.explode import create_explode_animation, create_particle_burst
 
# Burst explosion
frames = create_explode_animation(
    explode_type='burst',
    num_pieces=25
)
 
# Shatter effect
frames = create_explode_animation(explode_type='shatter')
 
# Dissolve into particles
frames = create_explode_animation(

Wiggle / Jiggle

from templates.wiggle import create_wiggle_animation, create_excited_wiggle
 
# Jello wobble
frames = create_wiggle_animation(
    wiggle_type='jello',
    intensity=1.0,
    cycles=2
)
 
# Wave motion
frames = create_wiggle_animation(wiggle_type='wave')
 
# Excited wiggle for emoji GIFs

Slide

from templates.slide import create_slide_animation, create_multi_slide
 
# Slide in from left with overshoot
frames = create_slide_animation(
    direction='left',
    slide_type='in',
    overshoot=True
)
 
# Slide across
frames = create_slide_animation(direction='left'

Flip

from templates.flip import create_flip_animation, create_quick_flip
 
# Horizontal flip between two emojis
frames = create_flip_animation(
    object1_data={'emoji': '😊', 'size': 120},
    object2_data={'emoji': '😂', 'size': 120},
    flip_axis=

Morph / Transform

from templates.morph import create_morph_animation, create_reaction_morph
 
# Crossfade morph
frames = create_morph_animation(
    object1_data={'emoji': '😊', 'size': 100},
    object2_data={'emoji': '😂', 'size': 100},
    morph_type=

Move Effect

from templates.move import create_move_animation
 
# Linear movement
frames = create_move_animation(
    object_type='emoji',
    object_data={'emoji': '🚀', 'size':

Kaleidoscope Effect

from templates.kaleidoscope import apply_kaleidoscope, create_kaleidoscope_animation
 
# Apply to a single frame
kaleido_frame = apply_kaleidoscope(frame, segments=8)
 
# Or create animated kaleidoscope
frames = create_kaleidoscope_animation(
    base_frame=my_frame,  # or None for demo pattern
    num_frames=30,
    segments=8

To compose primitives freely, follow these patterns:

# Example: Bounce + shake for impact
for i in range(num_frames):
    frame = create_blank_frame(480, 480, bg_color)
 
    # Bounce motion
    t_bounce = i / (num_frames - 1)
    y = interpolate(start_y, ground_y, t_bounce, 'bounce_out')
 
    # Add shake on impact (when y reaches ground)
    if

Helper Utilities

These are optional helpers for common needs. Use, modify, or replace these with custom implementations as needed.

GIF Builder (Assembly & Optimization)

from core.gif_builder import GIFBuilder
 
# Create builder with your chosen settings
builder = GIFBuilder(width=480, height=480, fps=20)
 
# Add frames (however you created them)
for frame in my_frames:
    builder.add_frame(frame)
 
# Save with optimization
builder.save('output.gif',

Key features:

Automatic color quantization
Duplicate frame removal
Size warnings for Slack limits
Emoji mode (aggressive optimization)

Text Rendering

For small GIFs like emojis, text readability is challenging. A common solution involves adding outlines:

from core.typography import draw_text_with_outline, TYPOGRAPHY_SCALE
 
# Text with outline (helps readability)
draw_text_with_outline(
    frame, "BONK!",
    position=(240, 100),
    font_size=TYPOGRAPHY_SCALE['h1'],  # 60px
    text_color=(255, 68, 68),

To implement custom text rendering, use PIL's ImageDraw.text() which works fine for larger GIFs.

Color Management

Professional-looking GIFs often use cohesive color palettes:

from core.color_palettes import get_palette
 
# Get a pre-made palette
palette = get_palette('vibrant')  # or 'pastel', 'dark', 'neon', 'professional'
 
bg_color = palette['background']
text_color = palette['primary']
accent_color = palette['accent']

To work with colors directly, use RGB tuples - whatever works for the use case.

Visual Effects

Optional effects for impact moments:

from core.visual_effects import ParticleSystem, create_impact_flash, create_shockwave_rings
 
# Particle system
particles = ParticleSystem()
particles.emit_sparkles(x=240, y=200, count=15)
particles.emit_confetti(x=240, y=200, count

Easing Functions

Smooth motion uses easing instead of linear interpolation:

from core.easing import interpolate
 
# Object falling (accelerates)
y = interpolate(start=0, end=400, t=progress, easing='ease_in')
 
# Object landing (decelerates)
y = interpolate(start=0, end=

Available easings: linear, ease_in, ease_out, ease_in_out, bounce_out, elastic_out, back_out (overshoot), and more in core/easing.py.

Frame Composition

Basic drawing utilities if you need them:

from core.frame_composer import (
    create_gradient_background,  # Gradient backgrounds
    draw_emoji_enhanced,         # Emoji with optional shadow
    draw_circle_with_shadow,     # Shapes with depth
    draw_star                    # 5-pointed stars
)
 
# Gradient background
frame = create_gradient_background(480, 480, top_color, bottom_color)
 
# Emoji with shadow
draw_emoji_enhanced(frame, '🎉', position

Optimization Strategies

When your GIF is too large:

For Message GIFs (>2MB):

Reduce frames (lower FPS or shorter duration)
Reduce colors (128 → 64 colors)
Reduce dimensions (480x480 → 320x320)
Enable duplicate frame removal

For Emoji GIFs (>64KB) - be aggressive:

Limit to 10-12 frames total
Use 32-40 colors maximum
Avoid gradients (solid colors compress better)
Simplify design (fewer elements)
Use optimize_for_emoji=True in save method

Example Composition Patterns

Simple Reaction (Pulsing)

builder = GIFBuilder(128, 128, 10)
 
for i in range(12):
    frame = Image.new('RGB', (128, 128), (240, 248, 255))
 
    # Pulsing scale

Action with Impact (Bounce + Flash)

builder = GIFBuilder(480, 480, 20)
 
# Phase 1: Object falls
for i in range(15):
    frame = create_gradient_background(480, 480, (240,

Combining Primitives (Move + Shake)

from templates.shake import create_shake_animation
 
# Create shake animation
shake_frames = create_shake_animation(
    object_type='emoji',
    object_data={'emoji': '😰', 'size': 70},
    num_frames

Philosophy

This toolkit provides building blocks, not rigid recipes. To work with a GIF request:

Understand the creative vision - What should happen? What's the mood?
Design the animation - Break it into phases (anticipation, action, reaction)
Apply primitives as needed - Shake, bounce, move, effects - mix freely
Validate constraints - Check file size, especially for emoji GIFs
Iterate if needed - Reduce frames/colors if over size limits

The goal is creative freedom within Slack's technical constraints.

Dependencies

To use this toolkit, install these dependencies only if they aren't already present:

pip install pillow imageio numpy

slack-gif-creator

CLI Install

Skill Instructions

Run with Cloud Agent