close

Hallmark

Mã nguồn mở bởi Nutlope

Hallmark là skill thiết kế cho Claude Code, Codex, Cursor và OpenCode, do Together AI làm. Skill dựng trang web từ một kho 50 theme, rồi tự soát kết quả trên trình duyệt thật để loại các dấu hiệu khiến trang trông như do AI tạo.

Hallmark dùng để làm gì?

  • Dựng trang web HTML và CSS từ một câu mô tả, chọn trong ba theme mà skill đề xuất
  • Soát trang đã dựng ở tám độ rộng màn hình bằng sloplint để bắt các dấu hiệu thiết kế kiểu AI
  • Thiết kế lại một trang có sẵn bằng /hallmark redesign mà vẫn giữ nội dung, link và form
  • Kiểm tra một trang và chỉ nhận báo cáo bằng /hallmark audit
  • Chèn ảnh thật có giấy phép mở từ Wikimedia Commons kèm ghi công tác giả trên trang

Giao diện

Ảnh và video lấy từ README của dự án trên GitHub, bản quyền thuộc nhóm phát triển.

Cần biết trước khi dùng

  • Lưu ýRepo chưa có bản phát hành (release) chính thức: phiên bản cài đặt là mã mới nhất trên nhánh chính.
  • Lưu ýKhông tìm thấy docker-compose hay Dockerfile ở thư mục gốc: chưa thể gắn nút Deploy tự động.
  • Lưu ýDependency được khai báo theo khoảng phiên bản (ví dụ ">="), chưa tra lỗ hổng tự động được. Cần quét trên bản cài thật.
  • Lưu ýTino chưa kiểm thử dự án này.

Kiểm tra tự động ngày 21/11/2026 từ dữ liệu GitHub, OSV.dev và docker-compose. Đây không phải chứng nhận bảo mật; Tino không phát triển hay bảo trì repo này.

Hallmark là gì?

Hallmark nhắm vào hiện tượng trang web do AI tạo thường giống nhau. README liệt kê các dấu hiệu skill tìm và chặn: dòng chữ nhỏ phía trên mọi tiêu đề, nhãn viết hoa giãn chữ, một từ tô màu trong tiêu đề, trang toàn khung trống hoặc toàn ảnh, phần hero không vừa màn hình, ô đăng ký email ở cuối mọi trang, form báo cảm ơn nhưng không gửi gì.

Các cổng kiểm tra chia ba tầng. Floor là mức sàn không bao giờ được vi phạm: độ tương phản, trạng thái focus, giảm chuyển động, thông tin bịa, bố cục vỡ trên điện thoại. Reflex là các thói quen mặc định của model; một bản dựng có lý do được phép bỏ qua và phải ghi lại. Finish là chi tiết hoàn thiện, không chặn việc xuất bản.

Bản v2 có 50 theme. Mỗi theme là một chất liệu gồm giấy, kiểu chữ, màu, bề mặt, component và texture riêng, nằm trong một file không quá 8 KB; theme không quy định trang chứa gì hay theo thứ tự nào, nên hai đề bài trên cùng theme cho ra hai trang khác nhau. Trang được dựng theo việc khách cần làm: trang đặt lịch thì đặt lịch, trang bán hàng thì bán hàng. Nếu nói custom, skill bỏ theme và thiết kế chỉ từ đề bài, vẫn theo cùng luật và các bước kiểm tra.

Một lượt dựng gồm bốn bước. Bước đầu đọc dự án (font, bảng màu, framework, file design.md đã khoá) và hỏi một lần về tư liệu như ảnh, ảnh chụp màn hình, số liệu thật; README ghi skill không tự bịa nội dung. Tiếp theo scripts/theme.mjs đề xuất ba theme. Phần hero được dựng riêng và soát trước. Cuối cùng scripts/sloplint.mjs --render kiểm tra trang ở tám độ rộng, rồi một subagent với ngữ cảnh mới soát lại. Mỗi trang là HTML và CSS độc lập, có ghi các quyết định thiết kế trong comment CSS đầu tiên.

Hallmark không động vào thiết kế đã có trừ khi bạn chỉ đích danh. Khi redesign, sloplint --before ghi lại mọi link, trường nhập, handler và tiêu đề; sloplint --kept báo lỗi nếu thiếu một mục nào sau khi làm lại. Mã nguồn theo giấy phép MIT; thư viện 755 ảnh chỉ là danh sách trỏ tới Wikimedia Commons, mỗi ảnh giữ giấy phép riêng.

Nên dùng khi

  • Bạn cần dựng nhanh landing page, trang giới thiệu, trang đặt lịch hoặc trang bán hàng bằng coding agent và không muốn kết quả giống mẫu AI quen thuộc
  • Bạn có một trang đã chạy và muốn thiết kế lại mà không mất nội dung, link, form
  • Bạn muốn một công cụ soát tự động các lỗi nền tảng như tương phản, focus, bố cục trên điện thoại trước khi xuất bản
  • Bạn có sẵn tư liệu thật (ảnh, ảnh chụp sản phẩm, số liệu) để đưa cho skill

Không nên dùng khi

  • Bạn không muốn agent chạy script trên máy: skill gọi các file Node.js như theme.mjs, sloplint.mjs, và install-hook.mjs thêm một hook kiểm tra vào Claude Code
  • Máy không cài được Chrome và puppeteer-core: khi đó chỉ còn các kiểm tra tĩnh, phần soát trên trình duyệt và chụp màn hình không chạy
  • Bạn cần component cho một design system có sẵn trong ứng dụng lớn: README mô tả kết quả là trang HTML và CSS độc lập, không nêu việc sinh component theo framework
  • Bạn không thể ghi công ảnh trên trang: ảnh lấy từ Wikimedia Commons theo CC0, phạm vi công cộng, CC BY hoặc CC BY-SA, hai loại sau buộc ghi công và CC BY-SA có điều kiện chia sẻ tương tự
  • Bạn muốn giữ nguyên thiết kế hiện tại và chỉ cần sửa vài chi tiết nhỏ: lệnh redesign thay cả hệ thống và bố cục, cần nói rõ keep the layout hoặc polish để giới hạn phạm vi
  • Bạn cần thương hiệu riêng tuyệt đối nhất quán: theme được chia ngẫu nhiên từ kho 50 theme, cần khoá bằng design.md hoặc dùng chế độ custom

Tính năng chính

  • 50 theme, mỗi theme một file tối đa 8 KB trong references/themes/ kèm ảnh trang mẫu
  • Chế độ custom: bỏ theme, thiết kế từ đề bài theo hướng dẫn trong direction.md
  • Ba tầng cổng kiểm tra: Floor (không được vi phạm), Reflex (được bỏ qua nếu có lý do ghi lại), Finish (không chặn)
  • sloplint.mjs --render soát trang ở tám độ rộng trên trình duyệt thật; không có trình duyệt thì chạy kiểm tra tĩnh
  • Subagent với ngữ cảnh mới soát lại lần cuối
  • /hallmark redesign giữ nội dung và phần nối dây, kèm so sánh trước, sau; /hallmark audit chỉ báo cáo
  • Tự chụp màn hình sản phẩm thật từ URL, dev server hoặc ứng dụng
  • Danh sách 755 ảnh giấy phép mở từ Wikimedia Commons, chọn theo chủ đề và ghi công trên trang
  • Cài được cho Claude Code, Codex CLI, Cursor, OpenCode, GitHub Copilot; có dạng plugin Claude Code
  • Giấy phép MIT

Cách cài đặt Hallmark

  1. Cài skill cho mọi dự án -g cài cho mọi dự án; bỏ -g để chỉ cài vào dự án hiện tại. Cần Node 18 trở lên. Với Claude Code, skill nằm ở ~/.claude/skills/hallmark; với Codex CLI ở ~/.agents/skills/hallmark.
    npx skills add nutlope/hallmark -g
  2. (Tuỳ chọn) Cài cho một agent Thay claude-code bằng codex, opencode, cursor hoặc github-copilot.
    npx skills add nutlope/hallmark -g --agent claude-code
  3. (Tuỳ chọn) Bật phần soát trên trình duyệt Cần thêm Chrome trên máy. Thiếu hai thứ này thì sloplint --render và chụp màn hình không chạy, các kiểm tra tĩnh vẫn chạy.
    npm i -g puppeteer-core
  4. (Cách khác) Cài như plugin Claude Code Gõ trong Claude Code, sau đó chạy /plugin install hallmark@hallmark. Khi cài kiểu này, skill được gọi bằng /hallmark:hallmark.
    /plugin marketplace add nutlope/hallmark
  5. (Cách khác) Cài từ bản clone Script kiểm tra mọi theme và file tham chiếu trước khi chép. install-hook.mjs thêm bước kiểm tra Floor vào Claude Code mỗi khi sửa file.
    node skills/hallmark/scripts/install.mjs

Lệnh chép từ README của dự án. Đọc kỹ trước khi chạy và đối chiếu với README mới nhất, vì lệnh có thể đổi theo phiên bản.

Cách tích hợp và sử dụng

  1. Dựng trang mớiTrong Claude Code, Cursor hoặc OpenCode gõ /hallmark kèm mô tả; trong Codex CLI gõ $hallmark kèm mô tả. Cũng có thể chỉ mô tả trang cần dựng. Nếu skill không tự kích hoạt, nói rõ: use hallmark to build ...
  2. Đưa tư liệu thậtSkill hỏi một lần về ảnh, ảnh chụp màn hình và số liệu thật. Có thể trỏ tới URL, dev server hoặc ứng dụng để skill tự chụp màn hình sản phẩm.
  3. Chọn theme hoặc customSkill đề xuất ba theme hợp với đề bài. Nói custom nếu muốn thiết kế không dựa trên theme.
  4. Thiết kế lại trang có sẵnGõ /hallmark redesign ./src/app. Thêm keep the layout để chỉ đổi kiểu dáng, hoặc polish để chỉ sửa các dấu hiệu kiểu AI. Kết quả kèm so sánh trước và sau.
  5. Chỉ kiểm traGõ /hallmark audit ./index.html để nhận báo cáo, không sửa gì. Có thể chạy thẳng node skills/hallmark/scripts/sloplint.mjs --render trên bất kỳ trang nào.

Cập nhật và sao lưu

README không nêu lệnh cập nhật; cách chắc chắn là chạy lại lệnh cài để lấy bản mới.

Không có dữ liệu cần sao lưu ngoài các trang đã dựng và file design.md của dự án. Mỗi trang ghi các quyết định thiết kế trong comment CSS đầu tiên.

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

Hallmark có tự sửa giao diện đang có của dự án không?

Không, trừ khi bạn chỉ đích danh. README ghi skill không bắt đầu trên một thiết kế đã tồn tại nếu bạn không gọi redesign hoặc audit kèm đường dẫn.

Ảnh trong trang lấy từ đâu, có dùng thương mại được không?

Ảnh lấy từ danh sách 755 ảnh trên Wikimedia Commons, mỗi ảnh có giấy phép riêng: CC0, phạm vi công cộng, CC BY hoặc CC BY-SA. Skill ghi công trên trang. Bạn vẫn nên kiểm tra giấy phép từng ảnh, nhất là CC BY-SA, trước khi dùng cho sản phẩm thương mại.

Không cài Chrome thì Hallmark còn dùng được không?

Được. Theo README, thiếu puppeteer-core và Chrome thì các kiểm tra tĩnh vẫn chạy; chỉ phần soát trên trình duyệt ở tám độ rộng và chụp màn hình bị bỏ.

Hai lần chạy cùng một đề bài có ra cùng một trang không?

Không chắc. Skill chia ba theme từ kho 50 theme và theme không quy định bố cục, nên kết quả có thể khác nhau. Muốn giữ ổn định, dùng file design.md đã khoá trong dự án.

Hallmark có cần API key của Together AI không?

README không nhắc tới API key nào. Skill chạy bên trong agent bạn đang dùng và dùng model của agent đó.

Ứng dụng liên quan

Miễn trừ trách nhiệm

Tino không phát triển, không sở hữu và không liên kết với Hallmark hay nhóm phát triển Nutlope. Tên, logo và nhãn hiệu thuộc về chủ sở hữu tương ứng; việc nhắc tới chỉ để mô tả, không có nghĩa là dự án xác nhận hay hợp tác với Tino.

Hallmark được phân phối theo giấy phép MIT của nhóm phát triển. Tino không bảo đảm về tính năng, bảo mật hay mức độ phù hợp của phần mềm; bạn tự chịu trách nhiệm khi cài đặt, cấu hình và sử dụng.

Lệnh cài và thông tin trên trang lấy từ tài liệu công khai của dự án tại thời điểm cập nhật và có thể đã thay đổi. Đọc tài liệu chính thức và sao lưu dữ liệu trước khi chạy trên máy chủ thật.