← All runbooks
nutlope / hallmark★ Featured · worked examples

Hallmark

Run Hallmark — the anti-AI-slop design skill (Nutlope/hallmark, MIT) — to produce a web UI that refuses to look AI-generated. Hallmark encodes a tight, opinionated rule set (macrostructure variety, a 20-theme catalog, OKLCH tokens, a 58-gate slop test, a…

agent claude-codemodel anthropic/claude-sonnet-4.6snapshot prism-playwrighteval programmatic11 stepsv1.0.0

Deploy Hallmark to your jetty.io

One-click installs this runbook into a collection on your Jetty account. You can run it from the Spot dashboard, schedule it, or pipe inputs in via the API.

Run timebuild/redesign 15–25 mins · audit/study ~7 mins
Headline outputscreenshot.png · index.html · audit_report.md · design.md

Runs on Jetty's managed sandbox. No setup. Free for your first 10 runs.

Worked examples · 4

Real runs, real outputs.

The shape of the run

11 steps · start to finish.

  1. 1
    Step 1

    Environment Setup

    ▶
    set -e
    mkdir -p /app/results /app/work
    cd /app/work
    
    # Clone the Hallmark skill (public, MIT). Shallow clone is enough.
    if [ ! -d /app/work/hallmark/.git ]; then
      git clone --depth 1 https://github.com/Nutlope/hallmark.git /app/work/hallmark 2>&1 | tail -3
    fi
    SKILL=/app/work/hallmark/skills/hallmark/SKILL.md
    REFS=/app/work/hallmark/skills/hallmark/references
    test -f "$SKILL" || { echo "ERROR: Hallmark SKILL.md not found at $SKILL"; exit 1; }
    echo "Hallmark skill: $SKILL"
    echo "References dir: $REFS ($(ls "$REFS" | wc -l) entries)"
    
    # Verify the screenshot toolchain (build/redesign). prism-playwright ships Chromium.
    node -e "require('playwright')" 2>/dev/null && echo "playwright: OK" || \
      echo "playwright: will install on demand in Step 6"
    
    # Resolve inputs (parameters are substituted into this body; uploads land in /app/assets)
    OP="{{operation}}"; [ -z "$OP" ] || [ "$OP" = "{{operation}}" ] && OP="build"
    echo "operation=$OP"
    ls -la /app/assets 2>/dev/null || echo "(no /app/assets uploads)"
    

    Gotcha: the prism-playwright snapshot is required for screenshot.png. If a run uses a non-browser snapshot, the screenshot step degrades gracefully (Step 6) but build/redesign will be PARTIAL, not green.


  2. 2
    Step 2

    Load the Skill + Resolve the Operation

    ▶

    Read SKILL.md in full from /app/work/hallmark/skills/hallmark/SKILL.md. It is the source of truth for every design decision. Then load only the reference files it tells you to load for your operation…

  3. 3
    Step 3

    Non-Interactive Override (CRITICAL — read before any verb)

    ▶

    Hallmark's SKILL.md is written for an interactive editor and contains several "always ask the user" gates and "ask one short question" branches. In this sandbox there is no user. Apply these…

  4. 4
    Step 4

    Run the Operation

    ▶

    Follow the matching SKILL.md flow, with the Step 3 overrides applied. Do scratch work in /app/work; write deliverables to /app/results.

  5. 5
    Step 5

    Enforce the Output Contract

    ▶

    Confirm /app/results holds exactly the chosen operation's files (table in REQUIRED OUTPUT FILES) and nothing else. Move any stray scratch (node_modules/, the clone, .hallmark/, package*.json, build/)…

  6. 6
    Step 6

    Render the Screenshot (build / redesign)

    ▶

    Render the built page to /app/results/screenshot.png — this is the gallery hero and the proof the page actually renders. Skip for audit/study.

  7. 7
    Step 7

    The Slop Test (58 gates)

    ▶

    Before finishing, run the output through Hallmark's slop test. Load references/slop-test.md now (not earlier — it is a post-emit check). For build/redesign, every gate's answer must be no; fix any…

  8. 8
    Step 8

    Iterate on Errors (max 3 rounds)

    ▶

    If Step 6 shows an unstyled page, a required file is missing, or a slop-test gate fails:

  9. 9
    Step 9

    Evaluate Outputs

    ▶

    Status · Criteria PASS · All required files for the operation exist and are non-empty; for build/redesign the screenshot.png shows a styled, themed page and index.html links its CSS by relative href…

  10. 10
    Step 10

    Write Executive Summary

    ▶

    Write /app/results/summary.md:

  11. 11
    Step 11

    Write Validation Report

    ▶

    Write /app/results/validation_report.json: