playbooks

home / skills / partme-ai / full-stack-skills / ascii-terminal-animation-pack

ascii-terminal-animation-pack skill

/skills/ascii-terminal-animation-pack

This skill helps you plan and generate terminal ASCII animations with a static poster frame and configurable FPS, duration, and loop policy.

npx playbooks add skill partme-ai/full-stack-skills --skill ascii-terminal-animation-pack

Review the files below or copy the command above to add this skill to your agents.

Files (5)
SKILL.md
2.0 KB
---
name: ascii-terminal-animation-pack
description: Plan and generate terminal ASCII animations/screensaver-style output (FPS, refresh rules, loop policy, low-flicker guidance), with a static poster frame and an optional local demo script.
license: Complete terms in LICENSE.txt
dependencies:
  - python>=3.8
---


## 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"
- "用 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.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
**中文:** ascii-terminal-animation-pack, 终端动画, ASCII 动效, 矩阵雨, 演示, 帧率, 非交互禁用

Overview

This skill plans and generates terminal ASCII animations and screensaver-style output with clear refresh rules, FPS control, loop policy, and low-flicker guidance. It always produces a copy/paste-safe ASCII-only static poster frame and can include a short local demo script for TTY environments. The design prioritizes non-spam defaults and safe disable conditions for non-interactive output.

How this skill works

Given inputs like theme, width, height, fps, durationSeconds, loop, and colorMode, the skill emits an animationSpec describing refresh rules, FPS limits, loop policy, and when to disable animation. It also produces a staticPosterFrame (ASCII-only) suitable for README or issue tickets. Optionally, the package includes a short scripts/matrix_demo.py that runs a best-effort matrix rain demo only in interactive TTYs.

When to use it

  • When you explicitly request ascii-terminal-animation-pack by name.
  • When you need a terminal-friendly ASCII demo with controlled FPS and duration.
  • When you need a static ASCII poster frame for docs or tickets.
  • When building a TTY-only demo script for visual verification.
  • When you need guidance to avoid mixing animations with normal logs.

Best practices

  • Keep default duration short (e.g., 3 seconds) and fps moderate (e.g., 10) to avoid spam.
  • Disable animations automatically for non-interactive or redirected output (check isatty).
  • Provide a copy/paste-safe staticPosterFrame for all uses where animation is not allowed.
  • Run demos in a dedicated command or subprocess to avoid interleaving with application logs.
  • Prefer low-flicker refresh patterns (partial-line updates, stable background) and document exit keys (Ctrl-C).

Example use cases

  • Generate a 3-second matrix rain demo for a README with width=80, height=24, fps=10 and an ASCII static poster frame.
  • Produce a waves-themed animationSpec for a TTY-only local demo script and include disable guidance for CI runs.
  • Embed the staticPosterFrame in issue templates to show expected output without running animation.
  • Provide a short scripts/matrix_demo.py for developers to run locally to verify terminal behavior.
  • Create an examples/spec.md that documents refresh rules, loop policy, and disable conditions for integration teams.

FAQ

Can animations run when output is redirected to a file or CI logs?

No. The animationSpec requires disabling animations for non-interactive output. Check isatty and fallback to staticPosterFrame for redirected or CI environments.

Does the skill include color?

Color is optional via colorMode (none or ansi256). Default is ansi256, but the staticPosterFrame must remain ASCII-only and color-free.