What Are the System Requirements for Hallmark: Complete Installation Guide

You need Node.js 14 LTS or higher (with npm) to install Hallmark, optionally Python 3 for local previews, and a modern web browser to view generated static pages.

Hallmark is a design skill for AI coding assistants that generates static HTML and CSS pages. Before installing the tool from the Nutlope/hallmark repository, verify that your environment meets these specific system requirements for Hallmark to function correctly.

Core System Requirements

Node.js and npm (Mandatory)

Node.js version 14 LTS or higher is the primary runtime dependency. According to the installation instructions in README.md (line 96), the skill installs via npx, which requires Node.js and the bundled npm package manager to resolve the package from the registry.

npx skills add nutlope/hallmark

Python 3 (Optional)

For local development previews, Python 3 is recommended but not required. The serve script defined in package.json (line 33) utilizes python3 -m http.server to launch a local HTTP server on port 4173.

npm run serve

Modern Web Browser

The generated pages rely on modern CSS features including custom properties, clamp(), @media queries, and overflow-x: clip. Compatible browsers include Chrome ≥89, Firefox ≥86, Safari ≥14, and Edge ≥89.

Internet Access

Network connectivity is required only during the initial installation phase when npx fetches the package from the npm registry. As implemented in the offline-capable architecture, the skill works entirely after installation with no further network calls required.

Installation Process

The primary installation method uses the npx command to fetch the skill from npm. As documented in the repository's README.md, execute the following in your terminal:

npx skills add nutlope/hallmark

The site/index.html file (line 826) contains the install UI that references this same command for users accessing the web interface at usehallmark.com.

Local Preview Configuration

To preview generated static sites locally after cloning the repository, use the convenience script defined in package.json:

# Requires Python 3 installed

npm run serve

This command starts a local server at http://localhost:4173, allowing you to view the generated site before deployment.

AI Assistant Integration

Once installed, Hallmark runs as a skill inside Claude Code, Cursor, and Codex. The skill definition in skills/hallmark/SKILL.md specifies the available verbs (such as redesign) that these assistants consume to generate static HTML and CSS output.

Summary

• Node.js ≥14 LTS is mandatory for executing npx skills add nutlope/hallmark
• npm installs automatically with Node.js and handles package resolution from the registry
• Python 3 enables the optional npm run serve local preview functionality
• Modern browsers (Chrome 89+, Firefox 86+, Safari 14+, Edge 89+) correctly render the generated CSS utilizing modern features
• Internet connection is only required during the installation step; the skill operates offline thereafter

Frequently Asked Questions

Do I need Python to use Hallmark?

No. Python 3 is only required if you want to run the local preview server using npm run serve. The core skill functionality works without Python installed, as the skill generates static files that can be opened directly in a browser or served by any HTTP server.

What AI coding assistants support Hallmark?

According to skills/hallmark/SKILL.md, Hallmark runs inside Claude Code, Cursor, and Codex. The skill definition file specifies the verbs and capabilities consumed by these assistants, including the redesign command for transforming project files.

Can I use Hallmark without internet access?

Yes, but only after the initial installation. The npx command requires internet connectivity to download the package from npm as stated in the installation UI (site/index.html, line 826). After the skill is installed, it operates completely offline with no external API dependencies.

What Node.js versions are supported?

Hallmark requires Node.js 14 LTS or higher. The npx command used in the installation process (README.md, line 96) is compatible with Node.js 14+ environments, which is the minimum version supporting the package resolution features required by the skill distribution mechanism.

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