liquid-glass-design

liquid-glass-design スキルの概要

liquid-glass-design は何のためのものか

liquid-glass-design スキルは、Apple の iOS 26 Liquid Glass を実際の UI 実装に落とし込むためのスキルです。たとえば、ガラス調のボタン、カード、ツールバー、コンテナ、変形するサーフェス、Widget の表現などに使えます。SwiftUI、UIKit、WidgetKit に自然になじむコードを求めているときに特に有効で、単なる「すりガラス風」の近似では足りない場面に向いています。

どんな人がインストールすべきか

iOS 26 以降のアプリを新規に作る、または更新していて、新しいマテリアルをどう実装すべきか明確な指針がほしいなら、liquid-glass-design スキルのインストール価値があります。UI エンジニア、デザインシステムを磨き込むプロダクトチーム、ざっくりした見た目の要望を Swift コードに変換したいエージェントとの相性が良いスキルです。

何を判断しやすくなるか

この liquid-glass-design ガイドは、発想を広げるためというより、実装判断のためのものです。どのタイミングで効果を有効にするか、どの API を使うか、形状や tint をどう選ぶか、Liquid Glass が UI を良くする場面とノイズになる場面はどこか。インストール時点で「使って大丈夫か」を見極めたいとき、ざっとリポジトリを眺めるより役立ちます。

liquid-glass-design スキルの使い方

スキルをインストールしてファイルを開く

まずは自分の環境に合わせたスキルのインストール手順を使い、最初に skills/liquid-glass-design/SKILL.md を開いてください。リポジトリを直接見ながら進める場合も、まずそこを起点にしてから、関連するサンプルや近接ドキュメントを確認してコーディングに入るのがよい流れです。liquid-glass-design install の判断は、このスキルが iOS 26+ と自分のターゲット UI スタックに絞られているかを確認すると、かなりしやすくなります。

具体的な UI 対象を与える

liquid-glass-design usage のパターンは、プロンプトで対象のコンポーネント、プラットフォーム、インタラクションモデルを明示したときに最もよく機能します。良い入力例: 「この SwiftUI の設定カードを、控えめな tint、角丸長方形の形状、iPhone ではレイアウト変更なしで Liquid Glass 化して」。弱い入力例: 「この画面をもっとモダンにして」。前者なら、形状・強さ・統合方法を選ぶのに十分な情報があります。

編集前に読むべき箇所を押さえる

実装に入る前は、アクティベーションのガイド、基本の SwiftUI パターン、形状と tint のカスタマイズ、ボタンスタイル、そして範囲に含まれるなら UIKit / WidgetKit の節を読んでおくと実務に乗せやすくなります。これで通常は、リポジトリを読み込みすぎることなく、liquid-glass-design の想定ワークフローを把握できます。特に glassEffect、buttonStyle(.glass)、インタラクション別のバリアントを示す例に注目してください。

1回で終わらせず、ワークフローとして適用する

liquid-glass-design のよい進め方は、まずガラス調にしたい面を特定し、デフォルトの効果を 1 つ選び、実データでコントラストを確認し、必要がある場合だけ tint と形状を詰める、という流れです。可能なら、1 回の依頼で 1 コンポーネントに絞ってください。そうすると、推測ベースの装飾ではなく、実装に足がついた出力になりやすくなります。

liquid-glass-design スキル FAQ

これは iOS 26 アプリ専用ですか？

はい、そう考えてください。古い iOS バージョンを対象にしている場合、liquid-glass-design のインストールだけで互換性の問題が解決することは期待できません。代替スタイルや条件分岐による描画が必要になります。

普通のガラス UI プロンプトと何が違うのですか？

違います。一般的なプロンプトでもガラスっぽい見た目は説明できますが、liquid-glass-design スキルは Apple の実際の Liquid Glass の挙動に軸足があります。ぼかし、反射、インタラクティブな応答、そして結果をネイティブに見せるためのプラットフォーム固有の API パターンまで含めて扱います。

初心者でも使えますか？

はい、変更したいコンポーネントがすでに分かっているなら使えます。初心者は、画面全体の再設計を求めるより、1 つの view、1 つの platform、1 つの出力目標に絞って依頼したほうが、最も良い結果を得られます。

使わないほうがいいのはどんなときですか？

広いクロスプラットフォーム対応が必要なアプリ、Apple 以外のシステムとの厳密なビジュアル整合が必要な場合、あるいはフラットなデザイン言語を維持したい場合には、liquid-glass-design は使わないほうがよいです。そうしたケースでは、このスキルの前提が、プロダクトに合わない効果へ引っ張ってしまうことがあります。

liquid-glass-design スキルを改善するには

まず美学ではなくコンポーネントを指定する

品質が最も大きく上がるのは、ボタン、カード、ツールバー、Widget、シート、コンテナなど、正確な UI オブジェクト名を指定するときです。強い liquid-glass-design プロンプトには、その要素がインタラクティブか、tint を付けるのか、装飾だけなのかも含めてください。そうすると、形状と API の選定で迷いにくくなります。

実装に影響する制約を入れる

タッチターゲット、コントラスト、レイアウトの安定性、アニメーションの控えめさを重視するなら、最初に明記してください。たとえば「カードのサイズは変えないで、雑然とした背景の上でも読みやすさを保ち、強い tint は避けて」といった具合です。Liquid Glass は見た目が良くても、文脈によっては派手すぎたり弱すぎたりするため、こうした条件が重要になります。

1回目の結果はリアルさで確認する

最初の出力の後は、きれいなモックアップ上だけでなく、実際のコンテンツ上でも効果が成立しているかを確認してください。よくある失敗は、tint が強すぎる、テキストのコントラストが足りない、複数の面にガラス効果を使いすぎる、の3つです。「もっとガラスっぽく」と広げるのではなく、より狭い条件で調整したほうが、たいてい結果は良くなります。

環境とフレームワークごとに反復する

liquid-glass-design の最初の結果が惜しいところまで来ているなら、実際のフレームワークと出力先に合わせて反復してください。SwiftUI のカードなのか、UIKit のコントロールなのか、WidgetKit のサーフェスなのかを明示し、周囲の画面、背景の複雑さ、維持したいシステムスタイルも伝えます。分離した状態で見栄えする出力ではなく、そのまま出荷できる出力に最短で近づける方法です。