# How to Run Tests in the Nutlope Hallmark Project > Learn how to run tests in the Nutlope Hallmark project. Since automated tests aren't included, use manual checks and the hallmark audit command to verify functionality. - Repository: [Hassan El Mghari/hallmark](https://github.com/Nutlope/hallmark) - Tags: how-to-guide - Published: 2026-08-10 --- **The Nutlope/hallmark repository does not ship with an automated test suite, so you cannot execute `npm test` or similar commands; instead, verify functionality using manual installation checks and the built-in `hallmark audit` command.** The Nutlope/hallmark project is a design-skill package intended for Claude Code, Cursor, or Codex environments that detects UI anti-patterns through rule-based analysis. Because the codebase functions as a skill rather than a traditional library, it lacks conventional testing infrastructure, requiring alternative validation methods to confirm proper operation. ## Why Traditional Testing Is Not Available The repository structure explicitly excludes standard testing infrastructure. The source tree contains no `*.test.js` or `*.spec.js` files, lacks a `tests/` directory, and the [`package.json`](https://github.com/Nutlope/hallmark/blob/main/package.json) does not define a `test` script. Consequently, attempting to **run tests** using `npm test`, `yarn test`, or `npx jest` will fail or return no results, as there is no test harness configured in the project metadata. ## Verify Functionality Through Manual Installation Since no automated test suite exists, validate the skill through installation and file verification: 1. **Install the skill** using the official command: ```bash npx skills add nutlope/hallmark ``` 2. **Confirm core files** are present in your environment: - [`skills/hallmark/SKILL.md`](https://github.com/Nutlope/hallmark/blob/main/skills/hallmark/SKILL.md) – Contains the rule-set that drives the skill's anti-pattern detection logic. - `skills/hallmark/references/` – Directory holding design reference documents utilized during analysis. ## Use the Audit Command for Functional Validation The skill provides a built-in **audit** command that serves as the functional equivalent of a test suite by evaluating targets against Hallmark's documented anti-patterns: ```bash hallmark audit ``` For example, to validate the skill against a demo page: ```bash npx hallmark audit https://www.usehallmark.com/examples/hum-07/ ``` This command executes the validation logic defined in [`skills/hallmark/SKILL.md`](https://github.com/Nutlope/hallmark/blob/main/skills/hallmark/SKILL.md), effectively testing the skill's behavior against real-world inputs. ## Optional: Local Repository Verification If you cloned the repository for development or inspection, verify the file structure locally, though `npm install` only prepares the environment for modification rather than testing: ```bash git clone https://github.com/Nutlope/hallmark.git cd hallmark npm install ``` Running `npm test` in this local copy will not execute any tests, as the [`package.json`](https://github.com/Nutlope/hallmark/blob/main/package.json) lacks the necessary script definition. ## Summary - The Nutlope/hallmark repository contains no automated test suite, spec files, or `test` scripts in [`package.json`](https://github.com/Nutlope/hallmark/blob/main/package.json). - **Run tests** functionality is replaced by the `hallmark audit` command, which validates the skill against target URLs or file paths. - Verify proper installation by confirming the existence of [`skills/hallmark/SKILL.md`](https://github.com/Nutlope/hallmark/blob/main/skills/hallmark/SKILL.md) and the `skills/hallmark/references/` directory. - Consult [`docs/recipes.md`](https://github.com/Nutlope/hallmark/blob/main/docs/recipes.md) for additional usage patterns that demonstrate expected behavior. ## Frequently Asked Questions ### Why does the Hallmark repository have no test suite? The Hallmark project is distributed as a **design skill** for AI coding environments rather than a traditional software library. According to the source code, the repository prioritizes rule-set documentation in [`skills/hallmark/SKILL.md`](https://github.com/Nutlope/hallmark/blob/main/skills/hallmark/SKILL.md) over automated testing, relying instead on the `hallmark audit` command to validate behavior against live targets. ### Can I add my own tests to the Hallmark project? While you could manually create a `tests/` directory and add a `test` script to [`package.json`](https://github.com/Nutlope/hallmark/blob/main/package.json), the architecture is not designed for unit testing. The skill logic resides in markdown rule-sets within [`skills/hallmark/SKILL.md`](https://github.com/Nutlope/hallmark/blob/main/skills/hallmark/SKILL.md) and operates within AI agent contexts, making traditional Jest or Mocha frameworks impractical for validating the rule-based anti-pattern detection. ### How do I know if Hallmark is working correctly after installation? Execute the **audit command** against a known URL or local file path. If `hallmark audit ` runs without errors and produces anti-pattern reports, the skill is functioning correctly. Additionally, verify that [`skills/hallmark/SKILL.md`](https://github.com/Nutlope/hallmark/blob/main/skills/hallmark/SKILL.md) and the `skills/hallmark/references/` directory exist in your installation environment, as these files contain the core logic and reference materials. ### What should I check if the audit command fails? First, confirm you installed the skill correctly using `npx skills add nutlope/hallmark`. Then verify that [`skills/hallmark/SKILL.md`](https://github.com/Nutlope/hallmark/blob/main/skills/hallmark/SKILL.md) is present and readable, as this file contains the core validation rules. Check [`docs/recipes.md`](https://github.com/Nutlope/hallmark/blob/main/docs/recipes.md) for correct command syntax and ensure your target URL or file path is accessible and properly formatted.