# What Is the README.md File in Nutlope/hallmark? A Complete Guide to the Anti-Slop Design Skill > Discover the README.md file in Nutlope/hallmark. Learn about Hallmark, an AI design skill that enforces anti-slop rules for human-like UI components. - Repository: [Hassan El Mghari/hallmark](https://github.com/Nutlope/hallmark) - Tags: how-to-guide - Published: 2026-07-14 --- **The README.md file in the Nutlope/hallmark repository serves as the front-page documentation for Hallmark, a design skill for AI coding assistants that applies strict anti-slop rules to generate human-like UI components.** The Nutlope/hallmark repository hosts Hallmark, a specialized skill built by Together AI that integrates with Claude Code, Cursor, and Codex. According to the source code analysis, the README.md explains how the tool refuses to look AI-generated by enforcing design principles derived from Anthropic's frontend-design skill and the 2026 "tactile rebellion" movement. ## Overview of the Hallmark Design Skill Hallmark is not a traditional code library but a **design discipline** packaged as an AI skill. As documented in [`README.md`](https://github.com/Nutlope/hallmark/blob/main/README.md) lines 3-5, it applies a strict set of anti-slop design rules to ensure generated interfaces avoid common AI artifacts. ### Core Purpose and Philosophy The skill targets the "slop" problem—interfaces that look obviously machine-generated. Hallmark implements **57 slop-test gates** and pre-emit self-critique mechanisms to validate output before returning results. This approach draws from Anthropic's frontend-design skill, the Claude cookbook, and contemporary design movements. ### Live Demo and Attribution The README references a public demo at `https://www.usehallmark.com` (lines 5-6) and attributes the build to **Together AI** (lines 7-8). ## The Four Command Verbs The README.md defines four primary interaction modes (lines 17-25) that dictate how AI assistants invoke the skill: ### Default Build Mode When invoked without arguments, Hallmark builds a new UI from scratch: ```bash hallmark ``` This triggers the default design flow: selecting a macrostructure, applying the rule-set, running the 57 slop-test gates, and performing a pre-emit self-critique before returning the final HTML and CSS. ### Audit Mode The `audit` verb scores existing code against anti-patterns without making edits: ```bash hallmark audit ./src ``` This produces a ranked punch-list of violations found in [`references/anti-patterns.md`](https://github.com/Nutlope/hallmark/blob/main/references/anti-patterns.md). ### Redesign Mode The `redesign` verb refreshes visual design while preserving content architecture: ```bash hallmark redesign ./public/index.html ``` This re-structures the visual design while maintaining copy, IA, brand, and routes. According to the README, it optionally performs a full rebuild if the user confirms. ### Study Mode The `study` verb extracts design DNA from reference materials: ```bash hallmark study https://example.com/hero # or hallmark study ./screenshots/hero.png ``` This extracts the **DNA** (macrostructure, type-pairing, colour anchor) from admired designs and optionally emits a portable [`design.md`](https://github.com/Nutlope/hallmark/blob/main/design.md) or rebuilds using the extracted DNA. ## Themes and Macrostructures Hallmark ships with **20 catalog themes** (e.g., Specimen, Atelier, Brutal, Newsprint) as documented in [`README.md`](https://github.com/Nutlope/hallmark/blob/main/README.md) lines 30-38. The skill ensures that two pages generated from different briefs feel like completely different sites—not merely colour swaps—through macrostructure diversity and theme-rotation rules. The available macrostructures are indexed in [`skills/hallmark/references/macrostructures.md`](https://github.com/Nutlope/hallmark/blob/main/skills/hallmark/references/macrostructures.md), while individual theme specifications reside in `skills/hallmark/references/themes/`. ## Installation and Usage The README provides a one-command installation method (lines 94-102): ```bash npx skills add nutlope/hallmark ``` Re-running this command updates the skill. Alternatively, users can manually copy [`SKILL.md`](https://github.com/Nutlope/hallmark/blob/main/SKILL.md) and the `references/` directory into the appropriate location for Claude Code, Cursor, or Codex. ## Key Supporting Files The Hallmark skill relies on several reference files documented in the repository: - **[`skills/hallmark/SKILL.md`](https://github.com/Nutlope/hallmark/blob/main/skills/hallmark/SKILL.md)** – Formal skill definition containing version, description, and verb mapping used by AI assistants. - **[`skills/hallmark/references/anti-patterns.md`](https://github.com/Nutlope/hallmark/blob/main/skills/hallmark/references/anti-patterns.md)** – Defines design anti-patterns (e.g., invented metrics, italic headers) that the slop-test rejects. - **[`skills/hallmark/references/macrostructures.md`](https://github.com/Nutlope/hallmark/blob/main/skills/hallmark/references/macrostructures.md)** – Catalog of 21 named macrostructures available for selection. - **[`docs/recipes.md`](https://github.com/Nutlope/hallmark/blob/main/docs/recipes.md)** – Worked examples of complete briefs and resulting outputs. - **`site/_tests/`** – Test fixtures showcasing Hallmark-generated pages for each theme. ## Summary - The **README.md** in Nutlope/hallmark documents Hallmark, an anti-slop design skill for AI coding assistants built by Together AI. - It defines **four verbs**: default (build), `audit`, `redesign`, and `study` for different design workflows. - The skill includes **20 catalog themes** and 21 macrostructures to ensure visual diversity. - Installation requires `npx skills add nutlope/hallmark` or manual placement of [`SKILL.md`](https://github.com/Nutlope/hallmark/blob/main/SKILL.md) and `references/`. - Hallmark operates under the MIT license, allowing free use and distribution. ## Frequently Asked Questions ### What is the Hallmark README file used for? The **README.md** file serves as the primary documentation for the Hallmark design skill. It explains how to install the skill, invoke its four command verbs, and leverage its 20-catalog themes to generate UI that avoids common AI-generated design patterns. ### How do I install the Hallmark skill from the Nutlope repository? You can install Hallmark using the command `npx skills add nutlope/hallmark` as shown in [`README.md`](https://github.com/Nutlope/hallmark/blob/main/README.md) lines 94-102. This registers the skill with Claude Code, Cursor, or Codex. Alternatively, manually copy [`SKILL.md`](https://github.com/Nutlope/hallmark/blob/main/SKILL.md) and the `references/` directory to your AI assistant's skills folder. ### What are the anti-slop design rules mentioned in the README? The anti-slop rules are a set of **57 design constraints** derived from Anthropic's frontend-design skill and the "tactile rebellion" movement. These rules reject common AI artifacts like invented metrics and italic headers, documented in [`skills/hallmark/references/anti-patterns.md`](https://github.com/Nutlope/hallmark/blob/main/skills/hallmark/references/anti-patterns.md). ### Can Hallmark analyze existing websites without rebuilding them? Yes. The `hallmark audit ` command scores existing code against anti-patterns and produces a ranked punch-list of improvements without making edits. The `hallmark study ` command can also extract design DNA from existing sites for reference or rebuilding.