本文へ移動
cccskills
無料GitHub で公開

Tailwind CSS Class Hygiene Review

Checks Tailwind utility class hygiene at the syntax level: arbitrary-value overuse that bypasses the theme scale, conflicting/duplicate utilities on one element, and hardcoded arbitrary colors that should use design tokens.

インストール方法を見る

含まれるファイル(4)

  • SKILL.md4.7 KB
  • fixtures/01-arbitrary-value-happy.md1.0 KB
  • fixtures/02-theme-extended-guard.md1.2 KB
  • golden/01-arbitrary-value-happy.md974 B

SKILL.md(原文)

インストールする前に、エージェントに与えられる指示の中身を確認できます。

Pattern declaration

Primary pattern: Reviewer Secondary patterns: Inversion Why: Tailwind の utility class 構文(arbitrary value / クラス競合)をチェックリスト型で検査し、診断材料が無ければゲートで止める。

Goal / 目的

  • スケール/トークンを迂回する任意値(w-[437px] mt-[13px] text-[#1a2b3c] 等)の濫用を検出し、テーマのスペーシング/カラースケールへの寄せを促す。
  • 同一要素に併存する競合・重複ユーティリティ(px-2 px-4、flex block、mt-2 mt-4 等、互いに打ち消すクラス)を検出する。
  • デザイントークン(bg-white / theme color)で表現すべき色の任意カラー直書き(bg-[#fff] 等)を検出する。

Non-goals / 扱わないこと

  • デザイントークン体系全般の是非(命名・粒度・採用方針)は design-token-enforcement のスコープ。本スキルは Tailwind の utility class 構文レベルの衛生に限定する。
  • Tailwind か素の CSS かといった採用技術の選定。
  • レスポンシブ/状態 variant(md: hover: 等)の設計妥当性。

Pre-execution Gate / 実行前ゲート

このスキルは以下の条件がすべて満たされない限りNO_REVIEWを返す。

  • 差分に className / class への Tailwind utility の追加・変更が含まれている
  • diff コンテキストが利用可能である

ゲート不成立時の出力: NO_REVIEW: tailwind-class-hygiene — className/class への Tailwind utility 変更なし

False-positive guards / 抑制条件

  • 設計上スケール外が必要な正当ケース(例: 1px ボーダー border-[0.5px]、外部デザイン由来の固定値で theme.extend 済み等)で、コメントによる正当化または theme 拡張が確認できる場合は指摘しない。
  • 動的クラス(テンプレートリテラル内で実行時計算される値、例: w-[${width}px])は別スコープとして扱い、静的な任意値と同列に断定しない(慎重に、必要なら質問に留める)。
  • theme に存在しない CSS(grid template など)を表現する arbitrary value が公式に推奨される稀なケースは、断定せず質問に留める。
  • 同一クラスに見えても variant prefix が異なる場合(px-2 md:px-4 等)は競合ではないため指摘しない。

Rule / ルール

  • 任意値([...])でスケール/トークンに対応物がある値(スペーシング・サイズ・カラー)を直書きしている場合は、theme のスケール/トークンへ寄せる修正を提案する。
  • 同一要素の同一プロパティに作用する複数ユーティリティが併存(px-2 px-4、mt-2 mt-4、flex block 等)し、後勝ちで前者が無効化される場合は重複/競合として指摘する。
  • 任意カラー直書き(bg-[#fff] text-[#000] 等)でデザイントークン(bg-white / theme color)に対応物がある場合はトークン利用を提案する。
  • "nit" を濫発しない。明確に theme で代替できるものに絞り、判断が割れるものは質問に留める。

Evidence / 根拠の取り方

  • 指摘は <file>:<line> で差分に紐づけ、どのクラスが問題か(任意値 / 競合 / 任意カラー)を 1 行で添える。
  • theme 対応物の有無が diff だけで確証できない場合は断定せず「可能性」として書く。

Output / 出力(短文版の推奨)

コメントは日本語で返す。

  • Finding: どのクラス衛生に反しているか(任意値濫用 / 競合 / 任意カラー、1文)
  • Impact: スケール逸脱で一貫性低下 / 後勝ちで意図しない値 / トークン迂回で一括変更不能 等
  • Fix: theme スケール(w- 系)/ 競合解消(片方削除)/ トークン(bg-white 等)への最小修正案

Sources / 出典

レビュー

まだレビューはありません。使ってみた感想をお寄せください。

同じリポジトリのスキル

概要と使いどころ

<What this skill does>

日本語の概要は準備中です。原文の説明を表示しています。

s977043/river-review42026年10月12日 更新

a11y Accessible Name Basics

無料日本語概要

画像・ボタン・フォーム要素に適切なアクセシブルネームがあるか確認する。

s977043/river-review42026年10月12日 更新

Ensure ADRs capture context, decision, alternatives, tradeoffs, and follow-ups in a way that prevents future drift.

日本語の概要は準備中です。原文の説明を表示しています。

s977043/river-review42026年10月12日 更新

adversarial-review

無料日本語概要

敵対的分析手法を統合したレビューの entry skill。認知バイアス対策の3手法 (Pre-mortem / War Game / Logic Torturing)と、宣言・主張と実態の乖離を突く claim-vs-actual 検出3パターン(Self-Contradiction / Refactor-Claim Audit / Cross-File Leakage)へルーティングし、通常のレビューでは見えない設計の盲点・ 防御の穴・論理の弱点・宣言と実装のズレを可視化する。

s977043/river-review42026年10月12日 更新

Review changes to the Agent Skills import/export bridge for path safety, round-trip fidelity, and validation correctness.

日本語の概要は準備中です。原文の説明を表示しています。

s977043/river-review42026年10月12日 更新

Checks whether AI-assisted work defines review criteria, accessible context, explicit review loop, human judgment boundary, and feedback capture before delegating to an agent.

日本語の概要は準備中です。原文の説明を表示しています。

s977043/river-review42026年10月12日 更新

s977043 のスキルをすべて見る

このスキルの問題を報告する