Improve a Website
Diagnose, fix, and prove website improvements
Takes you from a live website that underperforms to a prioritized, evidence-backed backlog of conversion, usability, message, and speed fixes - each shipped as a testable experiment. It orchestrates its eight skills phase by phase, asking you the decision questions at every step and recording every result in your project's docs/ folder so the journey resumes across sessions.
What is the Improve a Website journey?
Traffic arrives, conversions do not. This journey turns that gap into a ranked, evidence-backed queue of fixes across conversion, usability, hierarchy, typography, message and speed. Eight phases, each posing one decision question and writing its findings to docs/, so a redesign never becomes a guess you cannot revert.
One prompt runs it
npx skills add wondelai/skills/improve-website --global This skill is compatible with Claude, Claude Code, Claude Cowork, Codex, Cursor, OpenClaw, Hermes Agent, and other agentskills.io-compatible agents.
Example prompts for the Improve a Website journey
Our landing page isn't converting — diagnose it and fix it phase by phase. using improve-website skill
Conversion diagnosisAudit and improve our site end to end, evidence first. using improve-website skill
Full site auditResume the website improvement journey. using improve-website skill
Resume journeyWhen to use Improve a Website — and when not to
Reach for it when
- Find out why visitors don't convert before redesigning anything
- Rank usability problems by severity so the worst ones get fixed first
- Fix visual hierarchy, typography, and page speed systematically
- Sharpen the message so a first-time visitor gets it in five seconds
- Turn every change into an experiment you can prove or revert
Reach for something else when
- You have no site yet — Create a Website builds one message-first instead of diagnosing an existing one.
- Conversion is already healthy and you want more from it — Grow a Website layers capture, offer and shareability on top.
- You only need a page-speed pass — High Perf Browser handles that alone, without seven other audits.
- The interface is a product rather than a marketing page — Improve an App covers in-app flows and copy.
Frequently asked questions
How do I install the Improve a Website journey?
Run npx skills add wondelai/skills/improve-website --global. It takes about 30 seconds and needs no account. The Improve a Website skill then works in Claude, Claude Code, Claude Cowork, Codex, Cursor, OpenClaw and Hermes Agent — anything that reads the open agentskills.io format — and your agent loads it on its own when a task calls for it. It is free and MIT-licensed, and the source is at https://github.com/wondelai/skills.
Which skills does the Improve a Website journey run, and what does it produce?
It orchestrates 8 skills across 8 phases — CRO Methodology, UX Heuristics, Refactoring UI, Web Typography, StoryBrand Messaging, High Perf Browser, Made to Stick, Design of Everyday Things — asking you one decision question per phase. Each answer is written to your project's docs/ folder (docs/METRICS.md, docs/WEBSITE.md, docs/EXPERIMENTS.md, docs/DESIGN.md, docs/POSITIONING.md, docs/IMPROVE-WEBSITE-PLAN.md), so the journey survives across sessions and you keep the reasoning, not just the output.
Why does conversion diagnosis come first and gate everything else?
Because every phase after it costs time, and without the diagnosis you cannot say which is worth running. The CRO phase maps the funnel, finds where the money leaks and ranks the candidates in docs/METRICS.md and docs/EXPERIMENTS.md. If the drop-off is in checkout, the typography phase can wait. The gate exists to stop the default failure mode: redesigning the page that was already fine.
Every phase writes to docs/EXPERIMENTS.md. Do I have to A/B test everything?
No — the file records the change, the reason and what you expect it to move, whether or not you run a formal test. Some fixes are obvious enough to ship straight: a broken form label, a four-second load. Others deserve a real experiment. What the journey refuses is an untraceable change — if conversion moves next month, docs/EXPERIMENTS.md is what tells you which of the eight phases moved it.
How does this differ from Grow a Website?
Improve fixes what is broken; Grow adds what is missing. This journey ranks defects — usability friction, weak hierarchy, unreadable type, a message nobody parses in five seconds, a slow page — and turns each into a revertible change. Grow a Website assumes those basics hold and builds lead capture, proof, a stronger offer and shareability on top. Run this one first if visitors are stumbling rather than merely unpersuaded.
Can I stop after the first two phases?
Yes, and many should. CRO and UX Heuristics usually account for the largest single movement, and docs/IMPROVE-WEBSITE-PLAN.md will hold the remaining six open indefinitely. Come back once those fixes have shipped and you have fresh numbers — the later phases on message, speed and affordances are more useful when the obvious leaks are already sealed.
Install Improve a Website
Free, open-source, and ready in 30 seconds.
npx skills add wondelai/skills/improve-website --global MIT Licensed · Works with Claude, Claude Code, Claude Cowork, Codex, Cursor, OpenClaw, Hermes Agent & other agentskills.io agents · No account needed
Don’t guess your AI engineering level.
Measure it.
AI Developer Scorecard
How production-grade is your AI engineering?
Twenty-five questions across the practices that separate vibe-coding from production-grade engineering. Instant score, per-section breakdown, and a 30/60/90-day playbook.
Score 0–75 · 30/60/90-day playbook Score yourself For CTOs & foundersCTO Scorecard
Is your engineering team ready for AI at scale?
Twenty-five questions on how your org adopts AI — adoption, governance, automation, and ROI. See where you sit on the path from Reactive to Strategic Leader.
Score 0–75 · Reactive → Strategic Leader Score your orgWe build the skills you already use. Now we’ll build yours.
Sprints from $3K · shipped to production, or you don’t pay the final milestone.