In short:
ak-enhance-ux-axtakes screenshots at 3 viewports, scans discovery surfaces such asrobots.txt,sitemap.xmlandllms.txt, then writes a report with Must, Should and Could proposals and a DONE contract. The report goes on toak-planthenak-cook, or you add--autoor--loopand it fixes things itself. By default it does not touch code.
Disclosure: I maintain AgentKit and have an affiliate relationship with it: the AgentKit link in this post is an affiliate link; buying through it gets you 30% off.
Summary
Use it when you already have a running site or app, but it is easy to forget, hard to understand, or AI and search engines cannot read it. You do not need it for keyword research or an SEO/GEO-only audit (that is ak-seo), or for building a new interface or UI-only polish (that is ak-frontend-design).
flowchart LR
A["Existing site or app"] --> B["ak-enhance-ux-ax"]
B --> C["Report: scores, proposals, DONE contract"]
C --> D["ak-plan then ak-cook"]
B --> E["--auto or --loop: fix and check until DONE"]
E --> F["Stops at DONE, out of rounds, or when blocked"]Four concepts to know:
| Concept | Question | Example |
|---|---|---|
| UX and AX | Does this page let both human readers and AI understand it and repeat it back? | A stranger looks at the hero for 5 seconds and knows what the product is (UX); ChatGPT can fetch the page's .md version and quote the right point (AX) |
| 0 to 3 score | What level is each UX area at, and what is the evidence? | "Brand recall: 1, screenshot mobile-home-loaded.png shows the logo and main color are completely different from the social card." Any area below 2 must get at least one proposal. |
| Must, Should, Could | What gets fixed first? | Must: robots.txt blocks PerplexityBot site-wide. Should: rewrite the hero headline so the outcome is clear. Could: add page transitions. |
| DONE contract | What evidence shows the fix is finished? | The discovery-surface scan script exits with code 0; screenshots at 1440×900, 768×1024, 375×812 show no horizontal overflow; build, lint and tests pass; any dev servers it started are stopped |
The first argument (a URL, a path, or a topic such as seo or hero) narrows the review, but the DONE contract still covers everything that gets touched, and the fix modes may not loosen it.
Sample prompt to review a landing page:
/ak-enhance-ux-ax http://localhost:3000
Project: landing page for <product name>.
Priority: a newcomer understands the product in 5 seconds, AI can cite the page.
Only write the report, do not change code yet.| Flag | What it is for | Since ak |
|---|---|---|
--auto | After the review, fix things until DONE is met | 2.19.0 |
--loop [N] | Run N rounds of review, fix, and screenshot checks | 2.19.0 |
Below is the detailed version: the run flow, 5 situations with prompts, each flag explained (when to use it, when you do not need it, what you get, which flags it combines with), the change history by ak release, and common pitfalls. The detailed version and the interactive page are for subscribers. Your agent can also search them through the portal's MCP.
Opens when your account has subscriber access
This guide is for subscribers
Once your account has access, the full piece, the interactive visual and the agent call all open.
- Sign in or create a modernEngineer accountReading access belongs to your account email.
- Choose a plan on the pricing page1, 3 or 12 months, paid by VietQR bank transfer. Access opens about a minute after the money arrives.
- Or redeem a Facebook subscriber codePeople supporting the page on Facebook get an activation code by message each month.
Already a subscriber? Sign in to read.
Use this piece in your agent
Get an API keyCopy the text below and paste it into Claude Code, Codex or whichever agent you use. The agent reads the piece and checks it against the repo you have open.
Read "ak-enhance-ux-ax: review the experience for people and for AI" on modernEngineer and apply it to this repo.
1. Call the content_get tool of the modernengineer MCP server with locale "en", slug "ak-enhance-ux-ax". If the modernengineer MCP server is not connected, stop and walk me through connecting it from https://modernengineer.dev/en/mcp.
2. Summarize the main steps of the piece and point out which apply to this repo.
3. Propose concrete changes and ask me before editing any file.Connect MCP in Claude Code (once)
claude mcp add --transport http modernengineer \
https://api.modernengineer.dev/mcp \
--header "Authorization: Bearer <API key>"Reading the full piece over MCP needs an API key from a subscriber account or one that bought this guide. Without access, the agent only gets the opening.
- Version
- v1.0.0
- Updated
- 22/10/2026
- Licence
- All rights reserved
- Slug
- ak-enhance-ux-ax
