How to Install Nutlope/hallmark on Windows: Complete Setup Guide

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.
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 (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:

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 (the entry point) and the references/ directory (supporting templates).

For Claude Code, copy the files to the skills directory:

# 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 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 (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
• 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 in these locations.

Running the Demo Server Locally

The repository includes a local preview server defined in package.json (lines 32-34). This server allows you to preview generated sites at http://localhost:4173.

Start the server from the repository root:

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 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, 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 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.

{
  "mcpServers": {
    "instagit": {
      "command": "npx",
      "args": ["-y", "instagit@latest"]
    }
  }
}