ascii-terminal-animation-pack

When to use this skill

CRITICAL TRIGGER RULE

• Use this skill ONLY when the user explicitly mentions the exact skill name: ascii-terminal-animation-pack.

Trigger phrases include:

• "ascii-terminal-animation-pack"
• "use ascii-terminal-animation-pack"
• "Making terminal animations with ascii-terminal-animation-pack"
• "Using ascii-terminal-animation-pack to generate a matrix rain demo"

Boundary

• Animations must be explicitly triggered demos. Never default to animated output in normal logs.
• Must provide an ASCII-only static poster frame for README/tickets.
• Must provide disable guidance: skip animations for non-interactive / redirected output.

How to use this skill

Inputs

• theme (matrix | waves | custom, default matrix)
• width (default 80)
• height (default 24)
• fps (default 10)
• durationSeconds (default 3)
• loop (default false)
• colorMode (none | ansi256, default ansi256)

Outputs (required)

• animationSpec (refresh rules, FPS, loop policy, disable conditions)
• staticPosterFrame (ASCII-only)
• safetyNotes (exit/disable guidance, avoid log spam)

Workflow

1. Check TTY: Detect if output is a terminal (sys.stdout.isatty()) — skip animation for non-interactive
2. Generate spec: Define theme, FPS, duration, loop policy, and exit conditions
3. Render frames: Output frames with ANSI cursor control; clear screen between frames
4. Validate output: Confirm clean exit (cursor restored), no log contamination, short default duration

Script

• scripts/matrix_demo.py: best-effort matrix rain demo (short-run, TTY-only)

Examples

• examples/spec.md
• examples/poster.md

Quality checklist

1. Non-spam by default: short duration, easy exit, disabled for non-interactive output
2. Static frame is ASCII-only and copy/paste safe
3. Animated output should not mix with normal application logs (recommend separate command or stream)

Keywords

English: ascii-terminal-animation-pack, terminal animation, ascii animation, matrix rain, demo, fps, non-interactive Chinese: ascii-terminal-animation-pack, terminal animation, ASCII motion effects, matrix rain, demo, frame rate, non-interactive disabled