PluginPartly tested (needs an account)

Design skills routing harness

makkov-harness

A plugin for designers: a routing map picks the right design skill, Design Score rates a live page from 0 to 100, plus companion plugins.

Works with
Claude Code, Codex CLI, Gemini CLI
Good for
Graphic designers, Web developers

What it does

Makkov Harness is a designer's toolkit for coding agents. A routing map loads at the start of each session, so the agent picks a design skill that matches what you ask: score a live page, take a product's design system as a reference, add motion, review a screen, or turn research into a designed report page.

Design Score (new in 0.2) runs 37 checks in seven categories and returns a 0–100 score with a fix prompt. The plugin also carries copies of Emil Kowalski's animation skills and HeyGen's HyperFrames video skills, with their licences. Companion plugins such as interfaces, Impeccable, Hallmark and Superpowers stay in their authors' repositories; this marketplace lists them so you can switch each one on. The README recommends adding the marketplace at claude.ai (Customize → Plugins) so it follows your account; the terminal lines install it on one computer only.

Example prompts

  • "run harness-onboarding"
  • "score localhost:3000 and fix the top issues"
  • "review this screen"
  • "make it feel like Linear"
  • "animate this card"
  • "make a release video"

How to install

/plugin marketplace add Makkov-design/makkov-harness
/plugin install makkov-harness@makkov-harness

How to use it

After install, start a new session and say "run harness-onboarding" once. Then ask for design work in plain words (for example "score localhost:3000", "animate this card" or "review this screen"). The routing map picks the skill.

Check it works

In Claude Code, after /plugin install makkov-harness@makkov-harness, start a new session. Run claude plugin list in a terminal; it should show makkov-harness 0.5.0 or later enabled. Then say "run harness-onboarding": the agent should ask a few short questions about your language, role and tools.

Common problems

Other assistants

What to watch out for

  • Two hooks. A SessionStart hook adds ROUTING.md (the situation-to-skill map) and the plugin path to every new, cleared or compacted session. Since 0.4.0 an install-gate hook checks each shell command: npm install <package>, npx, pip install, curl ... | sh and similar become a question to you, and the agent is told to review the package first. It never blocks; turn it off with MAKKOV_HARNESS_INSTALL_GATE=off. No skill has disable-model-invocation, so the agent picks and starts skills by itself
  • harness-onboarding writes a personal section into your user instructions file (~/.claude/CLAUDE.md for the Claude Code plugin), between makkov-harness:personal markers, after a .bak backup. The plugin has no uninstaller for it: delete the marked block by hand
  • Network: design-md-library fetches DESIGN.md files from raw.githubusercontent.com (VoltAgent/awesome-design-md, pinned commit). design-score's browser path loads mh-score.js from makkov-design.github.io into the page; since 0.5.0 the loader has an integrity hash, so the browser runs it only if it matches the copy in the plugin. The skill says the probe itself makes no network requests
  • Since 0.3.0, sound effects for videos come from the Openverse service over the network (CC0 or CC BY recordings; credits for CC BY go in CREDITS.md). Optional OPENVERSE_CLIENT_ID and OPENVERSE_CLIENT_SECRET give higher limits; the release says the token stays in memory only. Since 0.3.1 the bundled HyperFrames launcher is pinned to HyperFrames CLI 0.9.9
  • The bundled HyperFrames skills run the HyperFrames CLI (Node.js 22+ and FFmpeg). Before 0.3.4 the media-use scripts sent usage events to PostHog, linked to your HeyGen account when signed in, and before 0.5.0 the CLI that the harness started kept HeyGen's own usage telemetry on. Since 0.5.0 the harness launcher starts the CLI with HYPERFRAMES_NO_TELEMETRY=1 and npm install scripts off, unless you set MEDIA_USE_TELEMETRY=1. A plain npx hyperframes that you run yourself keeps HeyGen's default (telemetry on). In cloud sessions the agent offers to run cloud/setup-design-tools.sh (ffmpeg, puppeteer-core, hyperframes) after your yes
  • Companion plugins are optional. All six are pinned to a commit. Frame Lens (formerly ytlens, the author's own, not reviewed like the others) works locally without a key; only its Gemini tools, for YouTube links, need your own GEMINI_API_KEY and send the link to Google Gemini. Impeccable has telemetry (impeccable telemetry off)
  • The installer for other agents copies skills to ~/.agents/skills and edits the agent's instructions file inside a marked block, after a .bak backup. Before 0.3.3 it deleted same-name skill folders, also your own. Since 0.3.3 a folder that is not an identical copy of the harness's is moved to .makkov-harness/backups/<date>/skills/; --dry-run shows what it would do, and install/uninstall.sh removes it again
  • The 19 sound effects bundled with media-use are under the Pixabay Content License, not MIT: you can use them in your videos, but not share them on their own (0.5.0)
  • INSTALL.md tells the agent to ask once for a GitHub star; on your yes it runs gh api -X PUT user/starred/Makkov-design/makkov-harness with your GitHub login
  • The author's COMPATIBILITY.md says Claude Code is used by hand every day. For the eight other agents, only the installer is tested automatically; no one has yet run real tasks in them

Licence and author

Licence
MIT
Author
Makkov (Makkov-design)
Source code
github.com/Makkov-design/makkov-harness

How we tested it

We installed it on an empty test computer on 7 Nov 2026. Partly tested: installed in a clean test system, but its main features need an account or key we did not use.

Test level

No skill was run, and the claude.ai Customize route, the companion plugins and the Codex and Gemini CLI installers were not tested.

Technical details of the test
Date
7 Nov 2026
Method
Reviewed against the repository at ba036ad (plugin.json 0.2.0; latest tag v0.1.0): README, INSTALL.md, COMPATIBILITY.md, CREDITS.md, both manifests, hooks, install/install.sh, cloud/setup-design-tools.sh and the skills. Install tested in a clean container (oexp-sandbox image, no account) with the shell equivalent of the README's /plugin lines: claude plugin marketplace add Makkov-design/makkov-harness, then claude plugin install makkov-harness@makkov-harness; claude plugin list showed 0.2.0 enabled.

Checked again on 9 Nov 2026

Alternatives

  • Frontend Design — Anthropic's design skill that picks a clear style, fonts and colours for each page; no score or routing
  • Oil UI — recommends one look for your site or app and polishes it

FAQ

  • Q: Does Design Score upload my page? A: The skill says the probe runs in the page and sends nothing. In the agent's browser it loads the script from makkov-design.github.io first.
  • Q: Do I need Figma? A: No. Design Score works on a live URL. Without a browser tool, it asks you to use the bookmarklet, or scores a screenshot by eye and says nothing was measured.
  • Q: Are companion plugins required? A: No. They are optional, one switch each.

Sources

  • github.com/Makkov-design/makkov-harness
  • github.com/Makkov-design/makkov-harness/blob/main/INSTALL.md
  • github.com/Makkov-design/makkov-harness/blob/main/COMPATIBILITY.md
  • github.com/Makkov-design/makkov-harness/blob/main/.claude-plugin/marketplace.json
  • github.com/Makkov-design/makkov-harness/blob/main/hooks/hooks.json
  • github.com/Makkov-design/makkov-harness/releases/tag/v0.3.0
  • github.com/Makkov-design/makkov-harness/releases/tag/v0.3.1
  • github.com/Makkov-design/makkov-harness/releases/tag/v0.3.2
  • github.com/Makkov-design/makkov-harness/releases/tag/v0.5.0
  • github.com/Makkov-design/makkov-harness/blob/8b39fbe048ff45d380a14c7da034e4e8cfb0e8ae/CHANGELOG.md
  • github.com/Makkov-design/makkov-harness/blob/8b39fbe048ff45d380a14c7da034e4e8cfb0e8ae/hooks/hooks.json
  • github.com/Makkov-design/makkov-harness/blob/8b39fbe048ff45d380a14c7da034e4e8cfb0e8ae/.claude-plugin/marketplace.json
  • github.com/Makkov-design/makkov-harness/blob/8b39fbe048ff45d380a14c7da034e4e8cfb0e8ae/skills/hyperframes/scripts/plugin-cli.mjs
  • github.com/Makkov-design/makkov-harness/blob/8b39fbe048ff45d380a14c7da034e4e8cfb0e8ae/COMPATIBILITY.md
  • github.com/Makkov-design/framelens/blob/843870cae3108063efb89b8d94e124498864e1df/README.md