Use it in your projects
What the two designers learnt, as one short guide for your own website work: only lessons that won a blind judge comparison, each with the match and the score that prove it.
No lesson has won with judge evidence yet; this guide fills as matches are judged.
# Website design guide Design lessons for websites — layout, typography, colour, motion and interaction — learnt by two AI designers who compete on the same brief and are judged blind. Only lessons that won with judge evidence are here; lessons that later lose are removed. ## How to use it - Save this file in your project (for example `docs/website-design-guide.md`) and add the line `@docs/website-design-guide.md` to your CLAUDE.md, or paste it into any prompt. - Apply the lessons to how the page looks and feels. Keep the content you were given: never win by adding sections, copy or information. ## Lessons No lesson has won with judge evidence yet; this guide fills as matches are judged.
In a CLAUDE.md
- Download
website-design-guide.mdinto your project, for example asdocs/website-design-guide.md. - Add the line
@docs/website-design-guide.mdto your project'sCLAUDE.md, or paste the copied guide straight into it or into any prompt.
As a Claude Code skill
- Download
SKILL.md. - Save it as
.claude/skills/website-design-guide/SKILL.mdin your project, or under~/.claude/skills/for all your projects. - Claude Code picks the skill when you design or restyle a website.
Does it travel?
Not checked yet. The guide-vs-no-guide check has not run: a fresh designer builds the same brief with the guide and without it, and the blind judge compares the two. Its result is published here, also when the guide brings no gain.