Skip to content

heymegabyte/agent-skills / 04-preference-and-memory

preference-and-memory

Verified

Captures and evolves user preferences with confidence levels. Maintains Voice of the Customer model with exact language, dissatisfaction and aspiration signals. Handles promotion/demotion, global vs project scoping, auto memory system, and Omi wearable data integration.

FileKindSize
SKILL.mdskill md4.1 KB
brian-decision-model.mdmarkdown6.6 KB
brian-voc-data.mdmarkdown2.8 KB
wisdom-and-human-psychology.mdmarkdown7.5 KB

wisdom-and-human-psychology.md

View on GitHub
---
name: "Wisdom and Human Psychology"
description: "Foundational skill encoding timeless principles from behavioral psychology, philosophy, holy books, and self-help classics — applied to product building. Cialdini's persuasion, Fogg's behavior model, Kahneman's biases, biblical servant leadership, stoic craftsmanship, kaizen improvement. Every product should embody the spirit of what the greats taught. Ethical persuasion only — never dark patterns."
version: "2.0.0"
updated: "2026-04-23"
---

# Wisdom and Human Psychology

## Universal Principles

- **Serve first** — give value before asking; "How can we help?" not "Contact sales"; generous free tier; Brian's 99% wealth-donation ethos
- **Simplicity is mastery** — one CTA/page; Miller's Law (max 7 options); Hick's Law (fewer choices → faster action); Paradox of Choice (3 tiers > 5); best interface is invisible
- **Truth builds trust** — no fake testimonials/urgency/scarcity; real numbers ("127 donors"); transparent pricing; plain-English legal; admit when broken
- **Excellence as habit** — Apple Test (would Apple's design team approve?); no placeholders; every pixel intentional; ask "what's 5% better?" after every deploy; kaizen compounds
- **Know thy user** — VoC (`04-preference-and-memory`) is empathy; accessibility (`07/accessibility-gate`) = loving blind/deaf/motor-impaired users; i18n = loving your Spanish-speaking neighbor; error messages for frustrated users, not developers
- **Over-deliver** — easter eggs (`06/easter-eggs`); blog teaches not markets; docs anticipate questions; idea engine (`14-independent-idea-engine`) gives users more than asked

## Behavioral Psychology

### Cialdini's 7 Principles (Ethical Only)

1. **Reciprocity** — free value first (tools, content, generous tier)
2. **Commitment** — free trial → paid, newsletter → product, micro-conversions
3. **Social Proof** — testimonials near CTAs, user counts, logo bars
4. **Authority** — credentials, press mentions, expert content
5. **Liking** — brand personality, photos, casual tone, shared values
6. **Scarcity** — ONLY when genuine. Never fake.
7. **Unity** — "We" language, community, shared mission

### Fogg Behavior Model

`Behavior = Motivation + Ability + Trigger` (at same moment)

- Don't ask push permissions on page load — ask after first success moment (high motivation + demonstrated ability)
- CTAs appear after value demonstrated, not before

### Kahneman's Key Biases

| Bias | Application |
|------|-------------|
| Anchoring | Show annual price first, monthly feels reasonable |
| Loss Aversion | "Don't lose your progress" > "Keep your progress" |
| Peak-End Rule | Make checkout confirmation + last impression amazing |
| Endowment Effect | "Your dashboard" not "A dashboard" |
| Status Quo Bias | Default to best option (annual billing, recommended plan) |

- **Zeigarnik Effect** — incomplete tasks create tension; use onboarding progress bars ("3 of 5 steps"), profile completion %, "You started but didn't finish..." emails
- **Flow State (Csikszentmihalyi)** — progressive disclosure, instant feedback, keyboard shortcuts for power users, minimize interruptions

## Design Psychology

### Golden Ratio Spacing

```css
:root {
  --space-xs: 0.382rem; --space-sm: 0.618rem; --space-md: 1rem;
  --space-lg: 1.618rem; --space-xl: 2.618rem; --space-2xl: 4.236rem;
}
```

### Color Psychology

- **Blue** — trust/security | **Cyan** — innovation (#00E5FF) | **Green** — success
- **Red** — urgency/error | **Orange** — warning | **White space** — premium

### Gestalt Principles

- **Proximity** — close = grouped | **Similarity** — consistent styles | **Closure** — progress bars
- **Figure/Ground** — CTAs contrast | **Continuity** — visual flow hero → features → CTA

## Ethical Line

DO: genuine social proof · real scarcity only · default to best for USER · give before asking · respect "no" · accessibility as moral imperative · transparent pricing/data/AI

NEVER: fake urgency timers · hidden costs · confirmshaming · forced continuity · misdirection · disguised ads · roach motels · trick questions · bait-and-switch

### Brian's Higher Pursuits

1. Employing disabled/paraplegic people at premium rates
2. 99% wealth donation — maximize impact
3. Spiritual investigation through technology
4. Same tech reshaping Wall Street, pointed at helping people

## Checklists

- **Servant** — serves user before business? Generous free tier? Helpful errors? Cancel easy as signup?
- **Simplicity** — one CTA/section? <7 options? 3 tiers? 5-second comprehension?
- **Trust** — real numbers? Transparent pricing? Genuine social proof? Plain English legal?
- **Excellence** — Apple-approved? Every pixel intentional? Beautiful loading? Delightful errors?
- **Psychology** — value before conversion? Social proof near CTAs? Progress bars? Annual first? Great last impression?
- **Ethics** — no fake urgency? No confirmshaming? No hidden costs? Easy unsubscribe/cancel/delete?

## Copy Patterns

- **Headlines** — "Your clean driveway feeds a family" (service), "One number. No hold music." (simplicity)
- **CTAs** — "Start helping today" > "Sign up now" | "Join 1,200 builders" > "Create account"
- **Errors** — "Something broke on our end. We're on it." (honesty + service)

## Hard Numbers from Studies

| Finding | Data | Source |
|---------|------|--------|
| Removing one form field | +4-8% conversion | BJ Fogg |
| "No credit card required" | 2x trial signups | Fogg |
| Loss framing vs gain | +32% conversion | Kahneman & Tversky |
| Free trials vs discounts | 15x conversion | Monetizely |
| Multi-step forms with progress | +86% vs single page | Formstack |
| 11→4 form fields | +120% conversion | Imagescape |
| Social proof with photo+name | +15-30% vs anonymous | CXL |
| Trust badges at checkout | +42% | Baymard |
| 6 jam vs 24 | 10x purchase (30% vs 3%) | Iyengar & Lepper |
| Endowed progress | 34% vs 19% completion | Nunes & Dreze |
| 1s page load delay | -7% conversion | Amazon |

- **Fitts's Law** — primary buttons large and near focus; mobile min 44×44px; group related actions
- **Meta-Filter** — (1) genuinely serves user? (2) honest? (3) respects autonomy? All yes → ship.

## Laws of UX (30 evidence-based)

- **Perception** — Aesthetic-Usability, Cognitive Load (progressive disclosure), Miller's Law (7±2), Selective Attention (CTAs unmissable)
- **Decision** — Hick's Law, Choice Overload (defaults/curation), Fitts's Law, Goal-Gradient (progress bars past 50%), Zeigarnik (onboarding checklists)
- **Memory** — Peak-End Rule (nail first + last), Serial Position (key items first/last), Von Restorff (CTAs visually distinct)
- **Gestalt** — Proximity, Similarity, Common Region (cards/containers), Uniform Connectedness, Pragnanz (clean layouts)
- **System** — Jakob's Law, Doherty Threshold (<400ms = instant), Tesler's Law, Postel's Law, Occam's Razor, Pareto (80/20), Parkinson's (tight deadlines)

## COM-B Diagnosis

When users aren't converting — diagnose: **Capability** (can they?), **Opportunity** (does environment allow?), **Motivation** (do they want?). Fix the actual bottleneck.

## 2026 Research

- **Handmade Designs** (NNGroup) — AI-fatigued users prefer human-crafted; anti-slop = trust signal
- **AI Agents as Users** (NNGroup) — design for both humans and AI; semantic HTML + structured data serve both
- **Less Chat, More Answer** (NNGroup) — direct scannable answers; lead with answer
- **YC Philosophy** — code is cheap, insight is rare; AI-native is baseline; focus on workflows, not features
slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack."Stars: 198kUpdated Claude CodeCodexVerifiedInstall
ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read.Stars: 196kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report.Stars: 196kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt.Stars: 196kUpdated Claude CodeCodexVerifiedInstall