{
 "schema": "aiblocks-page/1",
 "id": "agency-design-visual-storyteller",
 "type": "agent",
 "name": "Visual story planner",
 "summary": "Turn your message into a visual story plan, with the story arc, a frame-by-frame sequence of one message per frame and a version for each channel.",
 "headline": "Visual story planner",
 "subhead": "Give it your story goal, your audience, where it will be seen and any brand notes. The agent shapes a story with a start, a problem and an ending. You get a frame-by-frame plan with a message and a visual for each frame, ready for a designer or an image tool.",
 "job": {
  "id": "design-work",
  "name": "Design things people love"
 },
 "level": "intermediate",
 "thinking": "high",
 "tested": true,
 "updated": "2026-11-03",
 "first_published": "2026-10-26",
 "inputs": [
  {
   "type": "question",
   "required": true,
   "label": "Question",
   "what": "the problem, decision or piece of work you want help with, and what a good outcome looks like"
  },
  {
   "type": "source_text",
   "required": false,
   "label": "Source text",
   "what": "a long source in full: an article, a video or talk transcript, or notes from a book, with its title, author and link"
  },
  {
   "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"
  },
  {
   "type": "document",
   "required": true,
   "label": "Document",
   "what": "a finished document, such as a Word file, a PDF or a page of notes"
  }
 ],
 "you_give": [
  "The message or goal of the story, in one or two sentences",
  "Who it is for and where it will be seen, such as Instagram Stories, YouTube or your website",
  "How long or how many frames you have (optional)",
  "Your brand notes, such as tone, colours and fonts (optional)",
  "Facts, data or customer notes the story should use (optional)"
 ],
 "you_get": [
  "A story arc covering who it is about, the problem and the ending",
  "A frame-by-frame sequence with one message, one visual and one feeling per frame",
  "Notes on pace, with where the story slows and where it lands",
  "A version for each channel you name, with what changes in format and length",
  "Accessibility notes such as captions, alt text and colour contrast",
  "A list of what a designer or image tool still has to make"
 ],
 "use_when": [
  "You have a message or some data and need it told as a short visual story.",
  "You are planning a brand video, a carousel or a story series and need the order of the frames.",
  "One story must run on several channels, each in its own shape.",
  "You have a complex idea and want a plan for an infographic or explainer."
 ],
 "skip_when": [
  "You already have a video ad script and want it turned into a storyboard. Use the Video avatar and storyboard planner.",
  "You want the written story first, such as one strong case to build on. Use the Case study story planner.",
  "You want a frame turned into an image prompt. Use the Image and video prompt director."
 ],
 "output_sample": {
  "input": [
   "The message or goal of your story",
   "Who it is for and where it will be seen",
   "Your brand notes (optional)",
   "Facts, data or customer notes to use (optional)"
  ],
  "prerequisites": [
   "An AI that reads pasted text, such as Claude, ChatGPT or Gemini",
   "A designer or an image or video tool to make the frames"
  ],
  "output": [
   {
    "name": "Story goal",
    "contains": "The one message, the audience, the channel and the length."
   },
   {
    "name": "Story arc",
    "contains": "The hero, the problem, the ending and the feeling at the end."
   },
   {
    "name": "Frame sequence",
    "contains": "Numbered frames, each with one message, one visual, any words and a pace."
   },
   {
    "name": "Channel versions",
    "contains": "How the plan changes for each channel you named."
   },
   {
    "name": "Accessibility notes",
    "contains": "Captions, alt text, colour contrast and motion limits."
   },
   {
    "name": "Still to make",
    "contains": "The images, footage or graphics a designer or tool must produce."
   },
   {
    "name": "Open checks",
    "contains": "What was not verified, such as facts to confirm."
   }
  ]
 },
 "output_shape": "STORY GOAL\n  Message <one line> | Audience <who> | Channel and length <where, how long>\n\nARC\n  Hero <who it is about> | Problem <what goes wrong> | Ending <how it resolves> | Feeling at the end <feeling>\n\nFRAME SEQUENCE\n  <number> | message <one line> | visual <what is shown> | words or sound <caption or voice> | feeling <feeling> | pace <slow, steady or fast>\n\nCHANNEL VERSIONS\n  <channel> | format and length | what changes from the main plan\n\nACCESSIBILITY\n  <captions, alt text, contrast, motion notes>\n\nSTILL TO MAKE\n  <assets a designer or tool must produce>\n\nOPEN CHECKS\n  <what is unverified>",
 "how_to_use": [
  "Add the pack to your AI as a skill. If you cannot, start a new chat and paste SKILL.md, then references/source-agent.md.",
  "Paste your goal, your audience and where it will be seen. Add any facts or data the story must use.",
  "Say how many frames or seconds you have. If you do not know, it proposes a length and marks it as proposed.",
  "Read the arc first. Can you tell the story in three lines? If not, fix the arc before you look at frames.",
  "Check each frame for one message only. Cut or merge frames that repeat.",
  "Give the frames to a designer. Or use the Image and video prompt director to turn each frame into an image prompt."
 ],
 "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": "UI designer agent",
   "url": "https://useaiblocks.com/skills/agency-design-ui-designer",
   "why": "Design it"
  }
 ],
 "source": {
  "by": "Michael Sitarzewski and Agency Agents contributors",
  "repo": "msitarzewski/agency-agents",
  "url": "https://github.com/msitarzewski/agency-agents/blob/b37b5bb33b78f2c1d6567d98e25ca818e3259219/design/design-visual-storyteller.md",
  "licence": "MIT",
  "original_name": "Visual Storyteller",
  "commit": "b37b5bb33b78f2c1d6567d98e25ca818e3259219"
 },
 "credits": [
  {
   "title": "Visual Storyteller",
   "by": "Michael Sitarzewski and Agency Agents contributors",
   "url": "https://github.com/msitarzewski/agency-agents/blob/b37b5bb33b78f2c1d6567d98e25ca818e3259219/design/design-visual-storyteller.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-visual-storyteller",
  "markdown": "https://useaiblocks.com/agents/agency-design-visual-storyteller.md",
  "json": "https://useaiblocks.com/agents/agency-design-visual-storyteller.json",
  "instructions": "https://useaiblocks.com/skills/agency-design-visual-storyteller/SKILL.md",
  "download": "https://useaiblocks.com/skills/agency-design-visual-storyteller.zip",
  "api_item": "https://useaiblocks.com/api/v1/items/agency-design-visual-storyteller",
  "api_document": "https://useaiblocks.com/api/v1/documents/agent/agency-design-visual-storyteller",
  "mcp": "https://useaiblocks.com/mcp"
 }
}
