{
 "schema": "aiblocks-page/1",
 "id": "workflow-diagram-and-change-planner",
 "type": "skill",
 "name": "Workflow diagram and change planner",
 "summary": "Share a workflow or goal. Get it drawn as a diagram, each hand-off checked, and changes with reasons.",
 "headline": "Workflow diagram and change planner",
 "subhead": "Share a workflow, a goal or your own steps. It draws the steps as a diagram, shows what each one hands to the next, and finds gaps. Then it asks what you want to change, suggests fixes with reasons and draws it again.",
 "job": {
  "id": "set-up-ai",
  "name": "Set up AI to work for you"
 },
 "level": "beginner",
 "thinking": "medium",
 "tested": true,
 "updated": "2026-10-28",
 "first_published": "2026-10-27",
 "inputs": [
  {
   "type": "plan",
   "required": true,
   "label": "Plan",
   "what": "a dated plan: what to do, in what order, with a decision rule for each step"
  },
  {
   "type": "question",
   "required": false,
   "label": "Question",
   "what": "the problem, decision or piece of work you want help with, and what a good outcome looks like"
  }
 ],
 "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": [
  "A workflow id or link, a goal, or your own steps in order",
  "What you want to change (optional)"
 ],
 "you_get": [
  "A diagram of the steps, with what each one hands on",
  "A short outline and a list of gaps",
  "Suggested changes, each with a reason",
  "A new diagram once you approve the changes"
 ],
 "use_when": [
  "You found a ready workflow and want to see how its steps connect before you use it.",
  "You want to swap, add or remove a step and keep everything else working.",
  "A workflow keeps stalling and you want to find the step that is missing something."
 ],
 "skip_when": [
  "You want to run the workflow: open it in your AI and follow its steps instead.",
  "You need one task done, not a chain of steps: use that task's skill on its own.",
  "You want an automation in Zapier or Make: use the Automation flow sketcher."
 ],
 "output_sample": {
  "input": [
   "A workflow id or link, a goal, or your own steps in order",
   "What you want to change (optional)"
  ],
  "prerequisites": [
   "An AI that shows Mermaid diagrams, such as Claude or ChatGPT. Without one, you get the same thing as a text outline.",
   "The AI Blocks connection (optional). Without it, the skill works from the steps you paste."
  ],
  "output": [
   {
    "name": "Diagram",
    "contains": "A Mermaid flowchart with one box per step, arrows labelled with what is passed on, and your inputs as start points."
   },
   {
    "name": "Outline",
    "contains": "Each step in order, what it takes and from where, and what it hands on."
   },
   {
    "name": "Gaps",
    "contains": "Missing inputs, steps out of order and repeated steps, one line each."
   },
   {
    "name": "Suggested changes",
    "contains": "Add, move, swap or remove a step, each with a one-line reason."
   },
   {
    "name": "New diagram",
    "contains": "The workflow redrawn with only the changes you approved, and a builder link when connected."
   },
   {
    "name": "Checks missed",
    "contains": "Any of its own checks that failed, or none."
   }
  ]
 },
 "output_shape": "DIAGRAM\n```mermaid\nflowchart LR\n  u1([\"You give: <input>\"])\n  s1[\"1. <step>\"]\n  s2[\"2. <step>\"]\n  u1 --> s1\n  s1 -->|\"<what is handed on>\"| s2\n```\n\nOUTLINE\n1. <step>: takes <input> from <you | step n>; hands on <result>\n\nGAPS\n- <Missing | Out of order | Repeated>: <step> <what>\n\nSUGGESTED CHANGES\n- <Add | Move | Swap | Remove> <step>: <reason>\n\nNEW DIAGRAM (after you approve)\n<diagram>   Open in builder: <link>\n\nCHECKS MISSED\n<failed checks, or none>",
 "how_to_use": [
  "Start a chat with the skill. Open it if you added it to your AI, or copy it and paste it in.",
  "Connect your AI to AI Blocks if you can, so it can load any workflow and check it for you.",
  "Share the workflow link, your goal or your steps in order.",
  "Read the diagram and the gaps, then say what you want to change.",
  "Approve the changes you want. It draws the new version, with a link to open it in the builder."
 ],
 "checks": [
  "Every step is in the diagram, in order.",
  "Every arrow says what is handed over.",
  "Each gap names the step and what it is missing.",
  "Each suggested change has a reason you understand.",
  "Nothing changed before you agreed."
 ],
 "next": [],
 "source": null,
 "credits": [
  {
   "title": "Flowcharts syntax",
   "by": "Mermaid",
   "url": "https://mermaid.js.org/syntax/flowchart.html",
   "used": "The diagram format, with quoted labels and entity codes for quotes and brackets"
  },
  {
   "title": "AI Blocks API and MCP",
   "by": "AI Blocks",
   "url": "https://useaiblocks.com/api-and-mcp",
   "used": "get_workflow, plan_workflow and prepare_workflow, which return the diagram, the hand-off check and suggested changes"
  }
 ],
 "files": [],
 "links": {
  "page": "https://useaiblocks.com/skills/workflow-diagram-and-change-planner",
  "markdown": "https://useaiblocks.com/skills/workflow-diagram-and-change-planner.md",
  "json": "https://useaiblocks.com/skills/workflow-diagram-and-change-planner.json",
  "instructions": "https://useaiblocks.com/skills/workflow-diagram-and-change-planner/SKILL.md",
  "api_item": "https://useaiblocks.com/api/v1/items/workflow-diagram-and-change-planner",
  "api_document": "https://useaiblocks.com/api/v1/documents/skill/workflow-diagram-and-change-planner",
  "mcp": "https://useaiblocks.com/mcp"
 }
}