ascii-cli-logo-banner について
CLI やサービスの起動バナーを作る際、名前を明示して呼び出すルーティングスキルです。バナー自体は生成せず、フォントの要件に応じて Python または FIGlet.js の実装スキルへ案内します。
主な機能
- 01Python または FIGlet.js のスキルへ振り分け
- 02バナーの入力項目と出力形式の定義
- 0360 列未満のコンパクト表示
- 04ASCII と ANSI のフォールバック規則
活用シーン
- 01CLI 起動バナーの実装方式選び
- 02サービス起動バナーの要件整理
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ partme-ai/ full-stack-skills --skill ascii-cli-logo-bannerインストール後、Claude Code で/ascii-cli-logo-bannerを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
LICENSE.txtexamples/banner-80.mdbanner-compact.md詳細
このスキルを使用するタイミング
重要なトリガールール
- ユーザーがスキル名
ascii-cli-logo-bannerを正確に明示した場合にのみ、このスキルを使用してください。
ユーザーが次のものを希望している場合に使用します:
- CLI またはサービスの起動バナー/ロゴ/ウェルカム画面
トリガーとなる語句の例:
- "ascii-cli-logo-banner"
- "use ascii-cli-logo-banner"
- "用 ascii-cli-logo-banner"
- "使用 ascii-cli-logo-banner 生成启动 Banner"
- "用 ascii-cli-logo-banner 做一个 ASCII Logo"
対象範囲
- このスキルはルーティング/選択のためのエントリーポイントです。独自の生成実装は提供しません。
- 組み込みフォントを使う場合(外部フォントエンジンなし):
ascii-cli-logo-banner-pythonを使用します。 - TAAG/FIGlet スタイル(FIGfont 仕様、スムージングレイアウト)を使う場合:
ascii-cli-logo-banner-figletjsを使用します。
このスキルの使用方法
入力(推奨)
- brandName(必須)
- version(任意)
- author(任意)
- repoUrl / docsUrl(任意)
- width(デフォルトは 80)
- slogan(任意。ロゴの下に中央揃えで表示する行)
- hint(任意。スローガンの下に中央揃えで表示する行)
- glyph(ascii | block、デフォルトは ascii)
- center(デフォルトは true)
- rule(デフォルトは true。ロゴだけのヒーロー出力にする場合は false に設定)
- style(block | outline | thin、デフォルトは block)
- colorMode(none | ansi256、デフォルトは none。スクリプト内ではロゴのみ)
- includeCta(デフォルトは true)
出力(必須)
- bannerPlain:ASCII のみで構成された完全なバナー(ロゴ領域+情報ブロック+水平線)
- compactPlain:
width < 60の場合に使うコンパクトなバナー(1 行のタイトル+水平線+1~2 行の情報) - plainTextFallback:ANSI が有効な場合の無色のフォールバック(bannerPlain と同じ構成)
- embedNotes:埋め込みに関するメモを 3~5 件(CLI 起動/サービス起動/README/チケット)
手順
- 幅とフォールバックを決定します:
- デフォルトの
width=80 width < 60の場合はcompactPlainを出力し、大きな文字のロゴは省略します
- デフォルトの
- ASCII のみで構成されたロゴを生成します:
- 全角文字や幅が曖昧な Unicode 文字は避けます
- 各行が
<= widthになるようにします
- バナーの構成を決めます(推奨順序):
- ロゴ領域(コンパクトモードでは 1 行のタイトル)
- 水平線:ちょうど
width文字(-または=) - 情報ブロック:Name / Version / Repo / Docs / Author(値が指定された項目のみ含める)
- 任意の CTA:例:
Run: <command>またはDocs: <url>
- ANSI による任意の色付け(配置を崩さないこと):
- 表示される文字だけに色を付け、空白には色を付けません
- 必ず
plainTextFallbackを用意します
ルーティングの判断
| 必要なもの | 使用するスキル | 理由 |
|---|---|---|
| シンプルな組み込みフォント、npm/node の依存関係なし | ascii-cli-logo-banner-python | 組み込みの 5x5 フォントを使用し、Python のみで動作 |
| TAAG/FIGlet フォント、レイアウトのスムージング | ascii-cli-logo-banner-figletjs | figlet.js による完全な FIGfont 仕様 |
例:brandName="MyApp" の手軽な起動バナーを作成し、外部フォントエンジンが不要な場合は、ascii-cli-logo-banner-python にルーティングします。水平スムージングを使った FIGlet の「Standard」または「Big」フォントのバナーを作成する場合は、ascii-cli-logo-banner-figletjs にルーティングします。
スクリプト(任意)
- Python 実装には
ascii-cli-logo-banner-pythonを使用します。 - figlet.js/FIGfont 実装には
ascii-cli-logo-banner-figletjsを使用します。
例
- 2 つの実装スキルの例を参照してください:
ascii-cli-logo-banner-python/examples/*ascii-cli-logo-banner-figletjs/examples/*
品質チェックリスト
- 80 列で折り返されたり配置がずれたりせず、末尾に空白がない
- ログ/メール/チケットにコピー&ペーストしても問題がない
- シークレット(トークン、内部 URL、個人データ)を決して出力しない
キーワード
英語: ascii, banner, logo, cli, terminal, startup, welcome, plain text, ansi, no-color 中国語: ASCII、起動バナー、ターミナルバナー、CLI ロゴ、ウェルカム画面、プレーンテキスト、ANSI による色付け、無色フォールバック
コメント
Markdown 対応