| name | ascii-cli-logo-banner |
| description | Entry point for ASCII CLI banners. Choose the Python built-in font skill or the figlet.js/FIGfont skill depending on needs. |
| license | Complete terms in LICENSE.txt |
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.
Use this skill when the user says they want:
- A startup banner / logo / welcome screen for a CLI or service
Trigger phrases include:
- "ascii-cli-logo-banner"
- "use ascii-cli-logo-banner"
- "用 ascii-cli-logo-banner"
- "使用 ascii-cli-logo-banner 生成启动 Banner"
- "用 ascii-cli-logo-banner 做一个 ASCII Logo"
Boundary
- This skill is a routing/selection entry point. It does not provide its own generator implementation.
- For built-in (no external font engine): use
ascii-cli-logo-banner-python.
- For TAAG/FIGlet style (FIGfont spec, smushing layouts): use
ascii-cli-logo-banner-figletjs.
How to use this skill
Inputs (recommended)
- brandName (required)
- version (optional)
- author (optional)
- repoUrl / docsUrl (optional)
- width (default 80)
- 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 logo-only hero output)
- style (block | outline | thin, default block)
- colorMode (none | ansi256, default none; logo only in scripts)
- includeCta (default true)
Outputs (required)
- bannerPlain: ASCII-only full banner (logo area + info block + horizontal rule)
- compactPlain: compact banner for
width < 60 (single-line title + rule + 1-2 info lines)
- plainTextFallback: no-color fallback when ANSI is enabled (same structure as bannerPlain)
- embedNotes: 3-5 embedding notes (CLI start / service start / README / tickets)
Steps
- Decide width and fallback:
- Default
width=80
- If
width < 60, output compactPlain and skip the big-letter logo
- Generate an ASCII-only logo:
- Avoid full-width characters and ambiguous-width Unicode
- Ensure each line is
<= width
- Compose the banner structure (recommended order):
- Logo area (or a single-line title in compact mode)
- Horizontal rule: exactly
width characters (- or =)
- Info block: Name / Version / Repo / Docs / Author (only include fields provided)
- Optional CTA: e.g.
Run: <command> or Docs: <url>
- Optional ANSI coloring (must not break alignment):
- Colorize visible characters only; do not colorize spaces
- Always provide
plainTextFallback
Script (optional)
- Use
ascii-cli-logo-banner-python for the Python implementation.
- Use
ascii-cli-logo-banner-figletjs for the figlet.js/FIGfont implementation.
Examples
- See examples in the two implementation skills:
ascii-cli-logo-banner-python/examples/*ascii-cli-logo-banner-figletjs/examples/*
Quality checklist
- Does not wrap or misalign at 80 columns; no trailing spaces
- Copy-pastes cleanly into logs/email/tickets
- Never prints secrets (tokens, internal URLs, personal data)
Keywords
English: ascii, banner, logo, cli, terminal, startup, welcome, plain text, ansi, no-color
中文: ASCII, 启动横幅, 终端 Banner, CLI Logo, 欢迎页, 纯文本, ANSI 上色, 无色回退
