ascii-cli-logo-banner-python
npx machina-cli add skill partme-ai/full-stack-skills/ascii-cli-logo-banner-python --openclawFiles (1)
SKILL.md
2.4 KB
When to use this skill
CRITICAL TRIGGER RULE
- Use this skill ONLY when the user explicitly mentions the exact skill name:
ascii-cli-logo-banner-python.
Trigger phrases include:
- "ascii-cli-logo-banner-python"
- "use ascii-cli-logo-banner-python"
- "用 ascii-cli-logo-banner-python 生成启动 Banner"
- "使用 ascii-cli-logo-banner-python 输出 ASCII Logo + slogan（居中）"
Boundary
- Output copy-pastable text and layout rules only. Do not modify project code.
- Default output is width-safe and copy/paste safe (no trailing spaces).
- ANSI coloring is optional and MUST be applied to visible characters only (spaces are not colorized).
- This skill uses a built-in 5x5 font. It is not a full FIGlet engine.
How to use this skill
Inputs (recommended)
- brand (required)
- width (default 80; if
< 60use compact mode) - slogan (optional; centered line under the logo)
- hint (optional; centered line under the slogan)
- glyph (ascii | block, default ascii)
- center (default true)
- rule (default true; set false for hero output)
- version/repo/docs/author (optional; only used when
rule=true) - colorMode (none | ansi256, default none; logo only)
- colorStart/colorEnd (0-255, defaults 33/129; only when
colorMode=ansi256)
Outputs (required)
- bannerPlain: banner text (ASCII-only when colorMode=none)
- compactPlain: compact banner when width < 60
- plainTextFallback: if colorMode is enabled, also provide a no-color fallback (same layout)
Script
scripts/generate_banner.py
Examples
examples/banner-80.mdexamples/banner-compact.mdexamples/banner-slogan-centered.mdexamples/color-ansi256.md
Quality checklist
- 80-column output does not wrap; no trailing spaces
- Width < 60 uses compact mode
- Color mode does not break alignment (spaces are not colorized)
- Never prints secrets (tokens, internal URLs, personal data)
Keywords
English: ascii-cli-logo-banner-python, ascii, banner, logo, cli, terminal, startup, slogan, ansi256 中文: ascii-cli-logo-banner-python, ASCII 启动横幅, 终端 Banner, 居中标语, ANSI256 上色
Source
git clone https://github.com/partme-ai/full-stack-skills/blob/main/skills/ascii-cli-logo-banner-python/SKILL.mdView on GitHub Overview
ascii-cli-logo-banner-python creates copy-pasteable ASCII banners using a built-in 5x5 font, so you don't need external font files. It supports a width-aware layout with a compact mode for small terminals and optional ANSI 256 coloring for the logo, while preserving alignment and readability.
How This Skill Works
It uses a built-in 5x5 font to render glyphs, then assembles the banner according to the requested width, centering and optional slogan. When colorMode is set to ansi256, visible logo characters are colorized between colorStart and colorEnd (spaces remain uncolored), and the script outputs bannerPlain along with compactPlain and plainTextFallback when color is enabled.
When to Use It
- You want a copy-pasteable ASCII logo banner for a CLI app using the exact built-in 5x5 font.
- Terminal width is wide (default 80) and you want the full logo with an optional centered slogan.
- Terminal width is narrow (<60) and you need the compact banner layout.
- You want ANSI256 color applied only to the logo glyphs without breaking alignment.
- You want to avoid external font dependencies and rely on the built-in font and simple glyph options.
Quick Start
- Step 1: Define inputs (brand, width, slogan optional, colorMode, glyph).
- Step 2: Run scripts/generate_banner.py to produce bannerPlain (and compactPlain as needed).
- Step 3: Paste the resulting banner into your project or README, ensuring width safety.
Best Practices
- Test banners at 80 columns and in compact mode to confirm layout under different widths.
- Keep slogans concise and center them beneath the logo for readability.
- Use colorMode=ansi256 only for visible characters to preserve alignment.
- Provide a plain ASCII version (colorMode=none) for environments without color support.
- Try both glyph=ascii and glyph=block to match your brand style.
Example Use Cases
- AcmeCLI startup banner with slogan 'Fast, Reliable, Secure' in ASCII font.
- Compact banner for a 58-column terminal to avoid wrapping.
- ANSI256 colored logo demo with colorStart=34 and colorEnd=129 and a centered slogan.
- Block glyph variant for a bold, modern banner suitable for presentations.
- README sample banner using plain ASCII without color.
Frequently Asked Questions
Add this skill to your agents
