Communitygithub.com

CharbelElBateh/personal-website

現代的なSwiftの書き方—値型によるモデリング、Swift 6のデータ競合安全性と親しみやすい並行性(@concurrent、MainActorデフォルト、アクター、タスクグループ)、プロトコルとジェネリクス(some vs any)、API設計、パフォーマンスとARC、Swift Testing、マクロ、そしてエージェントがまだ知らない最新の言語機能。Swiftの作成、レビュー、移行、または並行性エラー、ハング、データ競合、強参照サイクル、パフォーマンス問題の修正時に使用します。

personal-website とは?

このスキルは、エージェントがSwift 6.xの最新ベストプラクティスに従ったモダンなSwiftコードを作成、レビュー、改善するための包括的なガイドを提供します。値型(struct/enum)のデフォルト使用、データ競合を防ぐためのプログレッシブな並行性モデル(単一スレッド→async/await→@concurrent→actor)、Sendableプロトコルによる安全なデータ共有、構造化並行性(async let、タスクグループ)の優先、そしてパフォーマンスとメモリ管理(ARC、コピーオンライト)に焦点を当てています。Claude Code、Cursor、Codexなどの主要なAIエージェントツールで使用でき、SKILL.mdには値型によるデータモデリング、エラー処理、アクターの再入可能性、グローバル変数の危険性、プロトコル設計(some vs any)、Swift Testingフレームワーク、マクロ、パッケージ管理のベストプラクティスなどが詳細に解説されています。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/CharbelElBateh/personal-website/tree/HEAD/.claude/skills/write-swift

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

Swiftを書く

初期応答

このスキルが特定の質問なしに最初に呼び出された場合、次のようにのみ応答します:

モダンなSwiftを、言語が意図する方法で書くお手伝いをします。

ユーザーが質問するまで、その他の情報は提供しないでください。

言語が意図する方法でSwiftを書く方法。Swift 6.4まで対応。

ツールチェーンベースライン:Swift 6.3(2026年8月時点の最新リリース)。ここに記載されている内容は、特に注記がない限り6.3でコンパイルできます。⚠ マークは未リリースのSwift 6.4機能を示します。並行性のガイダンスはSwift 6.2モデルを前提としています。プロジェクトが6.1以前の場合は、§3のasyncと@concurrentに関するルールは適用されません。

一貫したテーマ:Swiftは段階的に開示される言語です。最もシンプルで、最も静的で、最もシングルスレッドな、動作するものから始め、動的要素(並行性、参照セマンティクス、存在型、安全でないポインタ)は、その理由を明確に示せる場合にのみ導入します。 以下のすべてのルールは、この原則の適用です。

このデフォルトの階層をモデル化します。理由を明確に示せる場合にのみ、1つ下のレベルに移動します:

ニーズ最初に使うもの次の場合にのみダウングレード
データstruct / enum同一性、共有、継承が必要な場合
抽象化具体的な型型をまたがる繰り返しコードがある場合
ポリモーフィズムsome P (ジェネリック)異種ストレージが必要 → any P
実行メインアクター、同期的プロファイリングでハングが判明 → async → @concurrent → actor
メモリArray, Stringプロファイリングでコストが判明 → InlineArray, Span
安全性安全なAPIC相互運用または測定されたホットパス → Unsafe*

1. 値型でデータをモデル化する

値型はSwiftのデフォルトであり、特別なケースではありません。

  • デフォルトでstructとenumを使用します。classは、同一性、共有可変状態、継承、またはリソースのライフタイムが必要な場合にのみ使用します。 ウィンドウ、データベース接続、レンダリングエンジンに格納されたエンティティには同一性があります。Point、Drink、Materialにはありません。
  • デフォルトでletを使用し、変更する場合のみvarを使用します。 これは、someをanyの前に、値を参照の前に置くのと同じ規律です。狭く始め、理由があって広げます。
  • 可変な参照型プロパティを持つ構造体は、値でも参照でもありません。 コピーはオブジェクトを共有し、変更はコピー間で漏洩します。参照される型を不変に保つか、それに転送する計算プロパティのみを公開するか、コピーオンライトの背後にあるprivateな格納プロパティにします。
  • コピーオンライトは、アウトオブラインストレージと値セマンティクスの両方を実現する方法です。 最終クラスを構造体でラップし、変更前にisKnownUniquelyReferenced(&storage)をチェックします。一意でない場合は最初にコピーします。これこそがArray、String、Dictionaryが機能する仕組みです。
  • Enumは「固定されたものの集合」と相互に排他的な状態のためのツールです。 オプショナルな格納プロパティの山(isSharing、selectedRows、shareTarget)を1つのenum Stateに置き換えることで、無効な組み合わせを表現不可能にし、状態変更を、完了し忘れる可能性のある一連のプロパティ書き込みではなく、アトミックにします。
  • 値を組み合わせると値が得られます。 格納プロパティがすべて値型である構造体は、無料で値セマンティクスを持ちます。これにより、アンドゥ、差分、状態復元が、プロパティごとに1つではなく、単一のコードパスになります。
struct Material {                       // 値セマンティクスが保持される
  var roughness: Double
  private var _texture: Texture         // クラス

  var color: Color {
    get { _texture.color }
    set {
      if !isKnownUniquelyReferenced(&_texture) { _texture = Texture(copying: _texture) }
      _texture.color = newValue
    }
  }
}

非コピー可能型(~Copyable)は、ファイルディスクリプタ、銀行振込、開かれたリソースなど、一意の所有権を表現します。コピーを抑制することで、「これを2回実行してはならない」というルールを、アサーションからコンパイルエラーに変え、構造体でのdeinitを意味のあるものにします。終了メソッドをconsumingとマークすることで、コンパイラがそれが最後の使用であることを証明できるようにします。パラメータの所有権は明示的になります:borrowing(読み取り専用、デフォルト)、consuming(受け取って所有権を奪う)、inout/mutating(一時的な書き込みアクセス)。


2. エラーとオプショナル—失敗パスを見えるようにする

Swiftのエラー処理は3つのポイントに基づいています。エラーの発生源はマークされているため、驚かされることはありません。エラーは対処するための十分なコンテキストを持ちます。そして、回復可能なエラーはプログラマのミスとは異なります。

  • 回復可能 → throw。プログラマのミス → precondition/fatalError。 ネットワーク呼び出しの失敗はプログラムを実行し続けます。範囲外のインデックスはコードが間違っていることを意味し、バグがセキュリティ問題になる前に停止しなければなりません。
  • 関連値を持つEnumは最良のエラー型を作ります。 case duplicateFriend(String) は case duplicateFriend よりも優れています—コンテキストがすべてです。
  • エラー条件にはguardを使用します。なぜなら、終了パスを強制するからです。通常のアンラップにはif letを使用します。
  • 型付きスロー(throws(MyError))は、内部関数、エラー転送ジェネリックコード、および制約された環境向けです。any Errorのボクシングが高コストすぎる場合に使用します。公開APIの場合、型なしのthrowsは、後でエラー型を変更する自由を保持します。統合に注意:throwsはthrows(any Error)であり、非スローはthrows(Never)です—これにより、mapが両方を抽象化できるようになります。
  • 強制アンラップは、不変条件を明確に示せる場合にのみ使用し、裸の!よりも、メッセージ付きの失敗する#require/preconditionを優先します。

3. 並行性:プロファイリングで別の指示があるまで、シングルスレッドを維持する

このセクションは、エージェントが最も頻繁に間違えるセクションです。なぜなら、モデルがSwift 6.2で変更されたからです。

すべてのアプリをメインスレッドで完全に開始します。シングルスレッドコードは長い道のりをカバーでき、ほとんどのアプリはそれから離れる必要がありません。

順序に従った進行。ステップをスキップしないでください。

  1. メインアクター上のシングルスレッド。 並行性は一切なし。ほとんどのアプリに適しています。
  2. async/await でレイテンシ(ネットワーク、ディスク)を隠蔽します。依然として独自の並行性はありません—URLSession.data(from:)のようなSDK APIが代わりにオフロードします。
  3. @concurrent で、_あなたの_高コストな処理をメインスレッドから移動します—Instrumentsがハングを示した後にのみ。
  4. actor で、_状態_をメインアクターから移動します—メインアクターの状態が多すぎて、タスクが常に戻ってくることを強制されている場合にのみ。

最初に正しいビルド設定を有効にします。 すべてのプロジェクトで親しみやすい並行性を有効にします。アプリモジュールとUI向けモジュールでは、デフォルトのアクター分離もMainActorに設定します—これはXcode 26の新しいアプリプロジェクトのデフォルトであり、@MainActorアノテーションのほとんどを削除します。パッケージ内:swiftSettings: [.defaultIsolation(MainActor.self)]。汎用ライブラリにメインアクターデフォルトを設定しないでください—ライブラリはnonisolated APIを出荷し、クライアントに処理の実行場所を決定させるべきです。

変更されたルール

Swift 6.2では、関数をasyncとマークしても、現在のアクターから移動しません。 呼び出された場所で実行されます。これにより、「最も自然なコードを書くこと」がデフォルトでデータ競合フリーになります。

  • @concurrent — 常に並行スレッドプールに切り替えます。_あなたの_CPU負荷の高い処理に使用します。
  • nonisolated — 呼び出された場所で実行されます。これはライブラリAPIの正しいデフォルトです。なぜなら、呼び出し元が決定するからです。型に対するnonisolatedは、そのメンバーすべてを非分離にします(Swift 6.1以降)。
  • どちらでもない — 呼び出し元のアクターに留まります。
nonisolated struct PhotoProcessor {          // メインアクターから切り離す
  @concurrent                                // バックグラウンドで実行されることが保証される
  func process(_ data: Data) async -> ProcessedPhoto {
    async let sticker = extractSticker(data)  // 2つの独立したジョブ、並列に
    async let colors  = extractColors(data)
    return await ProcessedPhoto(sticker: sticker, colors: colors)
  }
}
  • オフロードする前にプロファイリングします。 Instruments(Time Profiler、ハング)を使用します。並行性なしでコードを高速化できる場合は、常にそれを先に行います。並行性には実際のコスト(タスク割り当て、スケジューリング、推論)がかかります。
  • 些細な処理のためにタスクを生成しないでください。 UserDefaults値を読み取るための子タスクは、節約する以上のコストがかかります。
  • エンドツーエンドの操作ごとに1つのタスク。 順番に実行する必要がある処理は_1つの_タスクに入れます。独立した操作は別々のタスクに入れ、ランタイムがそれらをインターリーブできるようにします。
  • awaitはサスペンションポイントであり、アトミック性を壊します。 サスペンド中に状態が変化する可能性があり、別のスレッドで再開される可能性があります。すべてのawaitの後に前提条件を再確認します。awaitをまたいでロックを保持しないでください。awaitをまたいでスレッドローカルストレージに依存しないでください。

アクターの再入可能性

アクターは相互排他を保証しますが、トランザクションは保証しません。同じアクター上の2つのawaitの間に、他の処理が実行されます。

  • 同期メソッドでアクターの状態を変更します。 アクター上の同期コードは中断されずに実行されます—それがトランザクション境界です。
  • 非同期アクターメソッドは薄く保ち、同期トランザクション操作で構成し、すべてのawaitでアクターを一貫した状態に保ちます。
  • 古典的なバグ:キャッシュを確認 → awaitダウンロード → キャッシュに書き込み。2つのタスクが両方ともミスし、両方ともダウンロードし、2番目が最初のものを上書きします。awaitの後に再確認するか、実行中の処理を重複排除します。
  • アクターはFIFOではありません。 優先順位の逆転を正確に回避するために、最も優先度の高い処理を最初に実行します。順序付けが必要な場合は、アクターではなく、タスク(開始から終了まで実行される)またはAsyncStreamを使用します。

4. Sendableとデータの共有

Sendableは、分離ドメイン間で共有しても安全な型をマークします。コンパイラは、すべてのタスクとアクターの境界でそれをチェックします。

  • 値型は、そのストレージがSendableである場合にSendableになります—公開されていない型の場合は自動的に推論されます。公開型は送信可能性が推論されることはありません:公開型をSendableとマークすることはクライアントへの約束であるため、Swiftはそれを明示的に記述することを要求します。
  • アクターと@MainActorクラスは暗黙的にSendableです。なぜなら、それらの状態は分離されているからです。
  • ほとんどのモデルクラスは、@MainActorでもSendableでもあるべきではありません。 意図的に非Sendableに保ちます—これにより、モデルの半分がメインスレッドで変更され、残りの半分がバックグラウンドで変更されるのを防ぎます。メインアクターを離れる必要がある場合は、Sendableではなくnonisolatedにします。
  • 送信側が使用を停止する限り、非Sendableオブジェクトをドメイン間で_送信_することもできます。 引き渡す_前に_すべての変更を行います。その後で触れるとエラーになります。
  • クロージャも状態をキャプチャします。関数型が実際にドメインをまたぐ場合にのみ、@Sendableとマークします。
  • @unchecked Sendableは、コンパイラがチェックできない約束です。 実際の内部同期(Mutex、ロック)を持つ型のために予約します。グローバルでのnonisolated(unsafe)も同様—最後の手段であり、警告の抑止力ではありません。

データ競合エラーに遭遇したときは、このリストを順に確認します:

  1. 共有しない。 共有オブジェクトをローカルに移動し、各並行ジョブが独自のインスタンスを取得するようにします。(これは圧倒的多数の実際のエラーの修正です。)
  2. Sendableな値型にする ことで、「共有」を実際にコピーにします。
  3. アクターに分離する —メインアクター、または独自のアクター。
  4. その後にのみ、SynchronizationモジュールのMutex/Atomic(letプロパティに格納)、または@unchecked Sendableに手を伸ばします。

グローバル変数と静的変数は、最も一般的なエラーの原因です。 優先順位:letにする;@MainActorに置く;Mutexでラップする;nonisolated(unsafe)。Cとは異なり、Swiftのグローバルは遅延_かつ_アトミックに初期化されることに注意してください。

古いコールバックAPIのブリッジング: 自分が所有する場合は、デリゲートプロトコルに@MainActorの注釈を付けます。所有していない場合は、メソッドをnonisolatedとマークし、MainActor.assumeIsolated { }を使用します—これはホップする代わりにアサートするため、静かに競合する代わりに大声でトラップします。準拠での@preconcurrencyは、同じことの省略形です。@preconcurrency importを使用して、移行していないモジュールからの送信可能性警告を一時的に抑制します。移行が完了すると、警告は—正しく—再表示されます。


5. 構造化並行性

常に構造化タスクを優先します。

構造化タスク(async let、タスクグループ)はローカル変数のようにスコープされます。ブロックを超えて存続できず、自動的に待機され、タスクツリーを通じてキャンセル、優先順位、タスクローカル値を継承します。非構造化タスク(Task { }、Task.detached)は、それらのいずれも自動的には提供しません。

  • async let — 固定された、静的に既知の数の並行子タスクに使用します。
  • withTaskGroup — 数が動的な場合に使用します。タスクグループはAsyncSequenceに準拠します—結果が到着した時点で反復処理します。子タスクが何も返さない場合は、withDiscardingTaskGroup を使用します。これは各子のリソースを即座に解放し、最初のエラーで兄弟タスクをキャンセルします。
  • Task { } — 処理のライフタイムがスコープに収まらない場合のみ—デリゲートコールバック、ボタンタップ、ビューの表示への反応など。アクター分離と優先順位を継承しますが、キャンセルは自分で管理する必要があります。
  • Task.detached — ほとんど使用しません。何も継承しません—分離も、優先順位も、タスクローカルも。切り離されたルートが必要な場合は、繰り返し切り離すのではなく、_その中に_タスクグループを配置します。

キャンセルは協調的です。 キャンセルはフラグを設定します。何も停止しません。高価な処理を開始する前、および同期ヘルパー内でも、Task.isCancelled または try Task.checkCancellation() をチェックします。サスペンド中(AsyncSequenceのnext()など)の処理の場合は、withTaskCancellationHandler を使用します—そして、ハンドラーは本体と即座に並行して実行されるため、タッチする状態は実際の同期(アクターではなく、アトミックまたはロック—アクター上での順序付けは保証できません)を必要とすることを忘れないでください。

並行性を制限します。 無制限のリストのアイテムごとに1つの子タスクをファンアウトしないでください。N個の子タスクを開始し、その後さらに追加します。


6. プロトコルと存在型

抽象化のデフォルトは具体的な型です。 プロトコルは、複数の型にわたって繰り返されるコードがある場合にのみ使用します。

  • some P( opaque result type / ジェネリックパラメータ)は、デフォルトのポリモーフィズムツールです。コンパイル時のディスパッチ、値型のサポート、オーバーヘッドなし。 型消去(any P)は、ストレージに異種性がある場合、またはリフレクションが必要な場合にのみ使用します。
  • any Pはボックスです。 ヒープ割り当て、参照カウント、動的ディスパッチを使用します。some Pが必要ない場所でany Pを使用しないでください。
  • someとanyの区別は意味的です。 someは「この関数は特定の1つの型を返します」と言います。anyは「型は異なる可能性があります」と言います。戻り値の型にanyを使用すると、動的ディスパッチが発生しますが、someは静的な型のままにします。
  • プロトコルにassociatedtypeまたはSelf要件がある場合、それはジェネリックパラメータとしてのみ使用できます(some P)。 any Pは使用できません。
  • anyは常に16ワードを使用します(値が収まらない場合はヒープ割り当て)。プロトコルは自立型ブリッジングを使用してこれに対処します。
  • プロトコルは最小限にします。 単一の要件を持つ小さなプロトコルが最適です。大きなプロトコルは、多くの場合、複数の小さなプロトコルに分割できます。
  • EquatableとHashableは自動合成されます—すべての格納プロパティがそれらに準拠している場合。
  • Codableも同様に合成されます が、CodingKeys列挙型を追加して、エンコード/デコード方法をカスタマイズできます。

7. ジェネリクス(some vs any)

  • some Pは、具体的な型を非公開にしながら使用できます。 関数が特定のP準拠型を返すが、その型を非公開にしたい場合に使用します。
  • ジェネリック関数は、最も一般的な形式です: func foo<T: P>(_ t: T)。some Pは糖衣構文であり、まったく同じ意味を持ちます。
  • any Pは型消去であり、異種コレクションに役立ちます: let items: [any P] = [A(), B()]。同じ抽象化の下で異なる型を持つことができる場合に使用します。
  • some Pを戻り値の型として使用する場合、関数は毎回同じ具体的な型を返さなければなりません。異なる可能性がある場合は、戻り値の型にany Pを使用します。
  • someとanyを切り替えることは、パフォーマンスと柔軟性のトレードオフです。 具体的な型がわかっている場合はsomeを使用し、異種性が必要な場合はanyを使用します。

8. ARCとメモリ管理

  • ARCは自動的ですが、サイクルには注意してください。 弱参照(weak)または所有権なしの参照(unowned)を使用して、クロージャとデリゲート内の強参照サイクルを断ち切ります。
  • weakは実行時コストがかかります。 参照はオプショナルとして扱われ、ARCは参照先のオブジェクトが解放されたときにnilに設定します。
  • unownedは、参照先のオブジェクトが自分より長く生きることを確信している場合に使用します。 安全上の理由から、weakを好みます。
  • クロージャは、キャプチャリスト([weak self]、[unowned self])を使用して、キャプチャされた値を明示的に管理します。
  • コピーオンライト は、大きな値型のコストを効率的に管理するための主要なツールです。

9. Swift Testing

  • import Testing を使用します。 XCTest よりも優先されます。
  • @Test でテストをマークします。 非同期テストはデフォルトでサポートされています。
  • アサーションには #expect を使用します。 これは XCTAssertEqual などを置き換えます。
  • テストを整理するには @Suite を使用します。 スイートはネストでき、タグでフィルタリングできます。
  • パラメータ化されたテストには @Test(arguments:) を使用します。
  • withKnownIssue を使用して、既知の問題をマークします。
  • #expect(throws:) を使用して、エラーがスローされることをテストします。

10. マクロ

  • マクロはコンパイル時にコードを生成します。 定型コードを削減するために使用します。
  • @freestanding(expression) マクロ は式を生成します。
  • @attached マクロ は、型や関数にコードを追加します。
  • マクロを実装するときは、SwiftSyntax を使用します。
  • @main を使用してマクロをエクスポートします。
  • マクロのターゲットには @main を使用します。

11. パッケージ管理

  • Package.swift を使用して依存関係を管理します。
  • swift-tools-version: を最新の安定版に設定します。
  • ターゲットには targets: を使用します。
  • dependencies: を使用して外部パッケージを追加します。
  • products: を使用して、ライブラリや実行可能ファイルを定義します。
  • swiftSettings: を使用して、コンパイラフラグと設定を構成します。

12. パフォーマンス

  • プロファイリングは推測の代わりになります。 Instruments を使用して、問題が発生している場所を特定します。
  • 値型は参照型よりもはるかに安価です。 値型はヒープ割り当てが不要で、スレッドセーフです。
  • ContiguousArray は、参照型の配列に Array よりも効率的です。
  • some P は any P よりも高速です。 これは動的ディスパッチを回避します。
  • 弱参照は実行時コストがかかります。 weak の使用を最小限にします。
  • @inlinable を使用して、モジュール境界を越えてコードをインライン化します。
  • @_exported を使用して、モジュールを再エクスポートします。

Individual skills in this repo

This repo contains 13 individual skills — each has its own dedicated page.

CharbelElBateh/personal-website

Build animations in React Native and Expo, making the decisions in the order that determines whether they feel right — should it animate, which thread it runs on, which properties, spring or timing, how the gesture hands off, how it degrades. Writes the implementation with Reanimated, Gesture Handler, Expo Router and expo-haptics. Use when animating anything in an Expo app, adding gestures, sheets, screen transitions, press feedback or haptics, or fixing motion that stutters on device. For web animation use `animate`.

CharbelElBateh/personal-website

Build an animation from scratch, making the decisions in the order that determines whether it feels right — should it animate at all, what purpose, which tool, which properties, which curve and duration, how it interrupts, how it exits. Writes the implementation. Use when asked to animate something, add motion, make a component feel alive, or build a transition. For critiquing existing motion use review-animations; for auditing a whole codebase use improve-animations.

CharbelElBateh/personal-website

Reverse-lookup glossary that turns a vague description of a web animation or motion effect into its exact term ("the bouncy thing when a popover opens" → Pop in; "the iOS rubber-band scroll" → Rubber-banding). Use when the user asks "what's it called when…", or describes a motion effect without knowing its name and wants the right word to prompt an AI or designer with. For naming an effect, not designing or building one.

CharbelElBateh/personal-website

Apple's approach to interface design and fluid, physical motion, translated for the web. Use when building or reviewing gesture-driven UI, spring animations, drag/swipe/sheet interactions, momentum and interruptible transitions, translucent materials and depth, typography (optical sizing, tracking, leading), reduced-motion, or the design foundations (feedback, spatial consistency, restraint) behind Apple-style interfaces.

CharbelElBateh/personal-website

Guide to Sonner, the React toast library — install and wire up the Toaster, pick the right toast() call, promise and loading toasts, updating, dismissing and persisting toasts, styling, theming and icons, positioning and multiple toasters. Use when working with Sonner or troubleshooting it — toasts that don't appear, appear twice, lose their styles, ignore Tailwind classes, sit behind a modal, or don't follow dark mode.

CharbelElBateh/personal-website

Try to break a piece of UI by feeding it worst-case data — long names, unbreakable emails, one-letter names, missing fields, huge counts, zero items, long labels, non-Latin text, emoji, extreme numbers — then render it behind a "Demo data / Worst case" toggle and report everything that broke, with the fix for each. Use when the user asks to stress-test, break, or find edge cases in a component or screen, or to "try the worst case". For visual design critique use emil-design-eng; for motion use review-animations.

CharbelElBateh/personal-website

This skill encodes Emil Kowalski's philosophy on UI polish, component design, animation decisions, and the invisible details that make software feel great.

CharbelElBateh/personal-website

Search a codebase or UI for places that don't animate but should, and reject everything that shouldn't. Read-only; it proposes motion with exact values, it does not implement it. Use when the user asks "what could be animated here?" or wants to "make this feel more alive". For fixing existing animations, use improve-animations or review-animations instead.

CharbelElBateh/personal-website

Survey a codebase's animation and motion code as a senior motion advisor, then produce a prioritized audit and self-contained implementation plans for other agents (or cheaper models) to execute. Read-only on source code — it plans improvements, it does not apply them. Use when the user asks to "improve the animations", "audit the motion", "make this app feel better", or wants a roadmap of animation fixes rather than a review of a single diff.

CharbelElBateh/personal-website

Make a web app feel native on a phone — the small CSS and meta-tag fixes that separate "a website in a browser" from something that feels installed. Covers sticky hover states, tap highlight flashes, the 100vh bug, inputs that zoom the page, laggy taps, pull-to-refresh hijacking scroll, content under the notch, long-press selecting button text, carousels that scroll the wrong way, mismatched status bars, and the rule that you test on real hardware. Use when a web app is being built for or reviewed on mobile, when something "works in Chrome but feels wrong on my phone", when building a PWA, a bottom sheet, a carousel, a full-screen layout, or any touch interaction. For motion itself use animate; for React Native use animate-expo.

CharbelElBateh/personal-website

Pick the right library for a given frontend task from a curated, opinionated list — numbers, OTP inputs, charts, command menus, virtualization, drag and drop, toasts, state, styling, and more. Only runs when explicitly invoked; it does not trigger on its own.

CharbelElBateh/personal-website

Build multiple genuinely different versions of a UI piece you describe, rendered behind a visual picker so you can flip through them live and promote the one that feels right. Only runs when explicitly invoked; it does not trigger on its own.

CharbelElBateh/personal-website

Reviews animation and motion code against a high craft bar derived from Emil Kowalski's design engineering philosophy. Default to flagging; approval is earned.

関連スキル