mcpField
A
ascii-ansi-colorizer

ascii-ansi-colorizer

github.com/full-stack-skillsDesign & UI577 installsUpdated 4w ago
Repository

About ascii-ansi-colorizer

ascii-ansi-colorizer is an explicitly triggered skill for adding ANSI color to existing text while preserving alignment. It provides a plain-text fallback and does not create ASCII art.

Key features

  1. 01Add ANSI color to visible characters
  2. 02Support rainbow, gradient, and brand palettes
  3. 03Set direction, color depth, and scope
  4. 04Provide plain-text fallback and compatibility notes

Use cases

  1. 01Add gradients to an existing ASCII logo
  2. 02Create colored terminal text
  3. 03Keep spacing aligned in colored output

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/full-stack-skills/ascii-skills --skill ascii-ansi-colorizer

After installing, type/ascii-ansi-colorizerin Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

LICENSE.txt
agents/
openai.yaml
examples/
gradient.md
scripts/
colorize.py

Details

From the project README

When to use this skill

CRITICAL TRIGGER RULE

  • Use this skill ONLY when the user explicitly mentions the exact skill name: ascii-ansi-colorizer.

Trigger phrases include:

  • "ascii-ansi-colorizer"
  • "use ascii-ansi-colorizer"
  • "用 ascii-ansi-colorizer 给 ASCII 上色"
  • "使用 ascii-ansi-colorizer 做 ANSI 渐变/彩虹"

Boundary

  • This skill only adds color to existing text. It does not generate the ASCII art itself (pair with ascii-cli-logo-banner if needed).
  • Required outputs: coloredText + plainTextFallback.
  • ANSI must not break alignment: do not colorize spaces by default; colorize visible characters only.

How to use this skill

Inputs
  • textOrAscii (required)
  • palette (rainbow | gradient | brandColors)
  • direction (leftToRight | topToBottom, default leftToRight)
  • colorDepth (ansi16 | ansi256 | truecolor, default ansi256)
  • scope (logoOnly | highlightsOnly | fullText, default logoOnly)
Outputs (required)
  • coloredText: ANSI-colored output
  • plainTextFallback: no-color fallback (identical content, no ANSI)
  • compatNotes: copy/paste and redirection guidance (NO_COLOR / --no-color suggestions)
Steps
  1. Pick colorDepth (default: ansi256).
  2. Choose a stable coloring strategy:
    • Column-wise gradients (leftToRight) are usually the safest
    • Colorize non-space characters only
  3. Output both coloredText and plainTextFallback.
  4. Provide no-color guidance (semantic suggestions): NO_COLOR / --no-color.

Script

  • scripts/colorize.py: apply ANSI 256 gradient or rainbow to stdin

Examples

  • examples/gradient.md

Quality checklist

  1. Removing ANSI keeps the same readable content (plainTextFallback).
  2. Alignment does not change after coloring.
  3. Colors should not overpower the informational lines.

Keywords

English: ascii-ansi-colorizer, ansi, color, gradient, rainbow, terminal, no-color, plain text, ascii 中文: ascii-ansi-colorizer, ANSI, 上色, 渐变, 彩虹, 终端, 无色回退, 纯文本, ASCII

常见陷阱 (Gotchas)

  1. 版本兼容性：注意框架版本与依赖库的兼容性，不同版本 API 可能有差异
  2. 配置文件格式：配置文件格式错误是最常见的问题，建议使用编辑器的语法检查
  3. 环境变量：确保所有必要的环境变量已正确设置，敏感信息不要硬编码
  4. 依赖冲突：多版本共存时注意依赖冲突，使用 lock 文件锁定版本
  5. 性能陷阱：大数据量场景下注意性能优化，避免 N+1 查询等常见问题

使用流程

Step 1: 环境准备

确保开发环境已安装必要的依赖和工具。

Step 2: 配置初始化

根据项目需求进行基础配置。

Step 3: 核心功能使用

按照示例代码实现核心功能。

Step 4: 测试验证

运行测试确保功能正常。

Step 5: 部署上线

完成开发后进行部署和监控。

Comments

Markdown supported