ascii-mini-charts について
数値系列からスパークライン、棒グラフ、折れ線グラフを生成するスキルです。可視化専用で、スキル名が明示された場合にのみ使用します。
主な機能
- 01スパークライン、棒、折れ線を生成
- 02線形または対数の正規化に対応
- 03簡易版と注釈付きチャートを出力
- 04スケール説明と圧縮方法を提示
活用シーン
- 01短い数値系列をスパークラインで表示
- 02コンパクトな棒グラフで値を比較
- 03ASCII の折れ線で傾向を表示
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ full-stack-skills/ ascii-skills --skill ascii-mini-chartsインストール後、Claude Code で/ascii-mini-chartsを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
LICENSE.txtagents/openai.yamlexamples/sparkline.mdscripts/mini_charts.py詳細
このスキルを使用するタイミング
重要なトリガールール
- ユーザーがスキル名
ascii-mini-chartsを明示的に指定した場合にのみ、このスキルを使用してください。
トリガーフレーズの例:
- "ascii-mini-charts"
- "use ascii-mini-charts"
- "ascii-mini-charts を使って sparkline / スパークラインを生成"
- "ascii-mini-charts を使って min/max/current を注記"
適用範囲
- 統計的な推論は行いません。可視化のみ行います。
- デフォルトの出力は ASCII のみです。Unicode ブロックも使用できますが、ASCII のみの代替出力を必ず含めてください。
- デフォルトの出力幅は 60 桁以下にしてください。系列が長い場合は、圧縮方法(サンプリング/ビン分け)を提示してください。
このスキルの使用方法
入力
- series(必須の数値リスト)
- type(sparkline | bar | line、デフォルトは sparkline)
- width(デフォルトは min(len(series), 30))
- height(デフォルトは bar/line の場合 10)
- normalize(linear | log、デフォルトは linear)
- showLabels(デフォルトは true)
出力(必須)
- chartMinimal
- chartAnnotated(min/max/current を含む)
- scaleNotes(正規化+外れ値への対処方針)
スクリプト
scripts/mini_charts.py:JSON 標準入力から ASCII ミニチャートを生成します
例
examples/sparkline.md
品質チェックリスト
- 傾向が明確で、ラベルが短く、過剰に目立ちません
- ASCII のみの出力をきれいにコピー&ペーストできます
- 長い系列には圧縮方法を提示します
キーワード
英語: ascii-mini-charts, sparkline, ascii chart, bar chart, line chart, trend, normalize 日本語: ascii-mini-charts, スパークライン, ASCII チャート, 棒グラフ, 折れ線グラフ, 傾向, 正規化
よくある落とし穴(Gotchas)
- バージョンの互換性:フレームワークのバージョンと依存ライブラリの互換性に注意してください。バージョンによって API が異なる場合があります
- 設定ファイルの形式:設定ファイルの形式エラーは最もよくある問題です。エディターの構文チェックを利用することをおすすめします
- 環境変数:必要な環境変数がすべて正しく設定されていることを確認してください。機密情報をハードコードしないでください
- 依存関係の競合:複数のバージョンを共存させる場合は、依存関係の競合に注意し、lock ファイルでバージョンを固定してください
- パフォーマンス上の落とし穴:大量のデータを扱う場合はパフォーマンスの最適化に注意し、N+1 クエリなどのよくある問題を避けてください
使用手順
ステップ 1:環境の準備
開発環境に必要な依存関係とツールがインストールされていることを確認してください。
ステップ 2:初期設定
プロジェクトの要件に応じて基本設定を行います。
ステップ 3:コア機能の使用
サンプルコードに従ってコア機能を実装します。
ステップ 4:テストと検証
テストを実行し、機能が正常に動作することを確認します。
ステップ 5:デプロイ
開発完了後、デプロイと監視を行います。
コメント
Markdown 対応