30秒でわかる emilkowalski/skills

  • ・何のリポジトリ? sonner・vaul の作者 Emil Kowalski が公開した、デザインとアニメーションの“センス”をAIに教える Agent Skill集(⭐42,448・2026-10-01時点・MIT)
  • ・何が変わった? 初出時の5本が13本に。最大の SKILL.md は write-swift(42,445バイト)で、重心はWebの外へ広がった
  • ・入れっぱなしの費用は? 常駐する frontmatter は13本合計で5,773バイト=約1,443トークン
  • ・どう使う? npx skills@latest add emilkowalski/skills で導入し、Claude Code / Cursor / Codex で横断利用
emilkowalski/skills の GitHub 公式リポジトリ画面。Skills for Design Engineers というキャッチとSkill群が並ぶ
emilkowalski/skills の公式リポジトリ。出典: emilkowalski/skills 公式リポジトリ

「AIにコードは書けても、“良いセンス(taste)”はない」。2026年3月に公開された emilkowalski/skills は、この一点を出発点にしています。作者はトースト通知ライブラリ sonner とドロワーUI vaul で知られるデザインエンジニア、Emil Kowalski 氏。Vercel と Linear で培った“UIを気持ちよくする”知見を、AIエージェントが参照できる Agent Skill に落とし込みました。

本質は「一人の専門家の美的判断を、AIが読み込める SKILL.md にした“センスの注入装置”」です。本記事では、2026-10-01 に clone した main(最終コミット d16ebe6・2026-09-24)を1本ずつ計測し直し、初出時の5本が13本になった現在地と常駐コストを解説します。Skillを置く環境づくりはClaude Code|2026年版・インストールからCLAUDE.md・Hooks・本番運用までの実装手引き、Agent Skills 形式の仕組みはClaude Skillsとは|「スキル=フォルダ」の仕組みと作り方・使い方を徹底解説にあります。

1. emilkowalski/skills(Emil Kowalski の skill)とは

GitHub の説明は「Skills for Designers and Engineers.」だけ。ここでの Skill は学習教材ではなく、Anthropic が定義する Agent Skills 形式のファイル群、つまりAIコーディングエージェントに読み込ませて振る舞いを変える知識パッケージです。

作者の Emil Kowalski(@emilkowalski)氏は、sonner と vaul の作者で、Vercel と Linear での実務経歴を持ち、アニメーション講座 animations.dev も運営しています。

2026-10-01 時点で ⭐42,448・Fork 2,411。初出時(2026-07-12)は ⭐10,133、前回更新時(2026-09-07)は ⭐35,878 で、3か月で4倍を超えました。ライセンスは MIT、リポジトリ作成は2026年3月16日です。導入はコミュニティ製インストーラ skills.sh 経由です。

npx skills@latest add emilkowalski/skills

最も大きく変わったのは中身の構成です。初出時に5本だった SKILL.md は、いま13本あります。

13 SKILLSSKILL.mdのバイト数

最大は Web ではなく write-swift

write-swiftSwift

42445

emil-design-eng設計哲学

27123

apple-designモーション原則

23036

animate-expoReact Native

17891

mobile-nativeスマホWeb

16838
出典: 2026-10-01 に clone した main(d16ebe6)を計測。13本の合計は198,894バイト

最大は write-swift の42,445バイトで、値型、Swift 6 の並行性、ジェネリクス、パフォーマンス、Swift Testing までを扱う純然たる Swift の規約でした。「デザインのセンスを注入するリポジトリ」という初出時の説明は、いまはそれだけでは足りません。

どのSkillがいつ追加されたかの個別の日付は未検証です。初出時に扱った5本との差分から「あとから増えた8本」と扱います。

2. なぜ「AIにセンスはない」のか

WHERE AI MISSESAIが外す材料選び

コードは動く、でもイージングと影を外す

AIの既定の選択

センスのある選択

AIの既定の選択: enter に ease-in

センスのある選択: enter は ease-out

AIの既定の選択: ベタ塗りのボーダー

センスのある選択: 半透明のやわらかい影

出典: emilkowalski/skills README(2026-10-01時点)

Emil 氏がエッセイ “Agents with Taste” で指摘するのは、コードが動くことと UI が良いことは別だ、という点です。ここでの“センス”は天賦の美的感覚ではなく、無数の小さな判断を正しい方向へ倒す力を指します。

READMEの例が分かりやすい。要素が現れる enter アニメーションでは、終わりが滑らかに減速する ease-out が自然ですが、エージェントは立ち上がりが遅く最後に急加速する ease-in を選ぶことがあります。影も同様で、半透明のやわらかい影が正解の場面でベタ塗りの枠線を置いてしまう。一つずつは些細でも、積み重なると UI は素人っぽく見えます。

核心は、これらの判断が運や才能ではなく専門性から来る、という主張です。READMEには「ここにあるSkillはすべてドメイン専門性の副産物だ。AIはそうした専門性を置き換えない、増幅する」とあります。

同じ問題意識を別の角度から扱うのがtaste-skillとは|AIが量産する”そっくりUIスロップ”を止めるアンチスロップ・スキルの設計思想と使い方です。あちらは似たUIの量産を止める方向、こちらは正しい材料の選び方を教える方向から入ります。

3. 13本の中身 — Webの5本と、あとから増えた8本

初出時の5本は、いまも中核です。

① emil-design-eng(設計哲学・675行/27,123バイト) は2番目に大きい本体です。中核の思想は3つ。「センスは訓練で身につく」「見えない細部は積み重なる」「美しさはレバレッジ」。UIコードのレビューでは必ず Before/After のMarkdown表を使うよう定めています。

② review-animations(厳格なレビュアー・121行+STANDARDS.md 187行) は、基本姿勢が「デフォルトは指摘。合格は勝ち取るもの」。disable-model-invocation: true で、明示的に頼まれたときだけ起動します。10の揺るがない基準は初出時から変わっていません。

・①動く理由を正当化できること
・②頻度に応じて強度を落とす(キーボード操作や1日100回超の操作には付けない)
・③enter/exit は ease-out、UIでの ease-in はブロック
・④UIのアニメーションは300ms未満
・⑤原点と物理的な正しさ(ポップオーバーはトリガー基点、scale(0) 禁止)
・⑥中断可能であること
・⑦transform / opacity のみ
・⑧prefers-reduced-motion を尊重
・⑨enter と exit の非対称
・⑩全体の調和(迷ったら消すのが最も強い一手)

③ improve-animations(110行+AUDIT.md+PLAN-TEMPLATE.md) は、コードベース全体を監査して優先度つきの発見表を出します。ソースは一切改変せず、正確なファイル・cubic-bezier・duration・feel check まで含む自己完結した実装計画を plans/ に書き出し、文脈を持たない安いモデルでも実行できる粒度にする設計です。

④ animation-vocabulary(逆引き用語集・182行) は「あの弾む感じ」を Pop in、「iOSのゴムみたいな戻り」を Rubber-banding と呼べるようにし、正しい言葉で指示できるようにします。

⑤ apple-design(291行) は WWDC 2018 “Designing Fluid Interfaces” などの原則を Web に翻訳します。モーションが現在値から始まり、ユーザーの速度を受け継ぎ、いつでも掴んで逆転できるとき“生きている”と感じる、という考えで、道具は spring です。

あとから増えた8本は次のとおりです。

Skill サイズ 役割
write-swift 42,445バイト・397行 Swift 6 の並行性・Swift Testing まで含む規約
animate-expo 17,891バイト+RECIPES.md React Native / Expo のジェスチャー・シート・ハプティクス
mobile-native 16,838バイト Webアプリをスマホでネイティブらしくする修正集(100vh、セーフエリアなど)
animate 11,860バイト+RECIPES.md アニメーションを曲線・時間・プロパティから作る
find-animation-opportunities 9,808バイト 動かす価値のある場所を探し、「動かすな」も言う
prototype 7,830バイト+PICKER.md 複数案を作り切替器で見比べる
pick-ui-library 4,790バイト 19ライブラリを5カテゴリで指名し、自作や放置パッケージを防ぐ
ask-sonner 7,233バイト+API.md 自作ライブラリ Sonner の取扱説明

初出時の「哲学・審判・計画・語彙・他流派の原則」という分担はそのままに、「実装・発見・比較・道具選び」と「ネイティブ側」の2軸が足された形です。似た方向ではdesigner-skillsとは|9プラグイン96スキルをClaude Codeに入れるデザインOSSが96スキルの物量で全般を扱います。emilkowalski/skills は13本のまま1本ずつを厚くする方向です。

4. 入れっぱなしの常駐コストを実測する

13本とも SKILL.md が本体で、先頭の YAML frontmatter に name と description を書きます。エージェントはまず description だけを読んで今のタスクに関係するかを判断し、関係するときだけ本文を読み込みます(プログレッシブ・ディスクロージャ)。「13本も入れたらコンテキストを食うのでは」という疑問を、実際に測りました。

RESIDENT COST入れっぱなしの費用

13本入れても常駐は約1,443トークン

1,443tok

常駐(frontmatter)

5,773バイト

49,724tok

本文を全部読んだ場合

198,894バイト

3本

自動起動を切ったSkill(13本中)

disable-model-invocation

出典: 2026-10-01 計測。トークンは tools/token_audit.py の近似(CJK 1字=1・ASCII 4字=1)
区分 実測 いつ読まれるか
frontmatter 13本ぶん 5,773バイト ≈ 1,443トークン 常時
SKILL.md 本文 13本ぶん 198,894バイト ≈ 49,724トークン 関係すると判断されたものだけ
参照ファイル5本 57,146バイト 本文がさらに必要とした時だけ

トークン数は tools/token_audit.py の近似(CJK 1字=1・ASCII 4字=1)で、tiktoken の実測ではありません。常駐は Skill 1本あたり約111トークン。本文まで全部読むと約5万トークンなので、description が起動スイッチを握っています。

参照ファイルの分離も効いています。review-animations は本体121行に対して STANDARDS.md が187行、animate は208行に対して RECIPES.md が324行、animate-expo は264行に対して RECIPES.md が385行で、本体より参照ファイルが大きいSkillが3本あります。

自動起動を切る disable-model-invocation: true は13本中3本(review-animations・prototype・pick-ui-library)。厳しい点検、複数案の作成、ライブラリの指名は、勝手に始まられると困る作業だからです。

5. emilkowalski/skills と superpowers・ponytail・caveman の違い

「エージェントに何を注入するか」で並べると、emilkowalski/skills の位置が見えます。

代表 注入するもの 系統
superpowers(obra/superpowers) 開発プロセスの規律・作法 プロセス規律
ponytail(DietrichGebert/ponytail) 最小限のコードを書く振る舞い コード最小化
caveman(JuliusBrussee/caveman) 出力スタイルの圧縮 トークン経済性
claude-skills(anthropics/skills) docx / pdf / pptx / xlsx など汎用の能力 汎用能力
emilkowalski/skills ドメインの“センス” 専門性・職人性

前の4つが働き方や能力に関わるのに対し、emilkowalski/skills は一人の専門家の美的判断そのものを注入します。注入する層が違うので競合ではなく重ねて使えます。13本の使い分けは次のとおりです。

・UIコンポーネントを設計・磨き込みたい → emil-design-eng
・アニメーションをゼロから作る → animate(React Native なら animate-expo)
・既存の動きを1本ずつ厳しく点検 → review-animations
・コードベース全体を底上げ → improve-animations
・どこを動かすべきか分からない → find-animation-opportunities
・動きを言葉にできない → animation-vocabulary
・Apple 的な操作感をWebで → apple-design
・スマホでネイティブらしく → mobile-native
・Swift を書く → write-swift
・ライブラリ選び → pick-ui-library
・複数案を並べて決めたい → prototype

常駐は13本で1,443トークンなので、迷ったら全部入れて、呼ぶときに選ぶ運用で構いません。

この記事の結論

  • ・5本から13本、198,894バイトに増え、最大の SKILL.md は Swift になった。Webアニメーションの心得集から、デザインエンジニアの仕事全域の判断基準へ広がっている
  • ・常駐は約1,443トークン(近似値)。description だけ先に読ませる設計と、本体より大きい参照ファイルの分離、自動起動を切る3本のおかげで、物量が増えても入れっぱなしのコストはほとんど増えない
  • ・「薄い本体+厚い参照+起動スイッチとしての description」という型は、自作Skillの設計にもそのまま使える

参照ソース