← WORK
UX PSYCHOLOGY SKILL — hero
Claude Code Skill2025

UX PSYCHOLOGY SKILL

The Gap
Developers ship beautiful pages that actively repel users. Color psychology, visual hierarchy, friction points, cognitive load. Most devs were never taught to think about any of it, and the result is pretty pages that don't convert.
Challenges
Hiring a UX specialist for every page is expensive and slow. Small teams never get one, and when they do, the feedback is subjective and hard to act on without a real framework behind it.
What We Built
A Claude Code skill that audits websites against 65 established behavioral psychology principles. Point it at a page and it returns structured feedback on layout, copy, imagery, and flow, with reasoning for every call. We built it to sharpen our own work and released it open source. Available on the Nuclear Marmalade GitHub.
Point it at any page. It ranks what matters.
Page Analysis

Point it at any page. It ranks what matters.

The skill reads the page, picks the principles that actually move the needle for that page type, and ranks them by impact. Hick's Law, anchoring, loss aversion, cognitive load. You get the reasoning behind every call, not a generic checklist.

It refuses to play dirty.
Ethics-First

It refuses to play dirty.

Fake scarcity, confirmshaming, hidden costs, dark defaults. Eight dark patterns are documented as hard bans. The skill never suggests them, and it flags them the moment it spots them in your code. Persuasion without the manipulation.

The diff, not the lecture.
Code-Level Fixes

The diff, not the lecture.

Every recommendation ships with before-and-after code you can paste straight in. Anchoring on a pricing card, the Zeigarnik effect on a multi-step flow. Engineers see exactly what changes and why, down to the markup.

Beyond the Audit

Built like a developer would build it.

  • Conversion Sequence Patterns

    Pre-built psychology flows for newsletter signup, free-trial-to-paid, abandoned cart recovery, and more — each mapped to the exact principles that should fire at each step.

  • Worked Example Audits

    Full reference reviews of a SaaS landing page, an e-commerce checkout, and a subscription conversion flow. Reference material developers can pattern-match against instead of starting from a blank page.

  • Hierarchical Decision Framework

    Psychology recommendations are weighed against brand identity, accessibility, and technical quality. The skill knows when to defer to your design system, not override it.

  • Extensible CSV Databases

    Principles and page-type mappings live in machine-readable CSVs. Add custom principles, override defaults, or extend the skill to new page types without touching SKILL.md.

MORE
PROJECTS