perception-first-design

Run `npx skills add skovalik/perception-first-design --all -g -y` in your terminal to install the skill globally.

It is a five-layer diagnostic framework grounded in cognitive psychology that tells you which perceptual layer of a design is failing, in what order to fix it, and why the fix works.

Give your agent a URL, screenshot, or copy block and ask it to run PFD. It walks the artifact through all five layers and flags each violation with research citations.

Yes. The skill follows the universal SKILL.md standard and runs in Claude Code, Cursor, Codex, and other compatible agents.

Yes. You describe the page or problem in plain English, and the agent applies the psychology-backed layers to produce a clear diagnosis and fix order.