Back to Skills

psychology-foundations

verified

Use when you need to understand WHY certain UX patterns work. Covers cognitive psychology, behavioral science, and neuroscience foundations that underpin satisfying experiences.

View on GitHub

Marketplace

agi-marketplace

bfmcneill/agi-marketplace

Plugin

ux

Repository

bfmcneill/agi-marketplace

ux/skills/psychology-foundations/SKILL.md

Last Verified

January 21, 2026

Install Skill

Select agents to install to:

Scope:
npx add-skill https://github.com/bfmcneill/agi-marketplace/blob/main/ux/skills/psychology-foundations/SKILL.md -a claude-code --skill psychology-foundations

Installation paths:

Claude
.claude/skills/psychology-foundations/
Powered by add-skill CLI

Instructions

# Psychology Foundations

Understanding *why* patterns work lets you apply them to new situations. These are the research foundations beneath UX practice.

## About This Skill

This skill contains **research-backed principles only**. Each concept includes:
- The original researcher(s)
- Year of key publication(s)
- What the research actually showed
- Limitations or caveats where relevant

---

## 1. Dopamine and Anticipation

**Researchers:** Wolfram Schultz (1990s), Robert Sapolsky
**Field:** Neuroscience

### What Research Shows

Dopamine neurons fire in response to **prediction of reward**, not reward itself. When a reward is expected and received, dopamine levels don't spike at reward time—they spike at the cue predicting the reward.

Schultz's experiments with monkeys showed:
- Unexpected reward → dopamine spike at reward
- Expected reward (after learning) → dopamine spike at predictor, not reward
- Expected reward that doesn't come → dopamine dip (disappointment)

### UX Implication

Progress indicators work because they signal approaching reward. The anticipation phase is neurologically active.

**Source:** Schultz, W. (1998). Predictive reward signal of dopamine neurons. *Journal of Neurophysiology*.

---

## 2. Peak-End Rule

**Researchers:** Daniel Kahneman, Barbara Fredrickson
**Field:** Behavioral economics, Psychology
**Recognition:** Nobel Prize in Economics (2002)

### What Research Shows

In studies of colonoscopies and other experiences, participants rated overall experience based on:
1. The **peak** moment (most intense)
2. The **end** moment

Duration had little effect ("duration neglect"). A longer painful experience ending gently was rated better than a shorter one ending abruptly.

### UX Implication

- Create one memorable positive peak
- End interactions well
- A graceful error recovery can redeem a frustrating experience

**Source:** Kahneman, D. et al. (1993). When more pain is preferred to less. *Psychological Science*.

---

## 3. Loss Av

Validation Details

Front Matter
Required Fields
Valid Name Format
Valid Description
Has Sections
Allowed Tools
Instruction Length:
8821 chars