textual-tui-skill

textual-tui-skill

カタログのスタブ — スキル本体：aperepel/textual-tui-skill（textual-tui）

判断ツリー

1. スキル本体はすでにインストールされていますか？ 上流ではこのスキルを textual-tui と呼んでいるため、このポインターと並んでインストールされます（ポインターは置き換えられません）。

   • グローバル：f=~/.agents/skills/textual-tui/SKILL.md; [ -f "$f" ] && ! grep -q "^das:" "$f" && echo "installed" || echo "pointer"
   • プロジェクト：f=.agents/skills/textual-tui/SKILL.md; [ -f "$f" ] && ! grep -q "^das:" "$f" && echo "installed" || echo "pointer"
   • installed → スキルは textual-tui としてインストールされています。これを呼び出して続行してください
   • pointer → 手順 2 に進んでください

2. 適用範囲を判定してからインストールします：

   [ -e ~/.agents/skills/textual-tui-skill ] && echo "global" || echo "project"
   

   グローバル：

   npx skills add aperepel/textual-tui-skill --skill textual-tui -g -y
   

   プロジェクト：

   npx skills add aperepel/textual-tui-skill --skill textual-tui -y
   

   Claude Code： 会話を離れずにコマンドを実行するには、チャットメッセージの先頭に ! を付けて送信します。

注意事項

• 必要要件： このスキルが生成するものを実行するには、textual と textual-dev を含む Python（pip install textual textual-dev）が必要です
• ライセンス： MIT

インストール後の呼び出し

• スキル名：textual-tui
• トリガーフレーズ：「Textual TUI」、「Textual widget」、「Textual app」、「TCSS styling」、「Textual framework」

機能

プロフェッショナルな Python TUI を構築するための、包括的な Textual フレームワークリファレンスです。

領域	内容
ウィジェット	Input、Button、Select、Checkbox、DataTable、Tree、Log、RichLog、Tabs、TabbedContent などの組み込みウィジェット
レイアウト	Vertical、Horizontal、Grid、固定／比率指定のサイズ設定、レスポンシブパターン
スタイリング	TCSS 構文、セマンティックカラーシステム、外部スタイルシート、ボーダー、パディング
リアクティビティ	リアクティブ属性、ウォッチャー、算出プロパティ、DOM のようなウィジェットツリー
非同期処理	長時間実行タスク向けのワーカー、スレッドセーフな UI 更新のための call_from_thread()、キャンセル
ナビゲーション	マルチスクリーンアプリ、モーダルスクリーン、スクリーンスタックの管理
イベント	Mount、Click、Key、キーバインディング、アクションメソッド、メッセージ伝播
テスト	Pilot API、pytest を使った非同期テストパターン、UI インタラクションのシミュレーション
落とし穴	イベントループのブロック、スレッドセーフティ、ワーカーの選択など、よくある間違いを解説

references/（ウィジェット、レイアウト、スタイリング、公式ガイドのインデックス）と、assets/ 配下に完全なサンプルアプリを 4 つ同梱しています。サンプルは、ToDo アプリ、システムダッシュボード、データビューアー、ワーカーデモです。

使用しない場合

• 複数フレームワークの TUI 概要（Go／Rust／Python／TS）— tui-design-skill を使用してください
• Bubble Tea（Go）— tui-design-skill を使用してください
• Ratatui（Rust）— tui-design-skill を使用してください
• Ink（TypeScript／React）— tui-design-skill を使用してください