Zilmac 部落格
← 返回技術實踐

Hallmark 能幹什麼?讓 Claude Code 自動優化 AI 生成的網頁,安裝後就能直接用

API 與 Agent ·約 10 分鐘閱讀

Mac 上 Claude Code 終端執行 Hallmark Skill 優化 AI 生成落地頁設計

讓 Claude Code「寫个落地頁」,十有八九會交出同一套 AI 审美:六宮格圓角卡片、漸變主按鈕、標題裡單独上色一个词、底部再来一个郵箱訂閱框。功能也许齊全,但一眼就像模板站。Hallmark(作者 @nutlope,usehallmark.com)是 2026 年 GitHub 上热度很高的 Agent Skill:專門教 Claude Code、Codex、Cursor 等客戶端按設計規則寫網頁,並在真瀏覽器裡用 sloplint 自檢「AI slop」,直到問題清零。本文說明它能幹什麼、怎麼一行命令裝好就用,以及如何與你在 Zilmac 上跑的 Claude Code 工作流銜接;若你還在挑 Skills,可先看Claude Code Skills 2026 推薦清單。

48+
內建主題(v2 先推 3 套供你選)
3
核心用法:新建 · audit · redesign
0 FAIL
sloplint --render 多寬度瀏覽器驗收目標

Hallmark 是什麼?解决哪類問題?

Hallmark 不是又一个 UI 組件庫,而是一份遵循 Agent Skills 標準的 SKILL.md 工作流:在 Agent 寫 HTML/CSS 之前先選主題、定版式,在寫寫完之後用 linter 抓典型「AI 味」——低對比度字疊在圖上、並排兩個實心主按鈕、該放照片的位置卻鋪漸變、標題 tracked 大寫標籤等。官方站點對比过:同一 prompt 下,裸 Opus 頁面常帶二十多處問題,走 Hallmark 主題後可壓到 0 issue(以 sloplint 計數為準)。

它和「多寫幾句 design system prompt」的差別在于:流程被寫死進 Skill——問素材、發主題、生成 tokens.css、Hero 優先、再跑瀏覽器渲染檢查。你不需要每次對話重複設計规范。

Hallmark 能幹什麼:三條主路徑

從零寫落地頁

在 Claude Code 裡輸入 /hallmark 加產品描述即可。Skill 會先讀項目(字體、色板、框架),只問一次真實素材:截圖、用戶數、定價、受眾。然後從你 prompt 裡 deal 出 3 套主題(48+ 主題庫中匹配),你選定後再寫頁面。沒有截圖时它會明說不會編造數字,用佔位图代替。

/hallmark 为 [產品名] 做落地頁,访客唯一動作是 [预約演示 / 下载 App]。
用我提供的截圖 URL,數字只使用我给出的。

只審計、不改檔案

已有 AI 生成的 index.html 但不敢動?用 audit 只出報告:

/hallmark audit ./index.html

典型輸出是 sloplint 的 FAIL/WARN 列表(社區實測單頁可達 40+ FAIL),方便你決定是自己改還是走 redesign。

保留内容與邏輯,重做視覺

對「能跑但很醜」的站點最實用:保留文案、連結、表單欄位與腳本掛載,重建視覺層:

/hallmark redesign ./src/app

或指向靜態目錄 / 單檔案。Skill 不會在你沒提 redesign / audit 時擅自改已有設計,因此裝全局 Skill 也相對安全。

Claude Code 終端中 Hallmark Skill 執行 sloplint 瀏覽器檢查與落地頁主題選择示意
v2 強調「先設計再編碼」:主題 tokens、版式與 sloplint 瀏覽器驗收是同一套閉環,而不是事後補 CSS。

從一句话到可上线頁面:Skill 內部流程

根據官方 Skill 與 usehallmark.com 說明,一次完整構建大致經歷:

  1. Pre-flight:掃描仓庫裡的設計 token、design.md、現有 CSS 變數。
  2. 素材询問:照片、App 截圖、真實指标;缺則占位,禁止虛構 KPI。
  3. 主題 deal:輸出 3 个候選(名稱、字體、色板、是否適合你的產品調性);也可要求 custom 完全按 prompt 自由設計,仍受同一套 linter 約束。
  4. Scaffold:生成 tokens.css、base.css,顏色與間距進 token,避免 Agent 隨手寫 magic number。
  5. 構建:先 Hero,再按「落地頁任務」排區塊順序——每页區塊順序可以不同,避免千篇一律六卡片。
  6. 驗收:sloplint --render 在 Chrome 多寬度渲染;失敗则 Agent 自行修到 0 FAIL,再做一輪「 fresh eyes」審查。

配圖預設來自 Wikimedia Commons 等開放許可图庫,頁內會署名;也可選 API key 接其他圖源,但不裝 key 也能用。

安裝后就能用:Node、Skill、瀏覽器檢查

前置:Node.js ≥ 18(node -v)。安裝 Skill(-g 表示所有項目可用):

npx skills add nutlope/hallmark -g

僅給某一客戶端:

npx skills add nutlope/hallmark -g --agent claude-code
npx skills add nutlope/hallmark -g --agent codex

推薦再裝瀏覽器自檢依賴(本機需 Chrome / Chromium):

npm i -g puppeteer-core

不裝 puppeteer 會怎样?

仍會做靜態 sloplint 檢查,但缺少多視口真實渲染,移動端對比度、焦点环、疊字問題可能漏檢。寫對外行銷页时建議裝全。

裝完無需改後端:Skill 落在 ~/.claude/skills/hallmark(Claude Code)或 Codex 的 ~/.agents/skills/hallmark;Cursor 會讀取已安裝副本,會话裡直接 /hallmark …。更新 Skill 时重新執行 npx skills add 即可。

Claude Code、Cursor、Codex 怎麼喚起

客戶端典型安裝位置喚起方式
Claude Code~/.claude/skills/hallmark/hallmark <需求>
Codex CLI~/.agents/skills/hallmark$hallmark <需求>
Cursor / OpenCode讀取上述路徑/hallmark <需求>

若你同時在 Cursor 裡寫 Swift、在 Claude Code 裡改靜態站,可把 Hallmark 当作只負責 marketing HTML 的 Skill,與代码庫 Skills(發版、测试)分開,避免 discovery 阶段 skill 過多——治理思路與Skills 推薦文一致。

不會亂改現有站:邊界與素材規則

  • 預設只作用於你指定的路徑;普通對話不會重寫整站 CSS。
  • 不編造事實:沒有的数据就佔位,避免 AI 落地頁常見的假「10 萬用戶」。
  • 可跟現有 design system:Skill 會先讀你的 token 與 design.md,再決定是 deal 主題還是 custom。
  • App 截圖:可給 URL 或本地工程,Skill 可启動應用自行截圖(需你環境能跑起來)。

Mac / 雲端開發機上的習慣

Hallmark 的瀏覽器驗收依賴本機 Chrome 與 Node 全局包。在 Zilmac 一類持久 home 的雲端 Mac上,建議:

  1. 把 ~/.claude/skills 放在持久卷,避免執行個體重建后 Skill 遺失。
  2. 在仓庫内用 .claude/skills 固定 Hallmark 版本,團隊 PR 審核後再合併。
  3. CI 若只部署靜態 frontend/,Hallmark 生成物仍走常規 git 流程;無需改後端 或 FossBilling。

常見問題

Hallmark 需要單独買 API Key 嗎?

不需要。開放許可图庫即可出图;可選配置图片 API。頁面生成仍走你 Claude / Cursor 已有模型訂閱。

和 Tailwind / shadcn 衝突嗎?

Hallmark 常輸出帶 design token 的靜態 HTML/CSS,也可讀你現有 token。若項目是 React,redesign 時需明確「只改样式層、不動路由與資料流」。

audit 和 redesign 怎麼選?

只想評估 AI 味、做 backlog → audit。頁面結構 OK 但視覺丢人 → redesign。從零且願意選主題 → 直接 /hallmark 新建。

裝好后 Claude Code 沒認出 /hallmark?

確認 npx skills add 成功、重啟會话,并檢查 ~/.claude/skills/hallmark/SKILL.md 是否存在;Cursor 需使用支援 Agent Skills 的版本。

小結:Hallmark 讓 Claude Code 在寫網頁时帶上「設計品味」和可驗證的 sloplint 門檻——一行安裝,/hallmark 新建、audit 體檢、redesign 救場。把它和團隊 Skills、MCP 分工清楚,比在 prompt 裡重複「不要 AI 風格」更省事。

限時優惠

Zilmac

雲端 Mac、遠端開發與 Mac VPS,為 iOS 與跨平台團隊補齊 Apple 工具鏈。

返回首頁
限時優惠 點擊查看方案