# cognitive-design

cognitive-design is a Claude Code skill that explains design choices through cognitive psychology. Apply it to interfaces, dashboards, data visualizations, and educational content.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 134 installs · ★ 203 repo stars
- Author: lyndonkl
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/lyndonkl/claude/tree/HEAD/skills/cognitive-design/SKILL.md
- Updated: 2026-09-01
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/cognitive-design

## What it does

cognitive-design replaces guesswork with principles. It teaches how to manage user attention, respect working memory limits (around 4±1 chunks), apply Gestalt grouping, and encode information visually so it's easier to parse. The skill includes three frameworks: Cognitive Design Pyramid rates design quality across four tiers (perceptual efficiency, cognitive coherence, emotional engagement, behavioral alignment); Design Feedback Loop maps the cycle of perception-interpretation-decision-action; Three-Layer Visualization Model connects data representation to cognitive interpretation.

Resources cover foundations (why attention and memory matter, preattentive processing, visual salience) and domain-specific guidance for data visualization, product/UX design, and educational design. A quick three-question check—Is hierarchy clear? Can the user avoid memorizing information that could be shown? Will a stranger understand in 5 seconds?—works as a rapid gate. Works alongside `design-evaluation-audit` for systematic reviews, `cognitive-fallacies-guard` to catch perceptual tricks, and `visual-storytelling-design` for data narrative.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add lyndonkl/claude --skill cognitive-design -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/cognitive-design/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/cognitive-design/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add lyndonkl/claude --skill cognitive-design -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/cognitive-design/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add lyndonkl/claude --skill cognitive-design -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/cognitive-design/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install lyndonkl/claude skills/cognitive-design
```

2. **Manually: put the files in place**
- File: `.github/skills/cognitive-design/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add lyndonkl/claude --skill cognitive-design -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/lyndonkl/claude --path skills/cognitive-design
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/cognitive-design/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add lyndonkl/claude --skill cognitive-design -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/lyndonkl/claude/tree/HEAD/skills/cognitive-design/SKILL.md

## When to use it
- pick the right chart type for the analysis task
- arrange interface elements so they're obvious at a glance
- reduce how much users must hold in working memory
- design learning materials that stick
- justify design decisions with research instead of taste

## Example prompts
- Design a dashboard dashboard for analytics; help me apply Cognitive Design Pyramid
- Why does this chart feel harder to read than it should? Check it against preattentive processing
- What's the right way to organize form fields to minimize cognitive load?

## Similar
- [design-principles](https://affpapa.org/en/nevibecode/skills/design-principles.md) — skill · 2500 installs
- [design-review](https://affpapa.org/en/nevibecode/commands/alexj11324-design-review.md) — command · ★ 88 repo stars
- [apple-design](https://affpapa.org/en/nevibecode/skills/dickwu-apple-design.md) — skill · 16300 installs
- [mobile-app-ui-design](https://affpapa.org/en/nevibecode/skills/mobile-app-ui-design.md) — skill · 13200 installs
- [penpot-uiux-design](https://affpapa.org/en/nevibecode/skills/penpot-uiux-design.md) — skill · 12782 installs
- [design-is](https://affpapa.org/en/nevibecode/skills/design-is.md) — skill · 4700 installs

From the same set: [lyndonkl/claude](https://affpapa.org/en/nevibecode/by/lyndonkl/claude.md) — 49 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
