{
 "schema": "aiblocks-page/1",
 "id": "agency-design-persona-walkthrough",
 "type": "agent",
 "name": "Simulated user walkthrough reviewer",
 "summary": "Get a persona walkthrough of your web page. See what a visitor thinks at each scroll, where they doubt or leave, and the fixes ranked.",
 "headline": "Simulated user walkthrough reviewer",
 "subhead": "Give it your page and a short profile of one visitor. It reads the page as that person, one screen at a time, and writes what they think in their own words. You get scores, the moment they nearly left, and fixes ranked by effort.",
 "job": {
  "id": "audit-landing-page",
  "name": "Audit a landing page"
 },
 "level": "intermediate",
 "thinking": "high",
 "tested": true,
 "updated": "2026-11-03",
 "first_published": "2026-10-26",
 "inputs": [
  {
   "type": "web_page",
   "required": true,
   "label": "Web page",
   "what": "a built or live web page, as a URL or saved HTML"
  },
  {
   "type": "persona",
   "required": false,
   "label": "Persona",
   "what": "a buyer grounded in real review language: problem, trigger, wants, doubts, words they use"
  }
 ],
 "outputs": [
  {
   "type": "audit_report",
   "required": true,
   "label": "Audit report",
   "what": "findings with evidence, severity, missing inputs and next actions"
  }
 ],
 "you_give": [
  "Your page, as a link your AI can open, one screenshot per screen, or the page text",
  "Who the visitor is, such as age, country, what is happening in their life, and what they fear",
  "The words they typed into Google, or the ad they clicked",
  "What you want them to do, such as call, buy or send the form",
  "Competitor pages they saw first (optional)"
 ],
 "you_get": [
  "The visitor profile written back, so you can fix it before the walkthrough",
  "A five-second test with a clear yes or no on each of the three questions",
  "One entry per screen, with the visitor's thoughts and a separate expert note",
  "A verdict with three scores out of 10, plus the moment they almost left and the moment they were most engaged",
  "Fixes ranked as quick wins, bigger changes and long-term ideas"
 ],
 "use_when": [
  "Your page gets visits but few calls, sales or form sends, and you do not know why.",
  "You are about to send ad traffic to a new landing page and want a fresh pair of eyes first.",
  "Your page serves two kinds of visitor and you want to see where their needs clash.",
  "A visitor has just left a polished competitor and you want to see how your page feels next."
 ],
 "skip_when": [
  "You want a quick score and fix list from the page alone, with no visitor profile. Use the Landing page conversion reviewer or the 30-point landing page checker.",
  "You need proof from real people. This only simulates one visitor. Use the UX Researcher agent to plan a real test.",
  "You have interview notes and want personas built from them. Use the User persona and journey mapper.",
  "You have no page yet and want to write one. Use the Ad-matched landing page writer."
 ],
 "output_sample": {
  "input": [
   "Your page, as a link, screenshots or pasted text",
   "A short profile of one visitor and the words they searched",
   "What you want the visitor to do on the page",
   "Competitor pages they saw first (optional)"
  ],
  "prerequisites": [
   "An AI you can paste a long brief into, such as Claude, ChatGPT or Gemini",
   "A browser tool or screenshots, so the AI can see the real page"
  ],
  "output": [
   {
    "name": "Visitor profile",
    "contains": "The visitor as the AI understood them, so you can correct it before the walkthrough starts."
   },
   {
    "name": "Five-second test",
    "contains": "A yes or no on what the page is, whether it is for the visitor and what to do next."
   },
   {
    "name": "Screen-by-screen entries",
    "contains": "For each screen, the visitor's raw thoughts and a separate analyst note on trust, mood and missing proof."
   },
   {
    "name": "Verdict",
    "contains": "Confidence, clarity and relevance scores out of 10, plus the moment of near exit and of most interest."
   },
   {
    "name": "Ranked fixes",
    "contains": "Quick wins, bigger changes and long-term ideas, each tied to a screen and a reaction."
   },
   {
    "name": "Checks still needed",
    "contains": "What to confirm with real visitors or your analytics before you trust the findings."
   }
  ]
 },
 "output_shape": "VISITOR PROFILE\n  <name, age, situation> | search words: <what they typed> | fears: <list> | decides: <fast or slow> | style: <anxious, secure or avoidant>\n\nLIMITS\n  <qualitative simulation, not statistical evidence> | page seen via: <link, screenshots or text>\n\nBEFORE THE PAGE\n  <3 to 5 lines in the visitor's voice> | page must deliver in 3 seconds: <list>\n\nFIVE-SECOND TEST\n  What is this: <yes or no, why> | Is it for me: <yes or no, why> | What do I do: <yes or no, why>\n\nSCREEN <n>\n  VISITOR: <raw thoughts in first person>\n  ANALYST: mood <word> | trust <up or down, why> | LIFT <factor> | principles present <list> | missing <list> | can act now <yes or no>\n\nVERDICT\n  confidence <1-10> | clarity <1-10> | relevance <1-10> | would contact <yes, no or maybe, why>\n  strengths <3> | weaknesses <3> | almost left at <screen, trigger> | most engaged at <screen, trigger>\n\nFIXES\n  <quick win, major improvement or strategic> | <title> | screen <n> | principle <name> | what <change> | why <reaction it answers>\n\nCHECKS STILL NEEDED\n  <item> | <how to settle it with real visitors or analytics>",
 "how_to_use": [
  "Download the pack from this page and add it to your AI as a skill. Or paste SKILL.md into a new chat, then paste references/source-agent.md after it.",
  "Describe your visitor in a few lines. Include the Google search, what they fear and how fast they decide. Your AI asks once for anything missing.",
  "Give it the page. An AI with a browser can open the link. Otherwise attach one screenshot per screen, top to bottom, at phone width.",
  "Say \"Walk through this page as my visitor.\" Check the profile it shows back and fix anything wrong before it goes on.",
  "Read the five-second test first. If the visitor cannot say what the page is, who it is for and what to do, fix that before anything else.",
  "Change the page, then run the same visitor again to compare. Test the top weakness with real visitors."
 ],
 "checks": [
  "The result addresses your actual task and cites the evidence used.",
  "Examples, role-play experience and targets are kept separate from verified results.",
  "Claims of tests, memory, tool access or completed actions match what actually happened."
 ],
 "next": [
  {
   "name": "Landing page copy repair reviewer",
   "url": "https://useaiblocks.com/skills/landing-page-fix-loop",
   "why": "Check the landing page"
  },
  {
   "name": "UX researcher agent",
   "url": "https://useaiblocks.com/skills/agency-design-ux-researcher",
   "why": "Understand your buyers"
  }
 ],
 "source": {
  "by": "Michael Sitarzewski and Agency Agents contributors",
  "repo": "msitarzewski/agency-agents",
  "url": "https://github.com/msitarzewski/agency-agents/blob/b37b5bb33b78f2c1d6567d98e25ca818e3259219/design/design-persona-walkthrough.md",
  "licence": "MIT",
  "original_name": "Persona Walkthrough Specialist",
  "commit": "b37b5bb33b78f2c1d6567d98e25ca818e3259219"
 },
 "credits": [
  {
   "title": "Persona Walkthrough Specialist",
   "by": "Michael Sitarzewski and Agency Agents contributors",
   "url": "https://github.com/msitarzewski/agency-agents/blob/b37b5bb33b78f2c1d6567d98e25ca818e3259219/design/design-persona-walkthrough.md",
   "used": "Original agent profile, preserved in references/source-agent.md; AI Blocks adds setup and review instructions."
  }
 ],
 "files": [
  "LICENSE",
  "references/source-agent.md",
  "SETUP.md",
  "source.json"
 ],
 "links": {
  "page": "https://useaiblocks.com/agents/agency-design-persona-walkthrough",
  "markdown": "https://useaiblocks.com/agents/agency-design-persona-walkthrough.md",
  "json": "https://useaiblocks.com/agents/agency-design-persona-walkthrough.json",
  "instructions": "https://useaiblocks.com/skills/agency-design-persona-walkthrough/SKILL.md",
  "download": "https://useaiblocks.com/skills/agency-design-persona-walkthrough.zip",
  "api_item": "https://useaiblocks.com/api/v1/items/agency-design-persona-walkthrough",
  "api_document": "https://useaiblocks.com/api/v1/documents/agent/agency-design-persona-walkthrough",
  "mcp": "https://useaiblocks.com/mcp"
 }
}
