Is There a Hallmark SDK? Understanding Hallmark as an AI Design Skill

Hallmark is not distributed as a standalone SDK; instead, it functions as a design skill for AI-coding assistants that you install via a single npx command and invoke through specific verbs like audit, redesign, and study.

If you're searching for a hallmark SDK to import into your JavaScript or Node.js project, you'll find that Hallmark operates differently than traditional libraries. According to the Nutlope/hallmark repository source code, this tool is architected as an AI design skill rather than a conventional software development kit, requiring no package installation beyond a one-line skill registration.

Hallmark Is a Design Skill, Not an SDK

The repository does not expose a hallmark SDK for direct import. Instead, Hallmark lives in the skills/hallmark/ directory as a skill definition consumed by AI assistants like Claude, Cursor, and Codex. The entry point resides in skills/hallmark/SKILL.md, which defines the available commands and behavior rather than providing a programmatic API.

How to Install Hallmark Without an SDK

Since there is no npm package to install directly, you add Hallmark to your AI assistant using the skills registry:

npx skills add nutlope/hallmark

This command pulls the skill definition from the public registry and makes it available to your AI coding assistant. Once registered, the skill automatically loads its reference files from the local skills/hallmark/ folder.

Invoking Hallmark Through Skill Verbs

After installation, you interact with Hallmark through three primary verbs defined in the reference documentation. These commands operate on HTML files and screenshots rather than requiring SDK method calls:

• audit — Scores pages against design anti-patterns (defined in skills/hallmark/references/verbs/audit.md)
• redesign — Rebuilds visual structures (defined in skills/hallmark/references/verbs/redesign.md)
• study — Extracts design DNA from images (defined in skills/hallmark/references/verbs/study.md)

Example usage through your AI assistant's command interface:

hallmark audit path/to/page.html
hallmark redesign path/to/page.html
hallmark study screenshot.png

Programmatic Access via Host Assistant SDKs

If you need to trigger Hallmark programmatically from JavaScript, you cannot import a hallmark SDK directly. Instead, you interact with your host AI assistant's SDK (such as the Distil SDK shown in the demo site) and pass the skill name as a parameter.

As implemented in site/examples/cobalt-01/script.js, the Distil SDK allows skill invocation:

import { Distil } from "@distil/sdk";

await Distil.runSkill("nutlope/hallmark", { 
  verb: "audit", 
  target: "index.html" 
});

Note that @distil/sdk is unrelated to Hallmark itself—it merely demonstrates how a host platform's SDK might execute the skill.

Key Repository Files Supporting the Skill

The entire Hallmark capability exists within these specific source files:

File Path	Purpose
skills/hallmark/SKILL.md	Core skill descriptor with entry points and verb semantics
skills/hallmark/references/verbs/audit.md	Implementation details for the audit verb
skills/hallmark/references/verbs/redesign.md	Workflow specification for redesign operations
skills/hallmark/references/verbs/study.md	Design DNA extraction process documentation
site/_tests/	Test pages used by the skill verbs

Summary

• Hallmark does not provide a standalone SDK for import into projects
• Install the skill using npx skills add nutlope/hallmark
• Interact through verbs (audit, redesign, study) rather than API methods
• Reference implementations live in skills/hallmark/references/verbs/
• For programmatic use, leverage your AI host's SDK to invoke the skill by name

Frequently Asked Questions

Can I install Hallmark via npm install?

No. Hallmark is not published as an npm package. According to the repository's package.json, the project only declares Node scripts for local development. You install Hallmark as a skill using npx skills add nutlope/hallmark, which registers it with your AI assistant rather than adding it to your node_modules.

How do I call Hallmark functions from my JavaScript code?

You cannot import Hallmark functions directly because there is no hallmark SDK exposing an API. To use Hallmark programmatically, you must integrate with your AI assistant's platform SDK (like the Distil SDK referenced in site/examples/cobalt-01/script.js) and invoke the skill using runSkill("nutlope/hallmark", { verb: "audit", ... }) syntax.

What file contains the Hallmark skill definition?

The skill definition resides in skills/hallmark/SKILL.md. This file contains the entry point configuration, available verbs, and command semantics that AI assistants use to understand how to execute Hallmark commands.

Do I need to clone the repository to use Hallmark?

No. You only need to run npx skills add nutlope/hallmark to register the skill with your AI assistant. The skill references files locally within the skills/hallmark/ directory structure, but you do not need to manually clone or manage these files unless you are modifying the skill itself.

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