mcpField
H
html-style

html-style

github.com/shipshitdevデザイン・UI38232 回インストール2 日前に更新
リポジトリ

html-style について

html-styleは、基本的なHTMLに指定のデザインシステムを適用するスキルです。一般的な要素に使うCSSクラスを示し、操作用スクリプトを加える場面も説明します。

主な機能

  1. 01デザインシステムに沿ったHTML装飾
  2. 02状態・傾向・タグ用クラス
  3. 03テーブルとセクションの装飾
  4. 04折りたたみとスクリプトのガイド
  5. 05ダークテーマのルール

活用シーン

  1. 01テーブルや状態テキストの装飾
  2. 02下書きやコピー用ボタンへの操作追加
  3. 03quick-viewやtable-filtersの出力の装飾

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/shipshitdev/skills --skill html-style

インストール後、Claude Code で/html-styleを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

plugin.json
README.md
assets/
base.css
references/
style-guide.md

詳細

html-style

特定のデザインシステムを使用して、必要最低限の HTML をスタイル付きの出力に変換します。

ワークフロー

  1. ユーザーの HTML を読み取ります
  2. スタイルを適用する要素(テーブル、リスト、ステータステキスト、ボタン、セクション)を特定します
  3. assets/base.css の <style> ブロックを挿入します
  4. HTML 要素に適切なクラスを追加します
  5. 必要に応じてインタラクティブな JS を追加します(コピー ボタン、下書き、折りたたみ可能なセクション)

クラスのクイックリファレンス

要素クラス効果
ステータステキスト.stale .warm .pendingインラインテキストを赤/緑/オレンジで表示
トレンド.trend-up .trend-down緑の ↑ /赤の ↓
カテゴリータグ.tag-group .tag-dm .tag-money青/紫/オレンジのピル
ステータスピル.status-success .status-error .status-pending緑/赤/オレンジの塗りつぶし
フィルター切り替え.filter .filter.activeアウトライン/黒の塗りつぶし
時間フィルター.pill .pill.active小さなピル。アクティブ時は黒
統計ボックス.stat > .stat-value + .stat-label28px の数値、12px のラベル
テーブルデフォルトまたは .table-styled最小限のスタイル、または色付きの値
セクションヘッダー.section-header白いテキストの濃色バー
折りたたみ可能<details> + <summary>HTML 標準の折りたたみ
インサイト.insightイタリック体、黄色の背景
ティア.tier-gold .tier-silver .tier-bronze行の背景色

要素のスタイル設定ルール

テーブル
  • デフォルト:最小限の境界線、ホバー効果なし
  • 次の効果を適用する場合は .table-styled を追加します:ホバー効果、.positive/.negative セルの色、.highlight 行
  • 並べ替え可能にするには、<a href="?sort=col">Col ▼</a> を指定した th.sortable を追加します
ステータスインジケーター
  • テキストステータス(.stale/.warm/.pending):文中のインラインステータスに使用します
  • ステータスピル(.status-*):バッジ形式のインジケーターに使用します。通常、アイコン(✓ ✗ ◷)を添えます
  • トレンド(.trend-up/.trend-down):数値の変化に使用すると、矢印が自動的に追加されます
セクション

視覚的な区切りとして、絵文字のプレフィックスを付けて .section-header を使用します。

<div class="section-header">🔴 URGENT</div>
<div class="section-header">🟠 PENDING</div>
インタラクティブ要素

HTML に下書きやコピー ボタンがある場合は、次の JS を追加します。

function saveDraft(el) {
    localStorage.setItem('draft:' + el.dataset.threadId, el.textContent);
}
function copyToClipboard(text, btn) {
    navigator.clipboard.writeText(text).then(() => {
        btn.textContent = 'Copied!';
        setTimeout(() => btn.textContent = 'Copy', 1500);
    });
}
ディープリンク

URL をネイティブアプリのリンクに変換します。

  • Telegram:tg://resolve?domain=username
  • SMS:sms:+14155551234

テーマ

  • デフォルト:ライト(background: #fff)
  • ダークモード:ユーザーがダークテーマをリクエストした場合、またはコンテキストが取引/リアルタイムの場合、<body> に class="dark" を追加します

Structure Skills との互換性

quick-view または table-filters の出力にスタイルを適用する場合、次のクラスマッピングを使用します。

quick-view クラス
そのクラススタイルの適用先
.type-user.status-pending(青い境界線)
.type-draft.status-pending(オレンジの境界線)
.type-done.status-success(緑の境界線)
.sourceスタイル適用済み(控えめ、小さめ)
.metaスタイル適用済み(控えめなヘッダー)
.actionsインラインのボタングループ
table-filters クラス
そのクラススタイルの適用先
.filter-bar間隔を空けたフレックス行
.filter-chipsインラインのチップコンテナー
.chip.chip-remove を含む濃色のピル
.filter-menuドロップダウンパネル(.filter-menu)
.empty-state中央揃えの控えめなテキスト

base.css には、これらのクラスのスタイルが自動的に含まれます。

リソース

  • スタイルの完全なリファレンス:詳細な CSS パターンと例については、references/style-guide.md を参照してください
  • ベース CSS:<head> 内の <style> タグに assets/base.css を挿入します

コメント