cognitive-biases

Apply cognitive bias knowledge to product design and decision-making. Use when designing user experiences, analyzing user behavior, improving conversions, or ensuring ethical design practices.

210 stars

Best use case

cognitive-biases is best used when you need a repeatable AI agent workflow instead of a one-off prompt.

Apply cognitive bias knowledge to product design and decision-making. Use when designing user experiences, analyzing user behavior, improving conversions, or ensuring ethical design practices.

Teams using cognitive-biases should expect a more consistent output, faster repeated execution, less prompt rewriting.

When to use this skill

  • You want a reusable workflow that can be run more than once with consistent structure.

When not to use this skill

  • You only need a quick one-off answer and do not need a reusable workflow.
  • You cannot install or maintain the underlying files, dependencies, or repository context.

Installation

Claude Code / Cursor / Codex

$curl -o ~/.claude/skills/cognitive-biases/SKILL.md --create-dirs "https://raw.githubusercontent.com/flpbalada/my-opencode-config/main/skills/cognitive-biases/SKILL.md"

Manual Installation

  1. Download SKILL.md from GitHub
  2. Place it in .claude/skills/cognitive-biases/SKILL.md inside your project
  3. Restart your AI agent — it will auto-discover the skill

How cognitive-biases Compares

Feature / Agentcognitive-biasesStandard Approach
Platform SupportNot specifiedLimited / Varies
Context Awareness High Baseline
Installation ComplexityUnknownN/A

Frequently Asked Questions

What does this skill do?

Apply cognitive bias knowledge to product design and decision-making. Use when designing user experiences, analyzing user behavior, improving conversions, or ensuring ethical design practices.

Where can I find the source code?

You can find the source code on GitHub using the link provided at the top of the page.

SKILL.md Source

# Cognitive Biases - Psychology for Product Design

Understanding psychological patterns that influence human decision-making, first systematically studied by Kahneman and Tversky. Essential for creating user experiences that work with human psychology.

## When to Use This Skill

- Designing user onboarding flows
- Improving conversion rates ethically
- Analyzing why users behave unexpectedly
- Reviewing designs for dark patterns
- Planning pricing and positioning strategies
- Understanding decision-making in user research

## Core Biases at a Glance

| Bias | What It Is | Application |
|------|-----------|-------------|
| **Anchoring** | First info becomes reference point | Show premium prices first |
| **Loss Aversion** | Losses feel 2x stronger than gains | Frame as "losing" vs "missing" |
| **Availability** | Overestimate what's easy to recall | Show success stories, social proof |
| **Confirmation** | Seek info confirming beliefs | Personalize onboarding |
| **Planning Fallacy** | Underestimate task duration | Give realistic time estimates |
| **Framing Effect** | Presentation changes perception | Use positive framing |
| **Sunk Cost** | Invest based on past costs | Highlight accumulated value |
| **Social Proof** | Look to others for guidance | Show testimonials, usage stats |
| **Scarcity** | Value rare things more | Use genuine limited offers |

---

## Progressive Disclosure

| Topic | File | When to Use |
|-------|------|-------------|
| All 9 core biases | [context/core-biases.md](context/core-biases.md) | Deep dive into each bias with examples |
| Analysis framework | [context/analysis-framework.md](context/analysis-framework.md) | Systematic analysis of user decisions |
| Ethics & examples | [context/examples-ethics.md](context/examples-ethics.md) | Real-world examples and dark patterns |

## Ethical Framework

```
Before applying a bias, ask:

1. Is this helping the user? → STOP if NO
2. Would I be comfortable if exposed? → STOP if NO
3. Does this create long-term value? → STOP if NO
4. Would this work on an informed user?
   → YES (persuasion) / NO (manipulation)
```

## Quick Reference

```
Acquisition:
├── Social Proof → "Join 50,000+ users"
├── Anchoring → Show premium first
└── Scarcity → "Limited beta access"

Activation:
├── Commitment → Small first steps
├── Planning Fallacy → Realistic estimates
└── Loss Aversion → Show progress at risk

Retention:
├── Sunk Cost → "Your history, connections"
├── Confirmation → Personalized experience
└── Social Proof → "Your team uses this"
```

## References

- [Thinking, Fast and Slow - Daniel Kahneman](https://www.goodreads.com/book/show/11468377-thinking-fast-and-slow)
- [Predictably Irrational - Dan Ariely](https://danariely.com/books/predictably-irrational/)
- [Hooked - Nir Eyal](https://www.nirandfar.com/hooked/)
- [Dark Patterns Hall of Shame](https://darkpatterns.org/)

Related Skills

cognitive-load

210
from flpbalada/my-opencode-config

Design experiences that optimize mental resources using Cognitive Load Theory. Use when designing interfaces, creating onboarding flows, planning information architecture, or improving task completion rates.

cognitive-fluency-psychology

210
from flpbalada/my-opencode-config

Apply cognitive fluency principles to improve clarity, trust, and conversion. Use when designing landing pages, writing copy, creating interfaces, or optimizing any content for better user comprehension and engagement.

what-not-to-do-as-product-manager

210
from flpbalada/my-opencode-config

Anti-patterns and mistakes to avoid as a product manager. Use when evaluating leadership behaviors, improving team dynamics, reflecting on management practices, or onboarding new product managers.

visual-cues-cta-psychology

210
from flpbalada/my-opencode-config

Design effective CTAs using visual attention and gaze psychology principles. Use when designing landing pages, button hierarchies, conversion elements, or optimizing user attention flow through interfaces.

vercel-sandbox

210
from flpbalada/my-opencode-config

Run agent-browser + Chrome inside Vercel Sandbox microVMs for browser automation from any Vercel-deployed app. Use when the user needs browser automation in a Vercel app (Next.js, SvelteKit, Nuxt, Remix, Astro, etc.), wants to run headless Chrome without binary size limits, needs persistent browser sessions across commands, or wants ephemeral isolated browser environments. Triggers include "Vercel Sandbox browser", "microVM Chrome", "agent-browser in sandbox", "browser automation on Vercel", or any task requiring Chrome in a Vercel Sandbox.

value-realization

210
from flpbalada/my-opencode-config

Analyze if end users discover clear value. Use when evaluating product concepts, analyzing adoption, or uncertain about direction.

user-story-fundamentals

210
from flpbalada/my-opencode-config

Capture requirements from user perspective with structured user stories. Use when writing backlog items, defining acceptance criteria, prioritizing features, or communicating requirements between product and development.

typescript-satisfies-operator

210
from flpbalada/my-opencode-config

Guides proper usage of TypeScript's satisfies operator vs type annotations. Use this skill when deciding between type annotations (colon) and satisfies, validating object shapes while preserving literal types, or troubleshooting type inference issues.

typescript-interface-vs-type

210
from flpbalada/my-opencode-config

Guides when to use interface vs type in TypeScript. Use this skill when defining object types, extending types, or choosing between interface and type aliases.

typescript-best-practices

210
from flpbalada/my-opencode-config

Guides TypeScript best practices for type safety, code organization, and maintainability. Use this skill when configuring TypeScript projects, deciding on typing strategies, writing async code, or reviewing TypeScript code quality.

typescript-advanced-types

210
from flpbalada/my-opencode-config

Master TypeScript's advanced type system including generics, conditional types, mapped types, template literals, and utility types for building type-safe applications. Use when implementing complex type logic, creating reusable type utilities, or ensuring compile-time type safety in TypeScript projects.

trust-psychology

210
from flpbalada/my-opencode-config

Build trust signals that reduce perceived risk and enable user action. Use when designing landing pages, checkout flows, onboarding experiences, or any conversion point where user hesitation is a barrier.