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
Routing Decision
| Need | Skill to use | Why |
|---|---|---|
| Simple built-in font, no npm/node deps | ascii-cli-logo-banner-python | Uses a built-in 5x5 font, Python only |
| TAAG/FIGlet fonts, layout smushing | ascii-cli-logo-banner-figletjs | Full FIGfont spec via figlet.js |
Example: For a quick startup banner with brandName="MyApp" and no external font engine needed, route to ascii-cli-logo-banner-python. For a FIGlet "Standard" or "Big" font banner with horizontal smushing, route to ascii-cli-logo-banner-figletjs.
Script (optional)
- Use
ascii-cli-logo-banner-pythonfor the Python implementation. - Use
ascii-cli-logo-banner-figletjsfor 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 上色, 无色回退