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

> Discover if a Hallmark SDK exists. Learn how Hallmark operates as an AI design skill installed via npx, not a standalone SDK, for efficient code auditing and redesign.

- Repository: [Hassan El Mghari/hallmark](https://github.com/Nutlope/hallmark)
- Tags: deep-dive
- Published: 2026-07-26

---

**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`](https://github.com/Nutlope/hallmark/blob/main/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:

```bash
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`](https://github.com/Nutlope/hallmark/blob/main/skills/hallmark/references/verbs/audit.md))
- **redesign** — Rebuilds visual structures (defined in [`skills/hallmark/references/verbs/redesign.md`](https://github.com/Nutlope/hallmark/blob/main/skills/hallmark/references/verbs/redesign.md))
- **study** — Extracts design DNA from images (defined in [`skills/hallmark/references/verbs/study.md`](https://github.com/Nutlope/hallmark/blob/main/skills/hallmark/references/verbs/study.md))

Example usage through your AI assistant's command interface:

```bash
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`](https://github.com/Nutlope/hallmark/blob/main/site/examples/cobalt-01/script.js), the Distil SDK allows skill invocation:

```javascript
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`](https://github.com/Nutlope/hallmark/blob/main/skills/hallmark/SKILL.md) | Core skill descriptor with entry points and verb semantics |
| [`skills/hallmark/references/verbs/audit.md`](https://github.com/Nutlope/hallmark/blob/main/skills/hallmark/references/verbs/audit.md) | Implementation details for the audit verb |
| [`skills/hallmark/references/verbs/redesign.md`](https://github.com/Nutlope/hallmark/blob/main/skills/hallmark/references/verbs/redesign.md) | Workflow specification for redesign operations |
| [`skills/hallmark/references/verbs/study.md`](https://github.com/Nutlope/hallmark/blob/main/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`](https://github.com/Nutlope/hallmark/blob/main/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`](https://github.com/Nutlope/hallmark/blob/main/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`](https://github.com/Nutlope/hallmark/blob/main/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.