engram-dashboard-htmx について
engram-dashboard-htmx は、サーバー描画のダッシュボードを htmx で拡張する開発スキルです。部分読み込み、フィルター、フォーム、ナビゲーションの規則を定め、状態をサーバー側で扱います。
主な機能
- 01サーバー描画 HTML を基盤にする設計
- 02シンプルな htmx リクエストパターン
- 03状態を維持するフィルター
- 04変更処理に標準 HTTP POST を使用
- 05単独でも意味のある部分レスポンス
- 06共有可能で意味のある URL
活用シーン
- 01部分読み込みやフィルター操作の追加
- 02ダッシュボードのフォームやトグルの接続
- 03ブラウザー検索操作の変更
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ gentleman-programming/ engram --skill engram-dashboard-htmxインストール後、Claude Code で/engram-dashboard-htmxを入力して読み込まれたか確認します。
詳細
使用する場面
以下の場合にこのスキルを使用します。
- htmx の部分読み込みやフィルターコントロールを追加するとき
- ダッシュボードのフォームやトグルを接続するとき
- ブラウザーや検索の操作を変更するとき
HTMX のルール
- サーバーでレンダリングされた HTML がプロダクトであり、htmx はこれを拡張するものであって、置き換えるものではありません。
- カスタムのクライアント側状態管理より、シンプルな
hx-getとhx-includeを優先します。 - フィルターは、操作をまたいでもユーザーが期待する現在の状態を維持する必要があります。
- システムの状態を変更するフォームは、通常の HTTP POST としても動作する必要があります。
- 部分更新用のエンドポイントは、それ自体で意味のある HTML を返す必要があります。隠れた JS の前提に依存するフラグメントを返してはいけません。
操作のルール
- 検索とフィルターのコントロールは、互いに支障なく組み合わせられる必要があります。
- トグル操作では、サーバーの処理後の状態が明確に表示される必要があります。
- 関連するナビゲーションでは、URL が意味を持ち、共有できる状態を保つ必要があります。
- htmx は速度向上のために使用し、ブラウザー内にビジネスロジックを隠すために使用してはいけません。
コメント
Markdown 対応