skillZs
★ LIVE SKILL TAGS ★
>>> LIVE SKILLS INDEX <<<
* OPEN SOURCE *
NO LOGIN, NO TRACKING
※ REAL INSTALL DATA ※
← back to all skills
lism-css/core25 installs

lism-css-guide

Lism CSSでUIやページを実装・修正する時に使う実装ガイド。Primitive選定・トークン照合・Property Class/Lism Props活用・レスポンシブ設計・アンチパターン照合を変更規模に応じて行う。b--*, c--*, l--*, a--*, is--*, has--*, set--*, u--*, -prop:value形式のクラスやトークンの逆引きにも使う。

How do I install this agent skill?

npx skills add https://github.com/lism-css/core --skill lism-css-guide
view source ↗

Is this agent skill safe to install?

  • Gen Agent Trust Hubpass

    A legitimate and comprehensive development guide for the Lism CSS framework. It provides structured workflows, coding standards, and documentation for developers to build and maintain UI components using Lism CSS.

  • Socketpass

    No alerts

  • Snykpass

    Risk: LOW · No issues

What does this agent skill do?

Lism CSS 実装ガイド

Lism CSSでUI・ページ・コンポーネントを実装する時の判断の起点。変更規模から実行レベルを判定し、実装前チェック→実装→提出前セルフチェックを通す。

公式ドキュメント: https://lism-css.com/docs/overview.md

バージョン: lism-css@1.1.0/@lism-css/ui@0.40.1時点の情報。プロジェクトのバージョンが異なる場合はユーザーに伝え、パッケージ更新またはこのスキルの更新を案内する。

実装フロー(厳守)

資料確認は、コード上の操作の直前に行う。どの操作の手前で何を読むかは「資料確認トリガー」に従う。

  1. 実行レベル判定: 「事前チェック実行レベル」で不要/軽量/通常/値照合付きを決める。
  2. 初期確認: SKILL.mdだけで実装しない。実装対象に明らかに関係する最小限の詳細ファイルを先に開き、実装プランに「初期確認した資料」を列挙する。リンク表を眺めただけは確認済みにしない。
  3. 「目的別実装ガイド」でPrimitive/コンポーネントの候補を選ぶ。
  4. 実装前チェック(C0–C8)を行い、初期確認した資料・使うPrimitive・コンポーネント・トークン・レスポンシブ方針を列挙した実装プランを出す。未読のまま採用できない判断は🔁を付け、「読む資料」を判断行に紐づける。
  5. 「資料確認トリガー」に従い、各操作をコードに書く手前で対応資料を読み、🔁を✅または⏸へ解消する。
  6. ⏸が残る項目(px丸め・任意色・挙動変更・公開クラス変更など)は、その部分を実装する前にユーザー確認する。確認が取れない場合は「判定記号」の⏸の項に従う。
  7. 実装する。
  8. (通常・値照合付きのみ)「提出前セルフチェック」で実装プランと実装を照合する。

C0–C8の詳細と実装プランの書式はreferences/authoring.md。

判定記号

実装プランの各行に付ける。使えるのは次の3記号と、✅への注記✅新規・✅例外・✅前提だけ。注記の組み合わせ(✅例外/前提等)や新しい記号・注記は作らない。該当する行は🔁として扱う。

記号意味
✅確定。新規定義(コンポーネント/トークン/クラス)や合意済みの直書き例外は行内に注記する(例: ✅新規、✅例外(1px罫線))
🔁資料確認トリガーに該当する未通過項目。対応操作をコードに書く手前で指定資料を読み、✅または⏸へ解消する。🔁のまま実装しない
⏸要ユーザー確認。確認まで実装しない

✅例外の条件: antipatterns.mdの「直書きしてよい例外」に該当する場合だけ。行にはその項目の引用を添え、引用を書けない行は⏸。それ以外の例外化・丸め・新規トークンは⏸。許可リストに例外カテゴリを自作しない。「正確に再現して」等のユーザー指示や実測値であることは根拠にならない。デザイン値の既定の扱いはreferences/authoring.mdの「デザインデータ取り込みフロー」に従う。

⏸の確認が取れない場合(自律実行など): 原則準拠側の選択肢(すり合わせ済みの方針があればそれ、無ければ入力種別ごとの既定動作。例: 最寄りトークンへの丸め)を選び、その行を✅前提(p="30"へ丸め)のように更新して進め、完了報告で論点と代替案を列挙する。px直書き・例外カテゴリの新設・公開クラス変更・破壊的変更など逸脱側の選択肢は選べず、⏸のまま実装しない。

lism-css-refactorスキルは同じ記号を別の意味(✅=触らない、⬜=意図的に残す等)で使う。リファクタ時はrefactor側の定義に従い、どちらの意味かを表の見出し等で明示する。

実装前チェック項目(C0–C8)

C見ること主な参照先
C0入力整理:対象/粒度/フレームワーク/既存制約/不明点既存コード・要件
C1構造・セマンティクス選定primitive-class.md、components-core.md
C2再利用・コンポーネント境界components-core.md、components-ui.md
C3命名設計naming.md、css-rules.md
C4状態・バリエーション設計trait-class.md、antipatterns-layout.md
C5値・トークン照合tokens.md、property-class.md
C6レスポンシブ方針responsive.md、trait-class/is--container.md
C7CSSに書くもの/Propsに移すものproperty-class.md、css-rules.md
C8既定値の確認primitives/l--*.md

事前チェック実行レベル

レベル条件確認するC出力提出前セルフチェック
不要説明のみ/コード変更なし/既存の書き方をなぞるだけの変更(下記の判定基準)—なし。手順6(実装)だけ行い、.lism/も作らない行わない
軽量数行の小変更・既存パターン内の変更・Props/Property Classだけで完結する小部品の追加C1・C5中心3〜5行の箇条書き行わない
通常新規セクション、または新規CSS(b--*/c--*のスタイル宣言)を伴う新規部品必須=初期確認した資料、C0、C1、C5、C6。該当時だけC2/C3/C4/C7/C8項目別の表実施し、.lism/review.mdへ保存
値照合付きFigma/スクショ等のデザイン再現通常+C5/C7を詳しく確認項目別の表+トークン差分表(差分列必須)。チャットではなく.lism/plan.mdへ保存実施し、.lism/review.mdへ保存

.lism/の規約はreferences/verification.md。

「不要」の判定基準: 次のいずれも含まなければ「不要」。1つでも含めば「軽量」以上。

  • 新規のc--*/b--*クラス
  • 新規のCSS宣言(ファイル・<style>)
  • 既存コードで使っていないPrimitive/Trait/コンポーネントの導入
  • 新規のレスポンシブ切替
  • トークン外の数値・色

不要/軽量/通常で迷っても上のレベルへ上げない。デザイン再現かどうかで迷う場合だけ「値照合付き」にする。通常でも該当しないCは省略し、表を形だけ埋めず実装に影響する項目だけ列挙する。

資料確認トリガー

左の操作をコードに書く手前で右の資料を読む。未読ならその判断は🔁にし、読んで✅にするか、判断できなければ⏸にする。🔁のままコードへ反映しない。「必要なら参照」で代替しない。

この操作をする手前でこの資料を読む
まだ読んでいないPrimitiveを使う該当のprimitives/l--*.md
まだ読んでいないTrait Classを使う該当のtrait-class/*.mdまたはtrait-class.md
スタイル宣言をCSS(ファイル・<style>)に書く、またはProperty Class/Lism Propsへ移すproperty-class.md
hover/focus等の状態スタイルを書くproperty-class/hov.md(必要に応じてtrait-class/has--transition.md)
トークン外の数値・色をコードに書く(丸める場合を含む。CSS/Props問わず)tokens.md、antipatterns.mdの「px / 固定値の直書き」節
レスポンシブの切替を決めるresponsive.md
独自クラス(b--*/c--*)を新しく作る/名前を付けるnaming.md、css-rules.mdの独自クラスの選び方(2分類)節
b--*/c--*のCSSを書くcss-rules.mdのBlock Class(b--)/Custom Class(c--)節
状態・バリエーションを設計するtrait-class.md

最小ゲート

常に守る。迷う・例外にする・既存実装と衝突する場合は該当資料を読み、🔁を✅または⏸へ解消する。

  • 構造は<div>+素のCSSよりPrimitiveを優先する。候補は「目的別実装ガイド」から選ぶ。
  • c--*/b--*はBlockをcamelCase、Elementを_ひとつ、Modifierを--ふたつで命名する。c--feature-cardや__は使わない。
  • 独自クラスは2分類で命名する: ベーススタイルをCSS側で管理する共通基礎部品→b--、それ以外→c--。
  • 独自CSSは必ず@layer lism-custom内に置く(b--のベーススタイルだけ@layer lism-block)。
  • トークン外のpx/rem/em値を勝手に丸めたり直書きしたりしない。丸め・新規トークン・直書き例外は⏸(✅例外の条件は「判定記号」)。
  • c--*では、単一要素にだけ効く宣言はCSSに書かず、まずLism Props/Property Classで表せないか確認する。CSSに残すのは擬似要素・子孫セレクタ・状態切替などProperty Classで書けない宣言だけ。名前として残すのは本体クラスc--nameだけで、CSSで参照しないElement(c--name_elem)は付けない。b--*のベーススタイルは対象外で、トークンを使って@layer lism-blockに書いてよい(BP切替・hover・例外的な調整はProperty Class)。
  • レスポンシブ値は、container query運用なら必要なisContainer祖先を確認する。
  • 状態はdata-*/ARIA、見た目バリエーションはBlockと同じプレフィックスのModifier(c--name--variant/b--name--variant)で表す。is--activeのようにTrait Classを状態名に流用しない。

目的別実装ガイド

やりたいことから候補を引く。複数候補の行は括弧内の基準で使い分ける。

やりたいこと使う候補詳細
縦並びStack/Flowprimitives/l--stack.md、primitives/l--flow.md
横並びCluster(折り返す)/Flex(細かく制御する)primitives/l--cluster.md、primitives/l--flex.md
カラムColumns(等幅N列)/AutoColumns(最小幅ベースの自動段組み)/WithSide(2カラム自動切替)primitive-class.md#カラムレイアウト-primitive-の使い分けガイド
幅制御Container(コンテナクエリ基準)/Wrapper(直下領域の幅制限)/max-sz(単体の幅)trait-class/is--container.md、trait-class/is--wrapper.md、property-class/max-sz.md
画像・動画・iframeを置くFrame(アスペクト比枠・直下メディアのfit・overflowを任せる)primitives/l--frame.md
ボタン@lism-css/uiのButton。素の<button>を整えるならreset済みのset--plaincomponents-ui.md、set-class.md
ツールチップ・ポップオーバー@lism-css/uiのTooltip(ホバー/フォーカスの補足テキスト)/Popover(クリックで開くパネル。リンクやフォームを含むならこちら)components-ui.md
hover効果-hov:*/hov={{}}/set--hov/has--transition(component CSSの:hoverより先に検討)property-class/hov.md、trait-class/has--transition.md
ボックス・カードの全体リンクBoxLink/is--boxLink(クリック領域と重なり順を任せる)trait-class/is--boxLink.md
小さいUI部品c--*+Property Class(c--*は何のパーツかを示す名前に留め、単一要素の見た目はProperty Class/Lism Propsへ)。ベーススタイルをCSS側で管理する共通部品ならb--*property-class.md、css-rules.md#custom-classc--、css-rules.md#block-classb--
ページの定番セクション(ヒーロー・サイトヘッダー・フッター等)Group+Wrapper/Stack/Clusterの定番構成references/page-sections.md

提出前セルフチェック

通常・値照合付きレベルだけ行う。不要・軽量では、チャット内の簡易確認も評価サブエージェントへの委任もしない。

サブエージェント/タスク委任機能が使える環境では、この節の照合を実装した本人ではなく読み取り専用の評価サブエージェントに委任する(指示テンプレ・報告書式・再評価ループはreferences/verification.md)。報告は.lism/review.mdへ保存し、違反ゼロになるまで修正→再評価を繰り返してから提出し、完了報告で.lism/review.mdを参照する。委任できない環境では、本人が同じ照合をこの節の順に行う。

まず実装プランと実装を1行ずつ照合し、差分を「計画変更(意図的)/実装漏れ(直す)/要確認(再び確認が必要)」に分類する。その後、次を確認する。

プロセス照合

  • 実装プラン内の🔁が✅または⏸へ解消されているか。🔁のままコードに反映した判断がないか。
  • 資料確認ログの各行が実装プランの判断項目と対応しているか。未読のまま採用したPrimitive/トークン/命名/レスポンシブ判断がないか。

ルール照合

  • 「最小ゲート」の各項目に違反していないか。
  • antipatterns.mdとantipatterns-layout.mdのTOCを開き、実装コードに該当しうる項目を1つずつ照合する。リンク表を眺めただけは確認済みにしない。

プラン再審査(プラン段階で✅にした逸脱は差分照合では検出できないため、別に行う)

  • ✅例外を含む✅判定を、最小ゲート・antipatterns.mdの「直書きしてよい例外」・すり合わせ済みの値マッピング方針に再照合する。許可リスト外の✅例外は⏸へ戻す。
  • 値照合付きでは、.lism/plan.mdにトークン差分表(差分列付き)があるか確認する。無ければ実装プランは無効。差分表を作って照合をやり直す。スケール前提(画像の書き出し倍率等)が実測・整合チェックで検証済みかも確認する(未検証なら差分表全体が無効)。
  • 実行レベル判定が妥当だったか見直す(デザイン再現なのに「値照合付き」へ上げず、差分表を回避していないか)。

個別確認

  • @lism-css/uiの既存コンポーネントで置き換えられないか。
  • 同じProperty Classの組み合わせが3箇所以上ならコンポーネント化を検討したか。
  • 既存の命名・レイヤー・ファイル配置に合っているか。
  • 値照合付きでは、レンダリング結果の確認を完了報告の前提にする。確認できない環境では完了報告にユーザーへの目視確認依頼を含める。HTTPステータスやビルド成功だけで完了扱いにしない。

詳細リファレンス

ファイル内容・読む時
primitive-class.mdl--/a-- Primitive一覧と使い分け。レイアウト選定(必要ならprimitives/l--*.mdも)
trait-class.mdis--/has-- Trait一覧と役割。状態・バリエーション設計
property-class.md-{prop}:{value}形式のProperty Class。CSSをProperty Class/Propsへ移せるか
utility-class.mdu--*ユーティリティ
set-class.mdset--plain/set--hov等のセットクラス。reset済みボタン等
tokens.mdデザイントークンとCSS変数。余白・色・角丸・影・fzの照合
naming.md命名規則とProperty Class省略ルール
css-rules.mdCSS設計・Layer構造・b--*/c--*・独自クラスの分類。カスタムCSS
responsive.mdBP・コンテナクエリ・レスポンシブProps
base-styles.mdReset CSSとHTML要素の基本スタイル。素のHTML要素の既定を確認
components-core.mdlism-cssのReact/Astroコアコンポーネント
components-ui.md@lism-css/uiのUIコンポーネント。UIコンポーネント置換
customize.mdSCSS変数・lism.config.jsによるカスタマイズ
antipatterns.mdAIが生成しがちなNG→OK(値・スタイル宣言系)。典型ミス確認
antipatterns-layout.mdNG→OKの分冊(構造・レイアウト・レスポンシブ系)
references/authoring.md実装プランの作り方(C0–C8詳細・出力フォーマット)
references/verification.md.lism/規約・評価サブエージェントへの委任
references/page-sections.mdヒーロー・ヘッダー・フッター等の定番構成例

クラス単位の詳細リファレンス

ファイル名はクラス名そのまま(primitives/l--stack.md等)。対応コンポーネント名はcomponents-core.md。

  • primitives/: l--box l--flex l--stack l--cluster l--grid l--flow l--center l--frame l--columns l--tileGrid l--autoColumns l--switchColumns l--withSide a--icon a--divider a--spacer a--decorator
  • trait-class/: is--container is--wrapper is--layer is--boxLink has--transition has--gutter has--snap has--mask
  • property-class/: all-props.md(全Prop表)、bd.md(-bd/-bd-{side}系)、hov.md(-hov:*系)、max-sz.md(-max-sz:full/bleed)

このスキルファイル自身のアップデート方法

スキル更新の依頼にはlism-cli skill addまたはlism-cli skill updateを案内する。最新はGitHubリポジトリのskills/lism-css-guideで確認する。

Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.

<a href="https://skillzs.dev/skills/lism-css/core/lism-css-guide">View lism-css-guide on skillZs</a>