# Hallmark: skill thiết kế web không lộ mùi AI cho Claude Code — hướng dẫn cài đặt và dùng

> Hallmark là một skill thiết kế dành cho Claude Code, Codex, Cursor và OpenCode, giúp AI dựng trang web không mang dáng vẻ máy làm. Skill có 50 chủ đề giao diện, bộ kiểm tra tự động và chế độ redesign/audit cho trang có sẵn. Cài bằng một lệnh npx, cần Node 18 trở lên.

- Tác giả: Ông T (https://ongt.vn/gioi-thieu)
- Chủ đề: Repo & Skill
- Đăng: 2026-05-17 · Cập nhật: 2026-11-14
- URL: https://ongt.vn/bai-viet/hallmark-skill-thiet-ke-web-khong-lo-mui-ai

Hallmark là một skill thiết kế cho Claude Code, Codex, Cursor và OpenCode. Nó bắt AI dựng trang web theo một bộ quy tắc chặt, để kết quả không còn cái dáng quen thuộc của trang do máy làm. Repo hiện có khoảng 54.000 sao và 2.900 fork, giấy phép MIT.

Vấn đề nó giải quyết rất dễ thấy. Bạn nhờ AI làm một trang giới thiệu, và trang nào ra cũng na ná nhau: dòng chữ nhỏ viết hoa nằm trên mỗi tiêu đề, một chữ tô màu trong tiêu đề lớn, khung ảnh trống, ô đăng ký email ở cuối mọi trang, form báo "cảm ơn" mà chẳng gửi đi đâu. Hallmark liệt kê những dấu hiệu đó, rồi kiểm tra trang trong trình duyệt thật để bắt chúng.

Ai nên dùng? Chủ shop, người làm marketing, freelancer hay lập trình viên mới đang nhờ AI dựng landing page, trang đặt lịch, trang bán hàng. Điểm đáng giá nhất là: bạn không phải biết thiết kế, skill tự chọn chủ đề phù hợp, tự kiểm tra, và còn có một người "đọc duyệt" độc lập ở bước cuối.

```repo
- repo | Nutlope/hallmark
- kind | Skill
- desc | Hallmark là skill thiết kế cho Claude Code, Codex, Cursor, OpenCode: dựng trang web theo 50 chủ đề và tự kiểm tra để trang không trông như AI làm.
- stars | 54k
- lang | CSS
- license | MIT
```

## Hallmark làm được gì

### Năm mươi chủ đề giao diện

Mỗi chủ đề là một "chất liệu": giấy, kiểu chữ, màu, bề mặt, thành phần riêng và kết cấu, kèm một ảnh trang hoàn chỉnh để tham khảo. Chủ đề không quy định trang có gì hay xếp theo thứ tự nào, nên hai yêu cầu khác nhau trong cùng một chủ đề vẫn ra hai trang khác nhau. README nêu vài ví dụ như Dusk, Cobalt, Studio, Atelier, Ribbon, Furrow, Dose, Refract, Vantage, Hedgerow.

### Dựng trang theo đúng việc của nó

Trang đặt lịch thì để người xem đặt lịch, trang bán hàng thì bán, trang bản tin thì đăng ký. Nút hành động nằm đúng chỗ mà loại trang đó thường đặt, và trang kết thúc ngay ở hành động đó. Bạn bớt được kiểu trang nào cũng kết bằng ô nhập email.

### Chế độ custom

Nói "custom" thì Hallmark bỏ hết chủ đề có sẵn. Nó chỉ giữ lại các quy tắc nền, các cổng kiểm tra và một bản hướng dẫn ngắn (`direction.md`), rồi thiết kế riêng từ yêu cầu của bạn. Mục tiêu là tìm một ý tưởng chỉ khách hàng này có và để nó dẫn cả trang.

### Dùng sản phẩm thật của bạn

Bạn trỏ nó vào một URL, một máy chủ dev hoặc một ứng dụng, và nó tự chụp ảnh màn hình để dùng. Skill cũng có thư viện 755 ảnh được cấp phép mở, chọn theo chủ đề và ghi nguồn ngay trên trang. Ảnh đặt trên Wikimedia Commons, README nói rõ skill không dùng các trang ảnh stock như Unsplash, Pexels, Pixabay.

### Ba tầng kiểm tra

- **Floor (nền):** không bao giờ được vượt, gồm độ tương phản, focus, giảm chuyển động, số liệu bịa và giao diện điện thoại bị vỡ.
- **Reflex (phản xạ):** những thói quen mặc định của mô hình. Nếu có lý do, bản dựng được phép bỏ qua và ghi lại.
- **Finish (hoàn thiện):** chi tiết thủ công, không bao giờ chặn việc giao trang.

### Redesign và audit

Với trang đã có, `redesign` dựng lại nhưng giữ nội dung và phần nối dây (link, ô nhập, xử lý sự kiện). `audit` chỉ báo cáo, không sửa gì.

## Cần chuẩn bị gì

Theo README, bạn cần:

- **Node 18 trở lên** để chạy lệnh cài.
- Một công cụ AI lập trình được hỗ trợ: Claude Code, Codex CLI, Cursor hoặc OpenCode. Danh sách khi chọn từng công cụ còn có `github-copilot`.
- **Nếu muốn kiểm tra bằng trình duyệt thật** (`sloplint --render`, chụp ảnh màn hình): cài thêm `puppeteer-core` toàn cục và có Chrome. Không có thì các kiểm tra tĩnh vẫn chạy.

README không nhắc đến API key riêng, GPU hay hệ điều hành cụ thể cho skill này. Bạn vẫn cần tài khoản/gói của công cụ AI mà bạn đang dùng, vì skill chạy bên trong công cụ đó.

## Cài đặt từng bước

```steps
- Mở terminal | Mở cửa sổ dòng lệnh trên máy có Node 18 trở lên
- Chạy lệnh cài | Dùng npx skills add để đưa skill vào công cụ AI
- Cài thêm trình duyệt kiểm tra | Tuỳ chọn: puppeteer-core và Chrome để kiểm tra bằng trình duyệt thật
- Gọi skill | Gõ /hallmark hoặc mô tả trang cần dựng
```

### Mở terminal và kiểm tra Node

Trên Windows, bạn mở PowerShell hoặc Terminal. Trên Mac, mở ứng dụng Terminal. Lệnh `node --version` là lệnh phổ thông để xem phiên bản Node, bạn cần thấy số 18 trở lên.

```bash
node --version
```

### Cài skill cho mọi dự án

Đây là lệnh chính trong README. Cờ `-g` nghĩa là cài toàn cục, dùng được ở mọi dự án. Bỏ `-g` thì skill chỉ nằm trong thư mục dự án hiện tại, nên nhớ mở terminal đúng thư mục dự án nếu bạn chọn cách này.

```bash
npx skills add nutlope/hallmark -g
```

Skill sẽ nằm ở các chỗ sau tuỳ công cụ: Claude Code vào `~/.claude/skills/hallmark`, Codex CLI vào `~/.agents/skills/hallmark`. Cursor và OpenCode tự tìm các bản sao đó.

### Chỉ cài cho một công cụ

Nếu chỉ dùng một công cụ, thêm cờ `--agent`. README liệt kê các giá trị: `claude-code`, `codex`, `opencode`, `cursor`, `github-copilot`.

```bash
npx skills add nutlope/hallmark -g --agent claude-code
```

### Hoặc cài như plugin của Claude Code

Trong Claude Code, gõ hai lệnh sau. Với cách này, bạn gọi skill bằng `/hallmark:hallmark`.

```bash
/plugin marketplace add nutlope/hallmark
/plugin install hallmark@hallmark
```

### Hoặc cài từ bản clone

Cách này hợp với người muốn đọc code trước. Lệnh `install.mjs` kiểm tra hợp lệ mọi chủ đề và tài liệu tham chiếu rồi mới sao chép. README còn nhắc `install-hook.mjs` để thêm bước kiểm tra Floor mỗi khi sửa file trong Claude Code, nhưng không ghi cách chạy chi tiết, bạn xem trong thư mục `skills/hallmark/scripts/` của repo.

```bash
git clone https://github.com/Nutlope/hallmark.git
cd hallmark
node skills/hallmark/scripts/install.mjs
```

### Thêm trình duyệt kiểm tra (tuỳ chọn)

Bước này cho phép kiểm tra giao diện ở nhiều độ rộng màn hình và chụp ảnh. Bạn cần cài Chrome riêng.

```bash
npm i -g puppeteer-core
```

```note
Skill này chạy kiểm tra và chụp trang bằng trình duyệt trên máy bạn. Nếu bạn trỏ nó vào một ứng dụng hay trang nội bộ, hãy chắc đó là thứ bạn được phép chụp và chia sẻ.
```

## Kiểm tra đã chạy được chưa

README không mô tả một màn hình "cài thành công" cụ thể. Bạn tự kiểm tra bằng các cách dưới đây, đều dựa trên những gì README nói.

Cách một: xem thư mục skill đã xuất hiện chưa. Với Claude Code là `~/.claude/skills/hallmark`, với Codex CLI là `~/.agents/skills/hallmark`.

Cách hai: mở công cụ AI và gõ `/hallmark` (Claude Code, Cursor, OpenCode) hoặc `$hallmark` (Codex CLI). Nếu skill nhận lệnh, bạn đã cài xong.

Cách ba: nếu skill không tự kích hoạt khi bạn mô tả một trang mới, hãy gọi tên nó thẳng. README gợi ý câu: *use hallmark to build ...*.

Sau khi dựng thử một trang, bạn có thể tự chạy bộ kiểm tra từ bản clone:

```bash
node skills/hallmark/scripts/sloplint.mjs <file-or-dir> --render
```

Thay `<file-or-dir>` bằng đường dẫn file HTML hoặc thư mục của bạn. Nếu chưa cài puppeteer-core và Chrome, bỏ `--render` để chạy các kiểm tra tĩnh.

## Dùng vào việc thật

### Chủ shop cần trang đặt lịch cho tiệm

Bạn có một tiệm làm tóc nhỏ và muốn một trang để khách đặt lịch. Mở Claude Code trong thư mục dự án và nhờ nó. Câu lệnh mẫu:

```
use hallmark to build a booking page for a small hair salon
```

Theo README, trước khi dựng, skill đọc dự án rồi hỏi một lần về tư liệu: ảnh, ảnh chụp màn hình, số liệu thật. Nó không bịa. Sau đó nó đưa ra ba chủ đề hợp với yêu cầu để bạn chọn. Vì là trang đặt lịch, hành động đặt lịch nằm đúng chỗ và trang kết thúc ở đó. Kết quả là một trang HTML và CSS độc lập, có dòng chú thích đầu phần CSS ghi lại các quyết định thiết kế.

> Hallmark giữ một mức sàn cứng rồi tránh đường cho bạn.
>
> — Ông T

### Lập trình viên mới muốn "làm sạch" trang đã có

Bạn đã nhờ AI làm một trang và thấy nó giống hệt mọi trang khác. Hãy chạy một bản audit trước, vì nó chỉ báo cáo chứ không sửa gì:

```
/hallmark audit ./index.html
```

Bạn nhận được danh sách các dấu hiệu máy làm mà nó bắt được. Nếu muốn sửa, dùng lệnh redesign. README nói rõ: redesign đầy đủ giữ nội dung và phần nối dây, đổi hệ thống và bố cục. Nói *keep the layout* thì chỉ đổi phong cách, nói *polish* thì chỉ sửa các dấu hiệu.

```
/hallmark redesign ./src/app
```

### Dev cần chắc rằng redesign không làm mất chức năng

Bạn đang làm lại giao diện một app và sợ mất link hay ô nhập. README mô tả cơ chế bảo vệ: `sloplint --before` ghi lại mọi link, ô nhập, hàm xử lý và tiêu đề trước khi sửa, `sloplint --kept` báo lỗi nếu thiếu thứ nào. Bàn giao cuối cùng là bản so sánh trước và sau cạnh nhau. README không ghi chi tiết cách gõ hai cờ này, nên bạn xem tài liệu trong thư mục `docs/` hoặc `skills/hallmark/` của repo.

### Freelancer làm trang cho khách muốn "khác người"

Khách của bạn không muốn giống ai. Hãy nói thẳng từ khoá custom:

```
use hallmark to build a custom page for a family-run tea farm
```

Skill bỏ chủ đề có sẵn, chỉ giữ mức sàn, các cổng kiểm tra và hướng dẫn `direction.md`. Bạn nhận một trang xuất phát từ chính yêu cầu của bạn, vẫn qua kiểm tra ở tám độ rộng màn hình và vẫn được người đọc duyệt độc lập ở cuối.

## Lỗi hay gặp và cách xử lý

### Gõ /hallmark mà không có gì xảy ra

Có thể skill chưa nằm đúng chỗ, hoặc công cụ chưa nạp lại. Kiểm tra thư mục `~/.claude/skills/hallmark` hoặc `~/.agents/skills/hallmark`, rồi mở lại công cụ AI. Nếu vẫn không tự chạy khi bạn mô tả trang mới, gọi tên rõ: *use hallmark to build ...*.

### Cài bằng plugin nhưng gõ sai tên lệnh

Với cách cài plugin của Claude Code, README ghi lệnh gọi là `/hallmark:hallmark`, không phải `/hallmark`. Thử cả hai tuỳ cách bạn đã cài.

### Lệnh npx báo lỗi phiên bản Node

README yêu cầu Node 18 trở lên. Chạy `node --version`, nếu thấp hơn thì cập nhật Node rồi chạy lại.

### Kiểm tra với --render không chạy

Bước này cần `puppeteer-core` cài toàn cục và có Chrome. Nếu thiếu một trong hai, cài bổ sung. Chưa muốn cài thì dùng các kiểm tra tĩnh, README xác nhận chúng vẫn chạy.

### Cài xong ở dự án này nhưng dự án khác không thấy

Nếu bạn bỏ cờ `-g`, skill chỉ nằm trong dự án hiện tại. Chạy lại với `-g` để cài cho mọi dự án.

## Có nên dùng không

**Điểm mạnh.** Skill đặt ra các quy tắc cụ thể và kiểm tra bằng trình duyệt thật, chứ không chỉ dặn AI "làm đẹp hơn". Bạn có 50 chủ đề, chế độ custom, và hai đường cho trang có sẵn là audit và redesign. Ảnh có nguồn và được ghi công trên trang, giấy phép MIT thoải mái.

**Giới hạn.** Kết quả là trang HTML và CSS độc lập, README không nói về việc tích hợp vào framework cụ thể. Phần kiểm tra bằng trình duyệt cần cài thêm Chrome và puppeteer-core. Skill chạy trong công cụ AI nên chất lượng còn phụ thuộc vào công cụ và mô hình bạn dùng. Mỗi lần dựng, nó sẽ hỏi bạn tư liệu thật như ảnh và số liệu, nên bạn phải chuẩn bị chúng.

**Khi nên chọn cách khác.** Nếu bạn cần một ứng dụng web có nhiều tính năng phía máy chủ, hay một hệ thống thiết kế dùng chung cho cả công ty, đây có lẽ không phải công cụ chính. Nếu bạn chỉ cần một bố cục nhanh, không quan tâm trang có "mùi AI" hay không, một lời nhắc bình thường cho AI cũng đủ. Còn nếu bạn mệt vì trang AI nào cũng giống nhau, Hallmark đáng thử.

## Câu hỏi thường gặp

### Hallmark có miễn phí không?

Repo dùng giấy phép MIT, nên bạn được dùng, sửa và phát hành lại. Skill chạy bên trong công cụ AI như Claude Code, Codex, Cursor hay OpenCode, và chi phí của các công cụ đó tuỳ gói bạn dùng. README không nói gì thêm về chi phí.

### Hallmark có chạy được trên Windows không?

README không nêu hệ điều hành cụ thể. Yêu cầu duy nhất được ghi là Node 18 trở lên, còn lệnh cài là `npx skills add nutlope/hallmark -g`. Chưa có thông tin riêng về Windows, bạn nên thử và xem phần issue của repo nếu gặp lỗi.

### Hallmark hỗ trợ những công cụ AI nào?

Claude Code, Codex CLI, Cursor và OpenCode. Khi cài riêng cho một công cụ, README liệt kê thêm `github-copilot`. Cursor và OpenCode tự tìm các bản skill đã cài cho Claude Code và Codex.

### Có cần cài Chrome không?

Chỉ khi bạn muốn kiểm tra bằng trình duyệt thật (`sloplint --render`) hoặc chụp ảnh màn hình. Khi đó cần `npm i -g puppeteer-core` và Chrome. Nếu không có, các kiểm tra tĩnh vẫn chạy.

### Hallmark khác gì việc nhờ AI làm giao diện bình thường?

Nó ép AI theo một bộ quy tắc và kiểm tra lại bằng công cụ. Quy tắc nền không được vi phạm, một số thói quen mặc định của mô hình bị chặn, và một người duyệt với ngữ cảnh mới xem lại bản dựng. README cũng nói skill không bịa dữ kiện và hỏi bạn tư liệu thật trước khi dựng.

### Ảnh trên trang có vấn đề bản quyền không?

README nói thư viện ảnh liệt kê các ảnh trên Wikimedia Commons, mỗi ảnh giữ giấy phép riêng (CC0, phạm vi công cộng, CC BY hoặc CC BY-SA), và Hallmark ghi công mọi ảnh nó dùng trên trang. Nó không dùng các trang ảnh stock như Unsplash, Pexels, Pixabay.

### Skill có sửa trang đã có của tôi không?

Chỉ khi bạn gọi tên rõ. Hallmark không tự động đụng vào thiết kế đã có. Lệnh `redesign` dựng lại và giữ nội dung cùng phần nối dây, còn `audit` chỉ báo cáo mà không sửa.
