ascii-progress-and-spinner | partme-ai-full-stack-skills | ClaudePluginHub

Skill

ascii-progress-and-spinner

From partme-ai-full-stack-skills

Designs ASCII progress bars and spinners for CLI UX with determinate/indeterminate modes, TTY single-line refreshes, non-interactive log fallbacks, and copy-pastable style specs for terminal progress indicators and loading animations.

Install

$

npx claudepluginhub partme-ai/full-stack-skills --plugin t2ui-skills

Tool Access

This skill uses the workspace's default tool permissions.

Preview

**CRITICAL TRIGGER RULE**

Supporting Assets

LICENSE.txtexamples/styles.mdscripts/demo.py

SKILL.md

Similar Skills

using-git-worktrees

Creates isolated Git worktrees for feature branches with prioritized directory selection, gitignore safety checks, auto project setup for Node/Python/Rust/Go, and baseline verification.

168.3k

subagent-driven-development

3 files

Executes implementation plans in current session by dispatching fresh subagents per independent task, with two-stage reviews: spec compliance then code quality.

168.3k

dispatching-parallel-agents

Dispatches parallel agents to independently tackle 2+ tasks like separate test failures or subsystems without shared state or dependencies.

168.3k

Stats

Stars328

Forks62

Last CommitMar 25, 2026

Actions

View Source View Plugin View on GitHub View README

Tags

loading-animation

When to use this skill

CRITICAL TRIGGER RULE

Use this skill ONLY when the user explicitly mentions the exact skill name: ascii-progress-and-spinner.

Trigger phrases include:

"ascii-progress-and-spinner"
"use ascii-progress-and-spinner"
"用 ascii-progress-and-spinner 生成 ASCII 进度条"
"使用 ascii-progress-and-spinner 做 spinner / loading"

Boundary

Do not integrate a specific UI framework; output styles + refresh rules + fallback protocol + examples.
Must cover:
- determinate progress bars
- indeterminate spinners
- non-TTY / redirected-output fallback (log lines, no carriage-return updates)

How to use this skill

Inputs

mode (determinate | indeterminate)
width (default 40)
showPercent (default true)
showEta (optional)
multiTask (optional)
colorMode (none | ansi256, default none)

Outputs (required)

progressBarStyles (>= 3)
spinnerStyles (>= 2)
renderRules (TTY single-line refresh vs logLines)
fallbackRules (non-interactive / redirected output)

Recommended render rules

TTY (interactive): single-line refresh (overwrite previous line), avoid log spam
Non-TTY (logs): print log lines (no overwrite). Each line may include task name + percent.

Inline Style Examples

Progress bar styles:

Style 1 (block):   [████████░░░░░░░░░░░░]  42%  ETA 3s
Style 2 (hash):    [########............]  42%  ETA 3s
Style 3 (arrow):   [========>-----------]  42%  ETA 3s

Spinner styles:

Style 1 (braille): ⠋ Loading...  →  ⠙ Loading...  →  ⠹ Loading...
Style 2 (pipe):    | Loading...  →  / Loading...  →  - Loading...

Non-TTY log fallback:

[task-1] 25% complete
[task-1] 50% complete
[task-1] 75% complete
[task-1] 100% complete - done (4.2s)

Workflow

Determine mode: determinate (known total) or indeterminate (spinner)
Select styles from the style gallery (>= 3 progress, >= 2 spinner)
Define render rules: TTY uses single-line refresh, non-TTY uses log lines
Define fallback rules for redirected output (no carriage returns)
Validate: Fixed-width percent field, no jitter, grep-friendly log mode

Script

scripts/demo.py: local demo for progress bar + spinner shapes

Examples

examples/styles.md

Quality checklist

Fixed width (percent field is fixed-width to avoid jitter)
Log mode is grep-friendly (no overwrite)
ASCII-only defaults are available (avoid ambiguous-width Unicode)

Keywords

English: ascii-progress-and-spinner, progress bar, spinner, loading, tty, non-interactive, log output, ascii 中文: ascii-progress-and-spinner, 进度条, Spinner, Loading, 终端, TTY, 日志降级, ASCII