Guided Journey · Improve × Website

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.

Written to your repo
  • docs/METRICS.md
  • docs/WEBSITE.md
  • docs/EXPERIMENTS.md
  • docs/DESIGN.md
  • docs/POSITIONING.md
  • docs/IMPROVE-WEBSITE-PLAN.md journey tracker — stop anytime, resume any session

One prompt runs it

Every phase asks before it acts, and every decision lands in your project’s docs/ folder as a living document — quit anytime, resume in any session.

Use it when you need to
  • Find out why visitors don't convert before redesigning anything
  • Remove usability friction with severity-ranked audits
  • 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
Install this metaskill
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.

Journey Map

8 phases, one deliberate order

Each phase invokes one skill from the library, asks you the decision question, and writes the answer to your project’s docs/ before moving on.

  1. 01 Why don't visitors convert, and which fix moves the most money? CRO Methodology cro-methodology → docs/METRICS.md + docs/WEBSITE.md + docs/EXPERIMENTS.md Gate
  2. 02 Where do visitors stumble before they weigh the offer? UX Heuristics ux-heuristics → docs/DESIGN.md + docs/EXPERIMENTS.md
  3. 03 Does the page look as clear as it reads? Refactoring UI refactoring-ui → docs/DESIGN.md + docs/EXPERIMENTS.md
  4. 04 Can visitors comfortably read the copy? Web Typography web-typography → docs/DESIGN.md + docs/EXPERIMENTS.md
  5. 05 Does a stranger grasp the offer in five seconds? StoryBrand Messaging storybrand-messaging → docs/POSITIONING.md + docs/EXPERIMENTS.md
  6. 06 Does the page arrive before patience runs out? High Perf Browser high-perf-browser → docs/METRICS.md + docs/WEBSITE.md + docs/EXPERIMENTS.md
  7. 07 Is the idea memorable enough to survive to the decision? Made to Stick made-to-stick → docs/POSITIONING.md + docs/EXPERIMENTS.md
  8. 08 Do the visitors who act ever get stuck? Design of Everyday Things design-everyday-things → docs/DESIGN.md + docs/EXPERIMENTS.md
In Practice

Fix a Website That Doesn't Convert

Traffic is fine; signups aren't. You want evidence-driven fixes, not a redesign lottery.

Our site gets [N] visits/month but converts at [X]%. Run the
improve-website journey: diagnose why visitors leave, then fix
usability, hierarchy, typography, message, and speed — every
change as a testable experiment in docs/EXPERIMENTS.md.

Use improve-website skill.
Example Prompts

Try these with the skill installed

Our landing page isn't converting — diagnose it and fix it phase by phase. using improve-website skill

Conversion diagnosis

Audit and improve our site end to end, evidence first. using improve-website skill

Full site audit

Resume the website improvement journey. using improve-website skill

Resume journey
The Source

Born from a guide

This journey packages the playbook below as a single skill — the guide is the long-form read behind every phase.

Improve · Website

How to Improve an Existing Website with AI Skills

Diagnose and fix an underperforming website — conversion, usability, messaging, speed, and polish — with AI agent skills from Making Websites Win, Don't Make Me Think, Refactoring UI, and more.

16 min read
More Journeys

Twelve journeys, one library

Create · Business

Create a Business

10 phases Create · Website

Create a Website

10 phases Create · App

Create an App

10 phases Improve · Business

Improve a Business

8 phases Improve · App

Improve an App

9 phases Grow · Business

Grow a Business

9 phases Grow · Website

Grow a Website

8 phases Grow · App

Grow an App

8 phases Engineering

Improve Code Quality

9 phases Engineering

Remove Technical Debt

8 phases Engineering

Design Code Architecture

8 phases

Install Improve a Website

Free, open-source, and ready in 30 seconds.

npx skills add wondelai/skills/improve-website --global
Browse on GitHub See All Skills

MIT Licensed · Works with Claude, Claude Code, Claude Cowork, Codex, Cursor, OpenClaw, Hermes Agent & other agentskills.io agents · No account needed

Prove it

Don’t guess your AI engineering level.
Measure it.

25 questions · ~8 min · Free

For hands-on developers

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 & founders

CTO 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 org
Work with us

We build the skills you already use. Now we’ll build yours.

Custom skills · Subagents · MCP integrations — shipped to production, not demoed.

See what we build Book a 15-min call

Sprints from $3K · shipped to production, or you don’t pay the final milestone.