ascii-terminal-animation-pack
npx machina-cli add skill partme-ai/full-stack-skills/ascii-terminal-animation-pack --openclawWhen 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"
- "用 ascii-terminal-animation-pack 做终端动画"
- "使用 ascii-terminal-animation-pack 生成矩阵雨 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)
Script
scripts/matrix_demo.py: best-effort matrix rain demo (short-run, TTY-only)
Examples
examples/spec.mdexamples/poster.md
Quality checklist
- Non-spam by default: short duration, easy exit, disabled for non-interactive output
- Static frame is ASCII-only and copy/paste safe
- 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 中文: ascii-terminal-animation-pack, 终端动画, ASCII 动效, 矩阵雨, 演示, 帧率, 非交互禁用
Source
git clone https://github.com/partme-ai/full-stack-skills/blob/main/skills/ascii-terminal-animation-pack/SKILL.mdView on GitHub Overview
ascii-terminal-animation-pack helps you plan and generate terminal ASCII animations or screensaver-style output, including FPS rules, refresh behavior, and loop policy. It provides a static ASCII poster frame for READMEs or tickets, plus an optional local demo script to showcase a short run.
How This Skill Works
You supply inputs like theme (matrix | waves | custom), width, height, fps, durationSeconds, loop, and colorMode. The tool then outputs an animationSpec (refresh rules, FPS, loop policy, disable conditions), a staticPosterFrame (ASCII-only), and safetyNotes to guide exit paths and avoid log spam. When you need a quick demo, you can use the best-effort matrix rain demo script at scripts/matrix_demo.py.
When to Use It
- When you want to showcase an ASCII animation (matrix rain or waves) in README/docs with controlled FPS and loop behavior
- When preparing a non-interactive, terminal-based demo that should not flood logs or interfere with normal output
- When you need a static ASCII poster frame for tickets, READMEs, or marketing material
- When you require explicit disable guidance for non-TTY or redirected outputs
- When you want an optional local demo script (scripts/matrix_demo.py) to demonstrate a short run
Quick Start
- Step 1: Set inputs (theme, width, height, fps, durationSeconds, loop, colorMode)
- Step 2: Generate outputs: animationSpec, staticPosterFrame, safetyNotes
- Step 3: (Optional) Run scripts/matrix_demo.py for a best-effort demo
Best Practices
- Keep durationSeconds short and the overall run non-intrusive to avoid log spam
- Ensure the staticPosterFrame is ASCII-only and safe for copy/paste into docs
- Do not mix animated output with normal application logs; use a separate command/stream when testing
- Explicitly set colorMode and theme to match your terminal capabilities
- Test in a real TTY to verify FPS, flicker guidance, and disable conditions
Example Use Cases
- README showcasing a matrix rain poster alongside a live demo script reference
- Documentation page with an ASCII poster frame and a link to the matrix_demo.py script
- Ticket or proposal illustrating the ASCII animation approach with clear disable guidance
- CI/docs example demonstrating a short, non-interactive terminal animation
- Blog post illustrating how to configure FPS, duration, and loop policy for a screensaver-like output
