{
 "schema": "aiblocks-page/1",
 "id": "study-note-diagrams",
 "type": "skill",
 "name": "Study note diagram maker",
 "summary": "Turn a lesson concept into a clear study note diagram: a flowchart, table or simple drawing, with a caption, placed right beside your explanation.",
 "headline": "Study note diagram maker",
 "subhead": "Share the lesson section and the idea readers need to see. It chooses a table, flowchart or simple drawing to match the idea. You get a compact visual with a caption, ready to place beside the explanation in your notes.",
 "job": {
  "id": "study-and-practice",
  "name": "Study and check your understanding"
 },
 "level": "beginner",
 "thinking": "medium",
 "tested": true,
 "updated": "2026-10-28",
 "first_published": "2026-10-25",
 "inputs": [
  {
   "type": "source_text",
   "required": true,
   "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"
  }
 ],
 "outputs": [
  {
   "type": "document",
   "required": true,
   "label": "Document",
   "what": "a finished document, such as a Word file, a PDF or a page of notes"
  }
 ],
 "you_give": [
  "A lesson section and the concept to explain.",
  "Your note folder and the learner level."
 ],
 "you_get": [
  "A compact Mermaid diagram, SVG drawing or table.",
  "A caption saying what to notice.",
  "An embed path suited to your local lesson notes."
 ],
 "use_when": [],
 "skip_when": [
  "You need a full lesson plan: ask your AI to write the plan first, then come back for the pictures.",
  "Your idea is plain text with no steps or parts: use a short paragraph or a plain bullet list instead of a diagram.",
  "You want a table to compare features: ask your AI for a plain table, no diagram needed."
 ],
 "output_sample": {
  "input": [
   "The lesson section that explains the concept",
   "The one idea the reader needs to see",
   "The learner level, such as beginner (optional)",
   "Your notes folder, if your AI can save files (optional)"
  ],
  "prerequisites": [
   "An AI that can write Mermaid code. A viewer like Obsidian shows the diagram.",
   "An AI that can save files, only if you want an SVG drawing saved to your notes folder"
  ],
  "output": [
   {
    "name": "Chosen visual form",
    "contains": "The type that fits your idea, such as a flowchart, timeline, mind map, table or SVG drawing."
   },
   {
    "name": "Mermaid diagram",
    "contains": "A small diagram in a code block, under about 15 boxes, with short labels."
   },
   {
    "name": "SVG drawing",
    "contains": "A static picture file for layouts Mermaid cannot show, only when the idea needs one."
   },
   {
    "name": "Caption",
    "contains": "One line under the visual that tells the reader what to notice."
   },
   {
    "name": "Placement",
    "contains": "Where the visual goes in your note, right after the idea it explains, plus the embed link for an SVG."
   }
  ]
 },
 "how_to_use": [
  "Paste this skill into a chat with Claude, ChatGPT or Gemini. No code running is needed for a Mermaid diagram.",
  "Paste the lesson section and name the one idea you want to show. Add the learner level if you know it.",
  "Your AI picks the form: flowchart, timeline, mind map, table or drawing. Ask it to explain the choice if you disagree.",
  "In a plain chat, the reply comes in this order: one Mermaid code block, a one-line caption on what to notice, then one sentence on where it goes in your notes.",
  "Check the diagram. It should have about 15 boxes or fewer, with short labels. Ask for a split if it is too busy.",
  "Paste the diagram code into your notes right after the explanation. Add the caption under it.",
  "Then check that the caption matches your explanation and that every label is true to the lesson. If a label differs from the lesson, stop and fix it before you study from it. To turn the notes into practice, ask for flashcards with the flashcard maker.",
  "For an SVG file, use an AI that can save files, and save it in your notes folder.",
  "A plain chat works fine. You do not need a notes vault, a Mermaid checker or a file-saving tool. The skill's dashboard chart and helper agent sections are for a full learning vault, so ignore them for one diagram."
 ],
 "checks": [],
 "next": [
  {
   "name": "Study notebook reviewer",
   "url": "https://useaiblocks.com/skills/study-notebook-review",
   "why": "Study notebook reviewer"
  },
  {
   "name": "Study gap tracker",
   "url": "https://useaiblocks.com/skills/study-gap-tracker",
   "why": "Study gap tracker"
  },
  {
   "name": "Study revision coach",
   "url": "https://useaiblocks.com/skills/study-revision-coach",
   "why": "Study revision coach"
  }
 ],
 "source": {
  "by": "Mohamed El-Sharqawy",
  "repo": "Mohamed-El-Sharqawy/agent-tutor",
  "url": "https://github.com/Mohamed-El-Sharqawy/agent-tutor/tree/5651e2eec062785967d07bcb4752a59f1bcf0eee/skills/agent-tutor-visualize",
  "licence": "MIT",
  "original_name": "agent-tutor-visualize",
  "commit": "5651e2eec062785967d07bcb4752a59f1bcf0eee"
 },
 "credits": [
  {
   "title": "agent-tutor-visualize skill",
   "by": "Mohamed El-Sharqawy",
   "url": "https://github.com/Mohamed-El-Sharqawy/agent-tutor/tree/5651e2eec062785967d07bcb4752a59f1bcf0eee/skills/agent-tutor-visualize",
   "used": "Copied under the MIT licence. We gave it a plain name. We added Before you start and After this sections that link to other AI Blocks steps."
  }
 ],
 "files": [
  "LICENSE"
 ],
 "links": {
  "page": "https://useaiblocks.com/skills/study-note-diagrams",
  "markdown": "https://useaiblocks.com/skills/study-note-diagrams.md",
  "json": "https://useaiblocks.com/skills/study-note-diagrams.json",
  "instructions": "https://useaiblocks.com/skills/study-note-diagrams/SKILL.md",
  "download": "https://useaiblocks.com/skills/study-note-diagrams.zip",
  "api_item": "https://useaiblocks.com/api/v1/items/study-note-diagrams",
  "api_document": "https://useaiblocks.com/api/v1/documents/skill/study-note-diagrams",
  "mcp": "https://useaiblocks.com/mcp"
 }
}