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

Tóm tắt nhanh
Hallmark là một skill thiết kế cho Claude Code, Codex, Cursor và OpenCode, giúp trợ lý AI dựng trang web không mang dáng vẻ do máy sinh ra. Skill có 50 giao diện mẫu, tự kiểm tra trang bằng trình duyệt thật và có chế độ redesign, audit. Cài chỉ cần một lệnh npx, cần Node 18 trở lên.
Hallmark là một skill thiết kế dành cho Claude Code, Codex, Cursor và OpenCode. Nó dạy trợ lý AI dựng trang web theo cách người làm nghề sẽ dựng, thay vì cái kiểu quen thuộc mà ai nhìn cũng đoán ra là máy làm. Tác giả mô tả ngắn gọn: một skill thiết kế chống "AI slop" (thứ giao diện na ná nhau, vô hồn do AI sinh ra).
Bạn nên xem qua nếu bạn là chủ shop, người làm văn phòng hay lập trình viên mới và hay nhờ AI làm trang giới thiệu, trang bán hàng, trang đặt lịch. Ai từng thấy trang nào cũng có dòng chữ nhỏ viết hoa phía trên tiêu đề, một chữ tô màu trong câu tiêu đề, cuối trang lúc nào cũng có ô đăng ký email, thì sẽ hiểu Hallmark sinh ra để làm gì.
Điểm đáng giá nhất: Hallmark không chỉ "vẽ cho đẹp". Nó chạy kiểm tra trang trong một trình duyệt thật, ở nhiều độ rộng màn hình, rồi nhờ một người review độc lập (một subagent chưa biết gì về quá trình làm) chấm lần cuối. Repo hiện có khoảng 54.009 sao và 2.884 fork, dùng giấy phép MIT, và vẫn được cập nhật trong vài tháng gần đây.
Nutlope/hallmark
Skill thiết kế cho Claude Code, Codex, Cursor và OpenCode: dựng trang web đẹp, có chủ ý, tự kiểm tra trong trình duyệt để tránh dáng vẻ máy làm.
I.Hallmark làm được gì
Trước hết là bộ năm mươi giao diện (theme). Mỗi theme là một "chất liệu": giấy, kiểu chữ, màu, bề mặt, các thành phần riêng, kèm một hình trang hoàn chỉnh để bạn xem. Theme không quy định trang có những gì hay xếp thứ tự ra sao, nên hai yêu cầu khác nhau trong cùng một theme vẫn ra hai trang khác nhau. Ví dụ README liệt kê Dusk (đối soát ngân hàng), Cobalt (API webhook), Atelier (tiệm nước hoa) hay Hedgerow (xưởng chưng cất gin).
Thứ hai là dựng trang theo mục đích. Trang đặt lịch thì phải đặt được lịch, trang cửa hàng thì phải bán được hàng, bản tin thì phải đăng ký được. Nút hành động nằm đúng chỗ mà loại trang đó thường đặt, và trang kết thúc bằng chính hành động đó. Bạn đỡ phải sửa lại cái trang đẹp mà không ai biết bấm vào đâu.
Thứ ba là các cổng kiểm tra chia ba tầng:
- Floor (nền tối thiểu) thì không bao giờ được bỏ qua: độ tương phản, focus, giảm chuyển động, không bịa dữ kiện, bố cục điện thoại không được hỏng.
- Reflex là các thói quen mặc định của mô hình AI. Nếu có lý do, bản dựng được phép bỏ qua một cổng nhưng phải ghi lại.
- Finish là chi tiết tay nghề, không bao giờ chặn việc giao trang.
Thứ tư là chế độ Custom. Khi bạn nói "custom", Hallmark bỏ hết theme, chỉ giữ Floor, các cổng kiểm tra và một bản hướng dẫn ngắn để tìm ra một ý tưởng riêng cho khách hàng của bạn.
Thứ năm là dùng sản phẩm thật. Bạn trỏ nó tới một URL, một dev server hay một ứng dụng, nó tự chụp màn hình. Ngoài ra có thư viện 755 ảnh được cấp phép mở, chọn theo chủ đề và có ghi nguồn ngay trên trang. Thư viện này chỉ là danh sách ảnh trên Wikimedia Commons, không chứa file ảnh, và không dùng các trang ảnh stock như Unsplash, Pexels, Pixabay.
Cuối cùng là redesign và audit. Redesign dựng lại một trang có sẵn 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 lỗi, không sửa gì.
II.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 trong các công cụ AI được hỗ trợ: Claude Code, Codex CLI, Cursor, OpenCode (README cũng nhắc tới github-copilot trong tuỳ chọn cài).
- Nếu muốn kiểm tra bằng trình duyệt (
sloplint --render, chụp màn hình): cần thêm góipuppeteer-corecài toàn cục và trình duyệt Chrome. Không có hai thứ này thì các kiểm tra tĩnh vẫn chạy.
README không nói gì về yêu cầu hệ điều hành, phần cứng hay API key riêng cho Hallmark. Chi phí dùng AI tuỳ vào công cụ bạn đang dùng (Claude Code, Codex…), chuyện đó nằm ngoài repo này.
III.Cài đặt từng bước
- Kiểm tra NodeChắc chắn máy có Node 18 trở lên
- Cài skillChạy một lệnh npx để cài Hallmark vào công cụ AI
- (Tuỳ chọn) Cài kiểm tra trình duyệtThêm puppeteer-core và Chrome
- Mở lại công cụ AIGọi thử /hallmark hoặc nói thẳng muốn dựng trang
A.Kiểm tra Node
Mở terminal (trên Windows là PowerShell hoặc Windows Terminal, trên Mac là Terminal) rồi gõ:
node -vNếu ra số phiên bản từ 18 trở lên là ổn. Nếu báo không tìm thấy lệnh, bạn cần cài Node trước rồi mới làm tiếp.
B.Cài skill bằng npx
Đây là cách chính trong README:
npx skills add nutlope/hallmark -gCờ -g nghĩa là cài cho mọi dự án trên máy. Bỏ -g đi thì skill chỉ cài vào thư mục dự án bạn đang đứng, nên nếu dùng cách này hãy mở terminal đúng trong thư mục dự án. Theo README, skill sẽ nằm ở ~/.claude/skills/hallmark (Claude Code) hoặc ~/.agents/skills/hallmark (Codex CLI); Cursor và OpenCode tự tìm thấy các bản này.
Muốn cài cho đúng một công cụ:
npx skills add nutlope/hallmark -g --agent claude-codeThay claude-code bằng codex, opencode, cursor hoặc github-copilot tuỳ công cụ bạn dùng.
C.Cách khác: cài như plugin Claude Code
Nếu bạn dùng Claude Code và thích cài qua plugin, gõ hai lệnh này bên trong Claude Code:
/plugin marketplace add nutlope/hallmark
/plugin install hallmark@hallmarkCài theo cách này thì bạn gọi skill bằng /hallmark:hallmark.
D.Cách khác: cài từ bản clone
Cách này hợp với người muốn xem mã hoặc đóng góp. Lệnh install sẽ kiểm tra mọi theme và tài liệu tham chiếu trước khi chép vào máy:
git clone https://github.com/Nutlope/hallmark.git
cd hallmark
node skills/hallmark/scripts/install.mjsREADME 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 file này trong thư mục skills/hallmark/scripts/ của repo.
E.Cài thêm phần kiểm tra bằng trình duyệt (tuỳ chọn)
npm i -g puppeteer-coreBạn cũng cần Chrome trên máy. Bước này không bắt buộc, bỏ qua vẫn dùng được Hallmark.
Hallmark là skill chạy bên trong công cụ AI của bạn. Mọi lượt dựng trang vẫn tính vào gói hoặc hạn mức của Claude Code, Codex hay Cursor mà bạn đang dùng. Hãy xem kỹ mức phí của công cụ đó trước khi bảo AI dựng cả loạt trang.
IV.Kiểm tra đã chạy được chưa
README không mô tả màn hình "cài thành công", nên mình đề xuất cách kiểm tra đơn giản dựa trên những gì tư liệu có:
- Xem thư mục skill đã tồn tại chưa:
~/.claude/skills/hallmarkvới Claude Code, hoặc~/.agents/skills/hallmarkvới Codex CLI. - Mở lại công cụ AI, gõ
/hallmark(Claude Code, Cursor, OpenCode) hoặc$hallmark(Codex CLI) rồi thêm yêu cầu. Nếu công cụ nhận ra skill, bạn đã cài xong. - Nếu skill không tự kích hoạt khi bạn mô tả yêu cầu, hãy gọi tên nó ra: use hallmark to build .... README ghi rõ cách này.
Với phần kiểm tra trình duyệt, bạn thử chạy trên một file HTML bất kỳ:
node skills/hallmark/scripts/sloplint.mjs <file-or-dir> --renderThay <file-or-dir> bằng đường dẫn file hoặc thư mục cần kiểm tra. Lệnh này cũng dùng được cho trang bạn không làm bằng Hallmark.
V.Dùng vào việc thật
README chủ yếu mô tả cách Hallmark làm việc, không đưa prompt mẫu. Các tình huống dưới đây là cách mình áp dụng đúng khả năng nó nêu ra; câu chữ prompt là mình tự đặt, bạn chỉnh theo nhu cầu.
A.Chủ shop cần một trang bán hàng
Bạn bán đồ thủ công và nhờ AI dựng trang. Trong Claude Code, bạn mô tả như thường, hoặc gọi tên cho chắc:
use hallmark to build a landing page for my handmade candle shopTheo README, Hallmark sẽ đọc dự án (font, bảng màu, framework), hỏi bạn một lần về tư liệu thật như ảnh và số liệu, rồi đề xuất ba theme hợp với yêu cầu. Nó dựng phần hero trước, kiểm tra riêng, rồi mới làm phần còn lại. Kết quả là một trang HTML và CSS tự đứng được, trang cửa hàng thì kết thúc ở hành động mua. Vì nó không bịa dữ kiện, bạn nên chuẩn bị sẵn giá, ảnh và mô tả thật.
Hallmark giữ một mức sàn cứng rồi tránh đường cho bạn.
Ông T
B.Lập trình viên mới muốn làm lại trang cũ
Bạn có một trang chạy được nhưng nhìn "máy móc". README cho lệnh redesign:
/hallmark redesign ./src/appBản redesign đầy đủ giữ nguyên nội dung và phần nối dây, chỉ đổi hệ thống thiết kế và bố cục. Nếu chỉ muốn đổi giao diện mà giữ bố cục, bạn nói keep the layout. Nếu chỉ muốn sửa các dấu hiệu lộ mùi AI, nói polish. Công cụ ghi lại mọi link, ô nhập, handler và tiêu đề trước khi sửa, và báo lỗi nếu sau đó có thứ bị mất. Cuối cùng bạn nhận bản so sánh trước và sau.
C.Nhân viên văn phòng muốn chấm điểm một trang có sẵn
Bạn chưa muốn sửa, chỉ muốn biết trang đang vướng gì. Dùng audit:
/hallmark audit ./index.htmlAudit chỉ báo cáo, không đụng vào file. Bạn có thể đưa danh sách lỗi này cho người thiết kế hoặc lập trình viên của mình. Muốn chạy kiểm tra thẳng bằng script thì dùng lệnh sloplint ở trên.
D.Làm trang theo ý riêng, không theo mẫu
Nếu 50 theme không hợp thương hiệu của bạn, hãy nói rõ chữ "custom":
use hallmark to build a custom page for my accounting studioHallmark bỏ theme và chỉ dựa vào prompt của bạn, dưới cùng các luật và cổng kiểm tra. Prompt càng cụ thể về khách hàng và điều khiến bạn khác biệt thì càng có lợi.
VI.Lỗi hay gặp và cách xử lý
Gõ npx báo không tìm thấy lệnh. Máy chưa có Node hoặc terminal chưa nhận Node. Cài Node 18 trở lên, đóng và mở lại terminal rồi chạy node -v kiểm tra.
Skill không tự chạy khi bạn mô tả yêu cầu. README đã lường trước: hãy gọi tên, ví dụ use hallmark to build ..., hoặc dùng /hallmark. Với Codex CLI thì dùng $hallmark. Nếu vẫn không thấy, mở lại công cụ AI và kiểm tra thư mục skill đã có chưa.
Cài bằng plugin mà gọi /hallmark không được. Với cách cài plugin, tên gọi là /hallmark:hallmark. Đây là chỗ người mới hay nhầm.
Lệnh --render không chạy được. Phần kiểm tra trình duyệt cần puppeteer-core cài toàn cục và Chrome. Thiếu một trong hai là lỗi. Cài đủ, hoặc tạm dùng các kiểm tra tĩnh vì chúng vẫn chạy được.
Cài bằng npx nhưng không thấy skill ở dự án khác. Có thể bạn đã bỏ cờ -g, khi đó skill chỉ nằm trong dự án bạn đứng lúc cài. Chạy lại với -g nếu muốn dùng ở mọi nơi.
VII.Có nên dùng không
Điểm mạnh. Hallmark không dừng ở giao diện đẹp mà có quy trình: đọc dự án, đề xuất theme, dựng hero riêng, kiểm tra ở nhiều độ rộng, rồi để người review độc lập có tiếng nói cuối. Bộ cổng kiểm tra chia tầng rõ ràng, nên nó chặt chỗ cần chặt (tương phản, focus, bố cục điện thoại) mà không bóp nghẹt phần tay nghề. Chế độ redesign có cơ chế bảo vệ để không làm mất link hay ô nhập. Giấy phép MIT, ảnh có ghi nguồn rõ ràng.
Giới hạn. Kết quả là trang HTML và CSS tự đứng, nên nếu dự án của bạn phụ thuộc nhiều vào framework riêng, bạn cần thử trước xem nó khớp đến đâu. README chưa nói gì về hỗ trợ hệ điều hành cụ thể, chưa có ví dụ prompt dài, và phần kiểm tra trình duyệt đòi cài thêm công cụ. Nó cũng không thay được việc bạn chuẩn bị nội dung thật: vì nó từ chối bịa số liệu, bạn phải cung cấp.
Khi nào chọn cách khác. Nếu bạn chỉ cần sửa vài dòng CSS, dùng skill này là hơi nặng. Nếu bạn muốn một công cụ kéo thả không cần AI, đây không phải thứ đó. Còn nếu bạn đã dùng Claude Code, Codex, Cursor hoặc OpenCode và thấy trang AI làm ra cứ giống nhau, Hallmark đáng để cài thử vì chỉ tốn một lệnh.
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 dùng, sửa và phát hành lại được. Tuy nhiên skill chạy bên trong công cụ AI như Claude Code hay Codex, và chi phí của các công cụ đó tuỳ gói bạn đang dùng. Tư liệu không nói gì thêm về phí.
Hallmark cài trên Windows được không?
README không ghi yêu cầu hệ điều hành cụ thể. Điều kiện duy nhất được nêu là Node 18 trở lên cho lệnh cài. Chưa có thông tin riêng về Windows, bạn nên tự thử và xem trang repo nếu gặp vấn đề.
Có cần GPU hay máy cấu hình mạnh không?
Tư liệu không nhắc tới yêu cầu GPU hay phần cứng. Phần kiểm tra bằng trình duyệt cần Chrome và puppeteer-core, còn việc dựng trang do công cụ AI bạn dùng đảm nhận.
Hallmark khác gì việc nhờ AI làm trang như bình thường?
Hallmark thêm một quy trình cố định: chọn theme từ 50 mẫu, dựng trang theo mục đích, kiểm tra bằng trình duyệt thật ở nhiều độ rộng và có người review độc lập. Nó cũng chủ động loại bỏ các dấu hiệu quen thuộc của trang do AI làm, như dòng nhãn viết hoa trên tiêu đề hay ô đăng ký email ở cuối mọi trang.
Hallmark có hỗ trợ công cụ nào?
README ghi Claude Code, Codex CLI, Cursor và OpenCode. Lệnh cài còn có tuỳ chọn --agent cho github-copilot. Cách gọi hơi khác nhau: Claude Code, Cursor, OpenCode dùng /hallmark, còn Codex CLI dùng $hallmark.
Tôi đã có sẵn một trang web, Hallmark sửa được không?
Được, nếu bạn gọi tên rõ ràng. Lệnh /hallmark redesign dựng lại trang nhưng giữ nội dung và phần nối dây, còn /hallmark audit chỉ báo cáo lỗi mà không sửa. Hallmark không tự động động vào thiết kế có sẵn nếu bạn không nêu tên.
Ảnh trên trang do Hallmark làm lấy từ đâu?
Theo README, Hallmark dùng thư viện 755 ảnh được cấp phép mở, lưu trên Wikimedia Commons, và ghi nguồn từng ảnh ngay trên trang. Nó không dùng các trang ảnh stock như Unsplash, Pexels hay Pixabay.


