AI エージェントに Web UI や LP を生成させていると、いつの間にか「紫からピンクへのグラデ」「見出しは全部イタリック」「3 カラムのフィーチャーグリッド」といった、いかにも生成物らしい見た目に収束していきます。単体では悪くないのに、複数ページ並べた瞬間に「AI っぽい」と分かってしまう——この現象は近年 "AI slop" と呼ばれ、UI 領域でも急速に問題視され始めています。
自社サービスの見た目品質を、社内デザインシステムを持たないまま底上げしたいエンジニアにとって、既存の Claude Code 用スキルカタログや Cursor rules を寄せ集めても解決しづらい領域です。個別の「良いプロンプト」ではなく、生成の各段階に組み込まれるガードレールが必要になります。
本記事では、GitHub で公開されている OSS Nutlope/hallmark が、この課題にどうアプローチしているかを、公式リポジトリ・公式サイト・SKILL.md といった一次情報のみを根拠に整理します。動作検証は行わず、あくまでドキュメントの読み解きに徹します。
本記事を読むことで、「自プロジェクトに Hallmark を採用すべきか」「隣接する類似 OSS とどう違うか」「継続採用に耐えるメンテナンス状況か」を判断できるようになることを目的とします。
Hallmark とは何か
Hallmark は、Anti-AI-slop design skill for Claude Code, Cursor, and Codex. という一言で説明される OSS です(GitHub リポジトリの description より)。AI コーディングエージェントに UI を生成させたとき、「AI 生成らしい」テンプレ的な見た目に陥ることを、スキル(skill)というエージェント拡張の仕組みで防ぐことを目的としています。公式サイト usehallmark.com では、実際に Hallmark で生成されたページのライブサンプル群を閲覧できます。
リポジトリの基本情報
以下は執筆時点で gh api /repos/Nutlope/hallmark から取得したメタデータです。
項目 | 値 |
|---|---|
owner/name | Nutlope/hallmark |
description | Anti-AI-slop design skill for Claude Code, Cursor, and Codex. |
stargazers_count | 11,141 |
forks_count | 553 |
language(主要言語) | CSS |
license | MIT |
visibility | public |
archived | false |
fork | false |
disabled | false |
pushed_at | 2026-06-26 |
archived=false かつ fork=false であり、独立したアクティブなリポジトリとして扱われています。最終 push が 2026 年 6 月であることから、少なくとも執筆時点では継続的にメンテナンスされている状態です。約 1.1 万スターと 500 超の fork を集めており、コミュニティ側の関心も相応に高いといえます。
開発元と位置づけ
Hallmark は、Nutlope アカウント(Together AI に所属する Hassan El Mghari 氏によって運営されている GitHub アカウント)から公開されています。過去に同アカウントからは llamacoder などの LLM × フロントエンド系プロジェクトが公開されており、Hallmark も「LLM が生成する UI の質」という文脈上に位置づけられます。
Hallmark 自身は Node パッケージや React コンポーネントではなく、エージェントに読み込ませるルール集(SKILL.md と references/ 配下の参照ドキュメント群)としてパッケージングされています。したがって「実行環境」は Claude Code / Cursor / Codex 側であり、Hallmark 単体で動くわけではない、という点が最初の理解ポイントになります。
Hallmark が向き合う「AI slop」とは
Hallmark を理解するには、まず何を「悪い出力」とみなしているかを押さえる必要があります。
AI 生成デザインの典型的な失敗パターン
Web の UI 領域における AI slop は、たとえば以下のような形で観測されます。
- 明るい紫からピンクへ流れるグラデーションの多用
- ヒーロー → 3 フィーチャーグリッド → CTA → フッター、という同一リズムの反復
- 見出しに斜体(italic)を使うことで「デザインしている風」を演出する癖
- 実在しない指標(「導入企業 3 倍」「読み込み 47% 高速化」など)を装飾として書き込む
- モックアップとして偽のブラウザ URL バーやスマートフォン枠を「描いてしまう」
- インライン CSS で
oklch(...)などのカラー値を即興で埋め込み、トークンシステムを壊す
これらは個別に見れば些細な癖でも、複数ページに横展開されると「AI が書いた」と一目で分かる強いシグナルになります。
Hallmark が定義する 6 つのアンチパターン
SKILL.md は、すべての動詞(後述)に共通で適用される "universal disciplines" として、次の 6 項目を挙げています(skills/hallmark/SKILL.md より)。
- Fabricated content(捏造メトリクス・偽の証言の禁止)
- Token improvisation(トークンを介さないインライン色指定の禁止)
- Redrawn UI chrome(偽ブラウザバー・偽端末枠の禁止)
- Unverified mobile responsiveness(320 / 375 / 414 / 768 px での検証を要件化)
- Italic headers(見出しは常に upright、
font-style: normal) - Mid-render deviation(描画途中でロック済みデザインシステムから逸脱しないこと)
自プロジェクトで「AI 生成にありがちで避けたい癖」がこの 6 つと重なるほど、Hallmark 導入の費用対効果は高くなります。逆に、既に十分なデザインシステムがあり、上記のような癖がそもそも生じない環境では、Hallmark の主要バリューは薄まります。
4 つの動詞(build / audit / redesign / study)
Hallmark のインターフェースは、エージェントに対する 4 つの「動詞」に集約されています。以下は SKILL.md の記述をもとに整理したものです。
動詞 | 主な用途 | 出力形式 |
|---|---|---|
(default)build | 新規 UI をゼロから生成 | HTML/CSS 一式 + |
| 既存コードのアンチパターン監査 | 編集なし。改善指摘の punch list(順位付き) |
| 既存の実装境界を保ったまま視覚構造を刷新 | コンテンツと意図を保持したまま刷新された UI |
| 参照デザインの "DNA" 抽出 | macrostructure / archetypes / type-pairing / color anchor などの diagnosis 報告 |
build(新規生成)
デフォルトの動詞です。ユーザーが「〜を作って」と依頼した場合に発火し、後述する Design Flow に沿って、事前スキャン → macrostructure 選択 → テーマ選択 → ルール読み込み → プレビュー → 実装 → slop-test というパイプラインを走らせます。
audit(監査)
既存コードに対して発火する動詞で、SKILL.md に「Read the target, score it against the anti-pattern list, return a ranked punch list. Do not edit.」と定義されています(SKILL.md より)。
コードを書き換えず、ランク付きの改善指摘だけを返す点が特徴です。既存デザインシステムを尊重したまま「AI slop 度合いを可視化するチェッカー」として使えます。CI に組み込む発想ではなく、エージェント越しに定期的に自己点検させる想定です。
redesign(再デザイン)
SKILL.md は redesign を「Take the target's content and intent, then redesign the visual structure inside the existing implementation boundaries unless the user explicitly confirms a full rebuild.」と説明しています(SKILL.md より)。
内容とコンポーネント境界を保ったまま、視覚レイヤーだけを差し替えるための動詞です。--mood オプションで美的方向性を指示できます。「文言や情報構造は変えたくないが、見た目だけ雰囲気を変えたい」というリニューアル要件に対応します。
study(参照デザインからの学習)
URL やスクリーンショットを与えると、そのデザインの macrostructure、archetypes、タイポグラフィのペアリング、カラーアンカーといった「DNA」を抽出し、diagnosis 報告として返します(SKILL.md より)。
重要なのは、SKILL.md の記述上、ピクセル単位の複製は目的としない点です。参照サイトのビジュアル言語の要素分解にとどめ、後段の build と組み合わせて別コンテンツに転写する使い方を想定しています。
構造要素(macrostructure・20 テーマ・58 の slop-test ゲート)
Hallmark の中身を「ただの巨大プロンプト」ではないものにしているのが、以下の 3 つの構造要素です。
macrostructure — 21 種の名前付きページ形状
macrostructure は「見出し配置・本文構成・仕切り言語・ボタンボイス・画像処理などを包括的にコード化した、名前付きのページ形状」です。SKILL.md によれば 21 種が用意されており、例として Marquee Hero、Bento Grid、Long Document、Manifesto などが挙げられています(SKILL.md より)。
さらに Diversification rule: subsequent picks must differ from the previous three; Specimen is no longer a default.(SKILL.md より)というルールがあり、連続してビルドしても直近 3 回と同じ macrostructure が選ばれないよう強制されます。「ヒーロー → 3 カラム → CTA」の反復に陥りづらいのは、この多様化ルールに支えられているためです。
20 テーマ + Custom(tuned / bespoke)
配布されるスキルには 20 種のカタログテーマが同梱されています。SKILL.md は次のようにジャンル分けを示しています(SKILL.md より)。
- Atmospheric: Bloom / Midnight / Terminal / Aurora / Lumen
- Modern-minimal: Coral / Cobalt
- Playful: Hum
- Editorial: 残り 12 テーマ
これに加え、ブリーフにブランドカラー指定・複合的な美的属性の指示・「独自のトーンで」といった明示的な要求が含まれる場合は Custom テーマが発火します。Custom テーマは 2 段階の深さを持ちます。
- tuned: 既存の macrostructure に対して、OKLCH ベースのパレットと無料フォントペアリングだけを差し込むモード
- bespoke: 構造そのものをブリーフに合わせて再設計するモード
いずれのモードでも、後述の slop-test ゲートを通過する必要があります。カスタムテーマの詳細ルールは Custom テーマ仕様書(custom-theme.md) にまとまっています。
58 の slop-test ゲートと pre-emit self-critique
Hallmark で特徴的なのは、生成物を返す前に必ず通過するガード群です。SKILL.md の「Design Flow」ステップ 7 は次のように定義されています。
Before handing back, run the output through the 58-gate slop test in references/slop-test.md. Every answer must be no.
(出典: Hallmark SKILL.md)
ゲート項目としては、「invented metrics / testimonials」「mid-render token improvisation(inline OKLCH の埋め込み)」「italic headers」「fake UI chrome」「tag-left / heading-right の 2 カラムパターン」などが列挙されています(SKILL.md より)。
さらに、universal disciplines の 1 つとして Pre-emit self-critique on six axes (Philosophy, Hierarchy, Execution, Specificity, Restraint, Variety); anything < 3 triggers revision. が定義されており、6 軸のうちいずれかが 3 未満のスコアになると自動的にリビジョンが走る仕組みになっています(SKILL.md より)。
出力コードには次のようなコメントがスタンプされ、どの macrostructure・トーン・アンカー hue で生成したかが記録されます。
/* Hallmark · macrostructure: <name> · tone: <tone> · anchor hue: <hue> */
(出典: Hallmark SKILL.md)
より実運用に踏み込んだレシピ集は docs/recipes.md にまとまっており、「マーケサイトを 1 セッションで組む」「既存のダッシュボードを redesign する」などの具体的な流れが紹介されています。
インストールと 3 環境(Claude Code / Cursor / Codex)への配置
導入手段としては、公式が用意しているワンライナーが README に示されています。
npx skills add nutlope/hallmark
(出典: Nutlope/hallmark README)
README では、上記コマンドが自動的に対象エージェント(Claude Code / Cursor / Codex)を検出して適切なパスに配置するとされていますが、手動で配置する場合の対応関係も明示されています(README より)。
- Claude Code:
~/.claude/skills/hallmark/にSKILL.mdとreferences/を配置 - Cursor:
.cursor/rules/hallmark.mdcとして、SKILL.mdの本文のみを(YAML frontmatter を除いて)配置 - Codex: 個人スコープなら
~/.codex/skills/hallmark/、プロジェクトスコープなら.codex/skills/hallmark/
Cursor だけ frontmatter を除く点は、後から手動同期する場合の注意ポイントです。CI やチーム標準の設定管理スクリプトに乗せる場合、この差分を吸収する仕組みが必要になります。
なお、Hallmark 自体は Node パッケージを実行するわけではなく、単にファイル群を各エージェントの設定ディレクトリに置くだけの構成です。導入後に何が変化するかは、SKILL.md の内容をエージェントがどう解釈するかに依存するため、そのエージェント側の仕様(Claude Code の skills 機構、Cursor の rules、Codex の skills)を並行して理解しておく必要があります。
類似リポジトリとの比較
Hallmark を採否判断するにあたっては、隣接する「エージェント向けスキル集」との違いを整理しておく必要があります。ここでは代表的な 3 つのリポジトリを取り上げます。
Leonxlnx/taste-skill との違い
同じ「AI コーディングエージェントが生成する UI の量産化(slop)を抑える」という課題領域には、Leonxlnx/taste-skill という別のスキルも存在します。当サイトでも AI 生成 UI の量産化を防ぐ「Taste Skill」が選ばれる理由 で詳しく取り上げていますが、Hallmark と Taste Skill は同じ課題を扱いつつも、制御方式の思想が大きく異なります。
- 制御方式: Taste Skill は「DESIGN_VARIANCE(レイアウトの実験度)」「MOTION_INTENSITY(アニメーションの量)」「VISUAL_DENSITY(情報密度)」という 3 つの数値ダイヤルを介して、生成される見た目のトーンをブリーフ側で連続的に指示するアプローチ。Hallmark は 20 テーマ + Custom(tuned / bespoke)というカタログから離散的にトーンを選び、生成物を返す前に 58 個の slop-test ゲートで機械的に落とすアプローチ
- チェックの決定論性: Taste Skill は生成物に対するダイヤル値の再現性を重視。Hallmark は「invented metrics」「italic headers」「fake UI chrome」など個別のアンチパターン単位で通過/不通過を判定するため、「AI っぽさが混入したかどうか」を局所的に確定できる
- カバー範囲: Taste Skill はランディングページ・ポートフォリオといった実装テンプレを含む 11 スキル構成。Hallmark はマクロ構造(21 種)とテーマ(20 種)の組み合わせによる汎用的な UI 生成に軸足を置く
- 選定軸: 「ブリーフ側で連続的な調整をしたい」なら Taste Skill、「アンチパターン単位で明示的にゲートを掛けたい」なら Hallmark
両者は competitor というより、選好する制御スタイルの違いです。ダイヤル的な調整に馴染むエンジニアと、ルール集による静的なガードに馴染むエンジニアで、選ばれる側が変わります。
alirezarezvani/claude-skills との違い
alirezarezvani/claude-skills は、Claude Code をはじめとする複数エージェント向けに、355 スキル・18 ドメインをまとめた大規模なスキル集です。エンジニアリング・マーケティング・C レベルのアドバイザリなど、業務領域を横断的にカバーしています。
Hallmark との差は、次のように整理できます。
- カバー領域: claude-skills は業務全般の道具箱。Hallmark は「AI 生成 UI の見た目品質」というひとつの垂直領域に絞り込み、macrostructure / テーマ / slop-test ゲート / self-critique を統合した完成度の高いフローとして提供する
- UI/UX の深さ: claude-skills 側にもランディングページ生成や UI リサーチなどのスキルはあるが、Anti-AI-slop に特化した多段パイプラインは持たない
- 選定軸: 「業務全般をエージェントに任せられる箱を作りたい」なら claude-skills、「AI 出力の見た目品質を単独で本気で上げたい」なら Hallmark
両者は競合というより、併用しても矛盾しない補完関係にあります。
wondelai/skills との違い
wondelai/skills は、62 スキル(うち 50 が書籍・フレームワーク由来、12 がメタスキル)で構成されるスキル集です。Refactoring UI・Clean Code・Jobs to Be Done などの原則書をベースにした知識モジュールを、エージェントに読み込ませる形で提供しています。
Hallmark との違いを整理すると次の通りです。
- 切り分け方: wondelai/skills は「書籍・原則」単位でスキルを分割し、必要な原則を個別に呼び出す前提。Hallmark は「新規生成→ゲート→自己批評」までの生成フローを 1 つのスキルに閉じ込め、動詞 4 つで呼び出せる
- 設計哲学: wondelai/skills は原則を参照させる知識ベース寄り。Hallmark は原則をルールとして手続き的に強制するランタイムガード寄り
- 選定軸: 「UX/デザインの原則を、エージェントを介して知識として参照したい」なら wondelai/skills、「エージェントの UI 出力そのものを、Anti-AI-slop の観点でワンショット制御したい」なら Hallmark
こちらも本質的には併用可能で、「原則ベースの知識モジュール」と「生成時の強制ガード」の役割分担で考えると分かりやすくなります。
選定フロー
以上を踏まえると、次のような分岐で判断できます。
- 同じ AI-slop 対策で「ダイヤル的なトーン調整」を優先したい → Taste Skill を先に検討し、必要に応じて Hallmark と併用
- 業務全体を包括する道具箱を優先したい →
alirezarezvani/claude-skills中心、その上で Hallmark を UI 領域だけ差し込む - 書籍・原則ベースの知識をエージェントに持たせたい →
wondelai/skills中心、そこに Hallmark を加えて生成物のガードを追加 - とにかく「AI が出す UI」の見た目をアンチパターン単位で体系的に整えたい → Hallmark を単体で導入し、上記は必要が生じた段階で足す
導入判断のチェックリスト
裏テーマである「自プロジェクトに採用すべきか」を判断するための観点をまとめます。以下の条件に多く該当するほど、Hallmark 導入のコスト対効果は高くなります。
採用が向く条件
- Claude Code / Cursor / Codex いずれかで、UI(HTML / CSS)を日常的にエージェントに生成させている
- LP・ドキュメントサイト・マーケサイトなど、静的な Web ページや軽量な UI が主戦場である
- 生成された UI が「AI 生成らしい」と評価されがちで、社内やクライアントから改善要望が出ている
- 既存の社内デザインシステムが未整備、または属人的で共通のガードが機能していない
- 上記「6 つのアンチパターン」の少なくとも半数以上に、日常的な悩みとして心当たりがある
採用が向かないケース
- React / Next.js の複雑な SPA を丸ごと生成させる用途がメインで、UI 単体の見た目より状態管理・データフェッチ側の品質が支配的
- 既に成熟した社内デザインシステム(トークン設計・コンポーネントカタログ・状態設計)が整備されており、その規約に反する挙動を許容できない
- 生成対象がバックエンド・CLI・データ処理系で、そもそも Hallmark のスコープ外
導入コスト自体は「ファイル配置+エージェント側の skills / rules を有効化」だけと軽いため、まずは監査(audit)だけ回してみて、punch list の内容から自プロジェクトとの相性を測る、という段階的な採用も現実的です。
まとめ
Hallmark は、AI コーディングエージェントの UI 出力品質という、これまで明確な担当が置かれてこなかった領域に「反 AI-slop」というコンセプトで切り込む OSS です。プロンプト集ではなく、macrostructure → テーマ → 58 の slop-test ゲート → pre-emit self-critique という多段パイプラインとして設計されている点が、隣接する skills 系リポジトリとの決定的な差になります。
執筆時点のメタデータ(archived=false / fork=false / MIT ライセンス / 最終 push 2026-06-26 / 約 1.1 万スター)から見ると、少なくとも短中期の採用に対して大きな懸念は見当たりません。次の一歩としては、公式サイト usehallmark.com でライブサンプルの傾向を確認し、Nutlope/hallmark リポジトリと SKILL.md、そして docs/recipes.md を読み比べて、自プロジェクトのユースケースにどの動詞(build / audit / redesign / study)から当てるのが有効かを見定めるのが良い順序です。



