---
name: ascii-glitch-workflow
description: Chain detailed ASCII art, ASCII glitch GIF generation, and optional macOS animated wallpaper setup into one polished workflow. Use when the user wants a complete terminal-art-to-GIF pipeline, a DemonHub-style ASCII banner, an animated ASCII wallpaper, or a guided combo using detailed-ascii-art, ascii-glitch-gif, and macos-gif-wallpaper.
---


# ASCII Glitch Workflow

## Purpose

Use this as the end-to-end workflow for turning a subject into a finished animated ASCII artifact. It coordinates three skills:

- `detailed-ascii-art` for dense monospaced character art.
- `ascii-glitch-gif` for black cyber-glitch GIF animation.
- `macos-gif-wallpaper` when the user wants the GIF installed as a live desktop wallpaper.

## Default Flow

1. Create or refine the ASCII composition with `detailed-ascii-art`.
2. Save the exact monospaced text to a `.txt` file, preserving all leading spaces and line breaks.
3. Run `ascii-glitch-gif` with `--preset literal-ascii --ascii-file`.
4. Generate a preview sheet and inspect it before delivery.
5. If the user asks for a wallpaper, hand the final GIF to `macos-gif-wallpaper`.

## Quick Commands

```bash
ASCII_SKILL="$HOME/.codex/skills/ascii-glitch-gif"
PY="/Users/tec/.cache/codex-runtimes/codex-primary-runtime/dependencies/python/bin/python3"
[ -x "$PY" ] || PY="python3"

"$PY" "$ASCII_SKILL/scripts/generate_ascii_glitch_gif.py" \
  --preset literal-ascii \
  --ascii-file "$PWD/art.txt" \
  --spin \
  --out "$PWD/ascii-glitch.gif" \
  --preview-sheet "$PWD/ascii-glitch-contact.png"
```

Set the generated GIF as a macOS animated wallpaper:

```bash
bash "$HOME/.codex/skills/macos-gif-wallpaper/scripts/install_gif_wallpaper.sh" \
  --gif "$PWD/ascii-glitch.gif" \
  --fit cover \
  --install \
  --system-wallpaper \
  --launch
```

## Style Defaults

- Black background.
- White or blue-white monospaced character art.
- No border, title, stamp, scanlines, or bright glitch bars unless requested.
- Use `--spin` when the user asks for rotating, orbiting, turning, or spinning.
- Use wallpaper dimensions only when needed; for most shareable loops, start at banner or square sizes.

## Output Checklist

- The ASCII source is readable in a monospaced font.
- The GIF loops cleanly and does not crop the subject.
- The preview sheet confirms the animation has real motion.
- For wallpaper installs, the wallpaper app status shows installed and running.