{
 "schema": "aiblocks-page/1",
 "id": "persona-stage-theme-matrix-planner",
 "type": "skill",
 "name": "Buyer-stage ad theme planner",
 "summary": "Map your buyers, their awareness stage and nine ad themes. Find gaps and get the ten best ad cells to make next, ranked.",
 "headline": "Buyer-stage ad theme planner",
 "subhead": "Give it your buyer evidence, such as reviews or customer notes, plus past ad results and what you can make. It builds a matrix of buyer, awareness stage and ad theme, and ranks the 10 cells to make next. Each pick says what evidence backs it.",
 "job": {
  "id": "plan-ad-tests",
  "name": "Plan what ads to test"
 },
 "level": "intermediate",
 "thinking": "medium",
 "tested": true,
 "updated": "2026-11-03",
 "first_published": "2026-10-25",
 "inputs": [
  {
   "type": "voc_reviews",
   "required": false,
   "label": "Voc reviews",
   "what": "customer words from reviews, tickets, surveys or calls, with source and date"
  },
  {
   "type": "performance_sheet",
   "required": false,
   "label": "Performance sheet",
   "what": "ad or store performance export for a closed date window, with definitions"
  },
  {
   "type": "brand_brain",
   "required": false,
   "label": "Brand brain",
   "what": "the brand's facts, voice, products, offers (with effective dates), claims register, personas and look"
  }
 ],
 "outputs": [
  {
   "type": "plan",
   "required": true,
   "label": "Plan",
   "what": "a dated plan: what to do, in what order, with a decision rule for each step"
  }
 ],
 "you_give": [
  "Customer evidence, such as reviews, survey answers, support notes or sales calls",
  "Your product, and what your buyers want or fear",
  "Past ads with their results by theme, stage or buyer (optional)",
  "How your spend splits between cold, warm and ready-to-buy buyers (optional)",
  "How many ads you can make in one sprint"
 ],
 "you_get": [
  "Three to five buyer profiles, each tied to your evidence",
  "A matrix for each buyer rating nine themes against five stages as strong, medium, weak or skip",
  "The top 10 cells to make next, each with a reason and an evidence tag",
  "Empty cells that should be filled",
  "Cells to drop, but only when you gave results",
  "A MISSING list for anything you did not give"
 ],
 "use_when": [
  "You are planning a quarter of ads and want to know what to make, and in what order.",
  "Your ad output feels random and nobody can say why one ad was made over another.",
  "Your ads all lean on one theme or one stage and you want to see the holes.",
  "One buyer group is not converting and you want to see what you have tried for them."
 ],
 "skip_when": [
  "You only have product facts and reviews and want 30 to 40 persona and angle ideas. Use the Ad concept testing planner.",
  "You want briefs written for the gaps. Use the Ad production brief planner.",
  "You want to see how your live ads spread across concept types. Use the Meta ad concept test planner.",
  "You need ads for one funnel stage only. Use the Sales funnel ad brief writer.",
  "You have no customer words and no sales history. You would get a starter matrix to test, not a finding. Collect reviews first."
 ],
 "output_sample": {
  "input": [
   "Customer evidence, such as reviews, survey answers or sales notes",
   "Your product, and what your buyers want or fear",
   "Past ads and their results (optional)",
   "How many ads you can make in one sprint"
  ],
  "prerequisites": [
   "Your customer words, which you can pull from reviews, support emails or call notes (optional, but without them the matrix is a starter to test)"
  ],
  "output": [
   {
    "name": "Buyers",
    "contains": "Three to five buyer profiles with age range, pain or want and doubts, each tied to your evidence or marked as an assumption."
   },
   {
    "name": "Matrix",
    "contains": "For each buyer, nine themes rated strong, medium, weak or skip across five awareness stages."
   },
   {
    "name": "Top 10 cells",
    "contains": "The ten buyer, stage and theme combinations to make next, each with a reason and an evidence tag."
   },
   {
    "name": "Empty cells",
    "contains": "Combinations you have not made that you should."
   },
   {
    "name": "Cells to drop",
    "contains": "Combinations that ran with no sales. Shown only when you gave results."
   },
   {
    "name": "Missing list",
    "contains": "Evidence or results you did not give."
   }
  ]
 },
 "output_shape": "EVIDENCE USED: <reviews, survey, results, or \"none: starter matrix\">\n\nBUYERS (3 to 5)\n<name> | <age range> | <main pain or want> | <doubts> | <evidence or ASSUMPTION>\n\nMATRIX (one per buyer)\n             Unaware | Problem | Solution | Product | Most aware\n<theme>      <rating> ...        (strong | medium | weak | skip)\n\nTOP 10 CELLS TO MAKE NEXT\n1 <buyer> x <stage> x <theme> | why <...> | evidence <DATA | CUSTOMER WORDS | ASSUMPTION>\n...\nSpread in the top 10: <n> buyers, <n> stages, <n> themes\n\nEMPTY CELLS THAT SHOULD BE FILLED\n<cell> | <why>\n\nCELLS TO DROP\n<cell> | <ads run and results> (or \"none: no results given\")\n\nMISSING: <...>",
 "how_to_use": [
  "Open the skill in Claude, ChatGPT or Gemini, or paste it into a new chat. It needs no code or web access.",
  "Paste your customer evidence and past ad results. Add how many ads you can make.",
  "Check each buyer profile. Delete any you do not recognise and fix the wants and doubts.",
  "Read the top 10. Each is tagged DATA, CUSTOMER WORDS or ASSUMPTION. Test the assumptions first.",
  "Turn the top cells into briefs with the Creative gap-to-brief queue planner. Come back after a month of results."
 ],
 "checks": [],
 "next": [
  {
   "name": "Core customer benefit finder",
   "url": "https://useaiblocks.com/skills/what-you-really-sell-finder",
   "why": "Plan what to test"
  }
 ],
 "source": null,
 "credits": [],
 "files": [
  "references/knowledge-library-persona-stage-theme-matrix.md",
  "references/knowledge-library-prompt-pipeline-diagram.md",
  "references/knowledge-library-theme-library-catalog.md",
  "references/persona-stage-theme-matrix.md",
  "references/persona-stage-theme-prompt-pack.md",
  "references/persona-stage-theme-sample-output.md",
  "references/persona-stage-theme-when-to-use.md"
 ],
 "links": {
  "page": "https://useaiblocks.com/skills/persona-stage-theme-matrix-planner",
  "markdown": "https://useaiblocks.com/skills/persona-stage-theme-matrix-planner.md",
  "json": "https://useaiblocks.com/skills/persona-stage-theme-matrix-planner.json",
  "instructions": "https://useaiblocks.com/skills/persona-stage-theme-matrix-planner/SKILL.md",
  "download": "https://useaiblocks.com/skills/persona-stage-theme-matrix-planner.zip",
  "api_item": "https://useaiblocks.com/api/v1/items/persona-stage-theme-matrix-planner",
  "api_document": "https://useaiblocks.com/api/v1/documents/skill/persona-stage-theme-matrix-planner",
  "mcp": "https://useaiblocks.com/mcp"
 }
}
