Hallmark: check your own site for the AI look, step by step

Hi, it's Ivo. Hallmark is a free design skill for Claude Code, Cursor and Codex. It was the number one repo on GitHub trending on 27 October 2026, with over 37,000 stars. It can build pages in 48 themes, but the part I'd start with builds nothing. /hallmark audit reads a page you already have and tells you what makes it look AI-made. It doesn't change your page. Here is how to run it on your own site.

What it is

• Name: Hallmark, by Nutlope (Together AI). MIT licence.
• Where it lives: github.com/Nutlope/hallmark
• What it does: builds new pages in one of 48 themes, redesign rebuilds a page you already have, and audit only reports.
• Works in: Claude Code, Cursor, Codex and OpenCode.

Before you install

• Node.js 18 or later. Check it in a terminal: node -v.
• Optional, for the browser checks: Google Chrome, plus one more line: npm i -g puppeteer-core. Without them the audit still runs the checks that read your code. With them it also looks at your page at eight screen widths.

Step 1. Install it

Open a terminal and paste this:

npx skills add nutlope/hallmark -g

-g installs it for every project. Leave -g off to install it only in the folder you're in. In Claude Code it lands in ~/.claude/skills/hallmark.

Step 2. Run the audit on your page

Start Claude Code in your project folder and type:

/hallmark audit ./index.html

Put the path to your own page instead of ./index.html. A folder works too. If your site runs on a dev server (Next.js, Vite and the like), start it first and tell Claude the address, for example: /hallmark audit http://localhost:3000.

Step 3. Read the report

The findings come in three groups:

1. Floor. Must fix. Contrast you can't read, no focus ring for keyboard users, a layout that breaks on a phone, made-up facts.
2. Reflex. The defaults AI falls into. This is the "AI look". You can keep one if you have a reason.
3. Finish. Small craft details. Nice to fix, never urgent.

Each finding points at the line in your file, so you can fix it yourself or ask Claude to fix that one thing.

The AI tells it looks for

These are from the Hallmark README, word for word:

1. "the eyebrow above every heading" (a small label in capitals over each title)
   Copy prompt
2. "tracked-capital labels" (CAPITAL LETTERS WITH WIDE SPACING)
   Copy prompt
3. "one coloured word in a headline"
   Copy prompt
4. "a page of empty frames or nothing but photographs"
   Copy prompt
5. "a hero that misses its screen" (the top section doesn't fit the first screen)
   Copy prompt
6. "an email sign-up at the end of every page"
   Copy prompt
7. "a form that says thanks without sending anything"
   Copy prompt

What I saw when I ran it

On 27 October 2026 I asked Claude Code, with no skill installed, for a one-page website for a made-up physio clinic. Then I ran /hallmark audit on it. It took 79 seconds. The page file was exactly the same afterwards (I checked its fingerprint before and after).

What it found, in plain words:

• A small label in capitals over every heading. Six of them: "Services", "How it works", "Our team" and so on.
• A coloured, italic phrase in the main headline: "Live without the ache."
• The forms fake it. The booking form said "Thanks! We've received your request" without sending anything anywhere. A patient would think they had booked. This was the worst problem, and it isn't about looks at all.
• Numbers nobody gave it. "4.9★ from 320+ reviews", "12 yrs", "48 hrs". My prompt had none of these. Hallmark listed them and asked me to check each one is real.
• The page scrolled sideways on a tablet-sized screen (768 px wide).
• It ended on an email sign-up instead of the booking, which is what a visitor comes to do.

It also said what to keep: the booking block with the real address and hours, the prices and the team.

Try the same on your page. If it flags numbers, check every one before anyone else sees the page.

Want it fixed, not only reported?

Make a backup copy of your page first. Then:

/hallmark redesign ./index.html

A full redesign keeps your text, links and forms, and changes the look and the layout. Say keep the layout and it only restyles. Say polish and it fixes only the AI tells. It asks you three short questions before it starts.

One thing a redesign won't fix: forms. It keeps your form code exactly as it is, so a form that only pretends to send still pretends. Ask Claude to connect it to your email or booking tool as a separate job. On my test page the redesign took about 8 minutes.

The honest part

• Does it send your page anywhere? The audit runs on your computer. One optional script makes pictures through Together AI, and it only runs if you set your own TOGETHER_API_KEY (an account with them). With the key set, a build sends short picture descriptions to Together AI. Without the key it never runs, and you don't need an account for anything else. The photos it uses come from Wikimedia Commons, and the pages it builds load fonts from Google Fonts or Fontshare.
• Security scans: on skills.sh, Gen Agent Trust Hub and Socket say pass. Snyk says "medium" for one reason: the fonts load from outside sites (checked 27 October 2026).
• It writes a folder. The audit saves its notes and screenshots in .hallmark folders (one next to your page, one in the folder you start Claude in). Your page itself stays the same.
• A skill runs with the same rights as Claude. Read what you install. This one is open on GitHub.
• One run is an example, not a statistic. The report is a list to think about, not a grade.