---
name: neon-3d-symbol-gif
description: Generate smooth procedural 3D neon symbol GIFs, especially floating rotating pentagrams, glowing occult symbols, dark square profile loops, Discord icons, animated sigils, and high-frame-count black-background rotation GIFs. Use when the user asks for a 3D rotating/floating pentagram, smooth neon symbol GIF, glowing sigil animation, or similar procedural symbol loop.
---


# Neon 3D Symbol GIF

## Purpose

Use the bundled renderer to generate smooth floating 3D neon symbol GIFs. The default preset recreates the red glowing pentagram rotation style: black background, soft particle field, floating shadow, anti-aliased 3D rotation, neon glow, no text, and no scanlines.

## Quick Commands

Set paths:

```bash
SKILL_DIR="$HOME/.codex/skills/neon-3d-symbol-gif"
PY="/Users/tec/.cache/codex-runtimes/codex-primary-runtime/dependencies/python/bin/python3"
[ -x "$PY" ] || PY="python3"
```

Generate the default smooth floating pentagram:

```bash
"$PY" "$SKILL_DIR/scripts/generate_neon_3d_symbol_gif.py" \
  --symbol pentagram \
  --out "$PWD/floating-3d-pentagram-rotation.gif" \
  --preview-sheet "$PWD/floating-3d-pentagram-rotation-contact.png"
```

Generate a faster/lighter draft:

```bash
"$PY" "$SKILL_DIR/scripts/generate_neon_3d_symbol_gif.py" \
  --frames 48 \
  --size 512 \
  --out "$PWD/pentagram-draft.gif"
```

## Workflow

1. Use the default settings for polished output: `720x720`, `120` frames, `24ms` frame duration.
2. Use `--size` for square dimensions; `720` is a good balance of quality and file size.
3. Use `--frames` to control smoothness. Keep `96-144` for super smooth loops.
4. Use `--duration` to control speed. `24ms` is fast and fluid; `32-45ms` is slower and heavier.
5. Use `--color red|white|cyan|violet|green|gold` or `--hex "#ff3340"` for glow color.
6. Generate a `--preview-sheet` when visual QA is useful.

## Implementation Notes

- Script: `scripts/generate_neon_3d_symbol_gif.py`
- Current symbol preset: `pentagram`
- Default size: `720`
- Default frame count: `120`
- Default duration: `24` ms per frame
- Default output: `floating-3d-pentagram-rotation.gif`

The script requires Pillow. Prefer the bundled Codex primary runtime Python when available because it includes a working ARM64 Pillow build on this machine.

Keep outputs practical: high-frame neon GIFs can get large quickly. If a file is too heavy, lower `--size`, `--frames`, or `--particles`.

## Style Guide

- Keep the composition clean: centered floating object, black field, soft glow, no labels.
- Avoid scanlines, borders, titles, or stamps unless the user asks.
- Use red for the signature occult neon look; use white/cyan/violet when the user wants cleaner cyber or icon vibes.
- For profile/icon loops, prefer square outputs: `512`, `720`, or `1024`.