# How to Install Nutlope/hallmark on Windows: Complete Setup Guide > Easily install Nutlope/hallmark on Windows with our complete setup guide. Learn how to add the Hallmark skill to your favorite coding assistants in just a few simple steps. - Repository: [Hassan El Mghari/hallmark](https://github.com/Nutlope/hallmark) - Tags: how-to-guide - Published: 2026-07-26 --- **Install Node.js, then run `npx skills add nutlope/hallmark` in PowerShell to add the Hallmark skill to Claude Code, Cursor, or Codex.** Nutlope/hallmark is an **npm-based skill** that enhances AI coding assistants with structured prompt templates and design rules. Installing it on Windows requires only a Node.js runtime, and the process is identical to macOS and Linux setups. This guide covers both the automated npx installation and manual configuration for specific AI assistants. ## Prerequisites Before installing Hallmark, ensure you have **Node.js** installed on your Windows machine. The Node.js installer automatically adds `npm` and `npx` to your system `PATH`, which are required for the installation commands. 1. Download the Windows installer from [nodejs.org](https://nodejs.org/en/download/). 2. Run the installer and accept the default settings. 3. Verify the installation by running `node --version` in PowerShell. ## Installing Nutlope/hallmark on Windows You can install the skill using either the automated npx command or by manually copying the skill files. Both methods are documented in the repository's [`README.md`](https://github.com/Nutlope/hallmark/blob/main/README.md) (lines 96-105). ### Method 1: Automated Installation via npx (Recommended) The simplest approach uses npx to pull the skill directly from the registry. Open **PowerShell** or **Command Prompt** and execute: ```powershell npx skills add nutlope/hallmark ``` This command downloads the skill package and writes the necessary files to the appropriate location for your active AI assistant. ### Method 2: Manual Installation If you prefer manual control or need to customize the installation, copy the skill files directly from the repository. The skill consists of [`SKILL.md`](https://github.com/Nutlope/hallmark/blob/main/SKILL.md) (the entry point) and the `references/` directory (supporting templates). For **Claude Code**, copy the files to the skills directory: ```powershell # Assuming you cloned the repository Copy-Item -Recurse -Path .\skills\hallmark\* -Destination "$HOME\.claude\skills\hallmark\" ``` For **Cursor**, create `.cursor/rules/hallmark.mdc` and paste the body of [`SKILL.md`](https://github.com/Nutlope/hallmark/blob/main/SKILL.md) without the frontmatter. For **Codex**, use either `~/.codex/skills/hallmark/` (user-wide) or `.codex/skills/hallmark/` (project-specific). ## Configuring for Specific AI Assistants According to the source code in [`README.md`](https://github.com/Nutlope/hallmark/blob/main/README.md) (lines 100-105), each assistant expects the skill files in specific locations: - **Claude Code**: Place files in `~/.claude/skills/hallmark/` - **Cursor**: Create `.cursor/rules/hallmark.mdc` in your project root using the content from [`skills/hallmark/SKILL.md`](https://github.com/Nutlope/hallmark/blob/main/skills/hallmark/SKILL.md) - **Codex**: Use `~/.codex/skills/hallmark/` for personal scope or `.codex/skills/hallmark/` for project scope The `references/` folder containing design templates should accompany [`SKILL.md`](https://github.com/Nutlope/hallmark/blob/main/SKILL.md) in these locations. ## Running the Demo Server Locally The repository includes a local preview server defined in [`package.json`](https://github.com/Nutlope/hallmark/blob/main/package.json) (lines 32-34). This server allows you to preview generated sites at `http://localhost:4173`. Start the server from the repository root: ```powershell npm run serve ``` This launches a Python HTTP server on port 4173 serving the `./site` directory. Ensure Python is installed on your Windows machine, as the script relies on Python's built-in HTTP server module. ## Summary - **Node.js** is the only prerequisite for installing Nutlope/hallmark on Windows - Run `npx skills add nutlope/hallmark` to automatically install the skill via the npm registry - Manual installation requires copying [`skills/hallmark/SKILL.md`](https://github.com/Nutlope/hallmark/blob/main/skills/hallmark/SKILL.md) and the `references/` folder to assistant-specific directories - Use `npm run serve` to start a local preview server on port 4173 ## Frequently Asked Questions ### Do I need administrator privileges to install Hallmark on Windows? No. The `npx` command installs the skill in user space, writing files to directories within your user profile (such as `~/.claude/skills/` or `.codex/skills/`). You do not need elevated permissions or administrator access. ### Can I use Hallmark with Cursor on Windows? Yes. For **Cursor**, create a file at `.cursor/rules/hallmark.mdc` in your project directory and populate it with the contents of [`skills/hallmark/SKILL.md`](https://github.com/Nutlope/hallmark/blob/main/skills/hallmark/SKILL.md), excluding the YAML frontmatter. The skill functions identically across all supported platforms. ### How do I update Hallmark to the latest version? Re-run the original installation command: `npx skills add nutlope/hallmark`. This fetches the latest version from the npm registry and overwrites the existing skill files in your assistant's configuration directory. ### Why does the demo server use Python instead of Node.js? The `serve` script defined in [`package.json`](https://github.com/Nutlope/hallmark/blob/main/package.json) uses Python's built-in HTTP server. This design choice avoids adding Node.js server dependencies to the project, and since Python is typically pre-installed on Windows development machines, it provides a lightweight way to preview the `./site` directory on port 4173.