ClawHub
SkillsPluginsOfficialDocsSupport
K
skills/illustrated-paper-guide/teaching-diagram-maker
Other
#diagrams#education#svg#visual-explanation

Teaching Diagram Maker

Create and visually verify editable teaching diagrams

IIllustrated Paper Guide contributors@illustrated-paper-guide

Teaching Diagram Maker

Create diagrams that teach one idea clearly and remain editable. A diagram is complete only when it is saved beside the relevant note, embedded at the point of use, rendered, and visually inspected.

Scope

Use this skill for:

  • mechanisms, pathways, causal chains, and feedback loops;
  • temporal protocols and before/after sequences;
  • spatial or circuit layouts;
  • comparisons that benefit from repeated visual grammar;
  • input, parameter, and output relationships;
  • annotated evidence maps when a source figure is hard to read;
  • SVG clipping, overlap, font, encoding, and preview failures.

When used with illustrated-paper-guide, that skill decides which checkpoint needs a diagram and where it belongs. This skill owns diagram craft and QA.

Workflow

  1. Locate the explanation. Read the surrounding note and improve it in place. Do not create an orphan image.
  2. Define one learning job. Write the question the diagram should answer in one sentence.
  3. Choose the medium. Prefer SVG for editable conceptual diagrams. Use a plot or raster image when the source data or visual texture requires it.
  4. Design the reading order. Make the first, next, and final visual targets unambiguous.
  5. Create the asset. Save it under the note's images/ directory with a descriptive kebab-case filename.
  6. Embed it at the point of use. Add a short “How to read this” explanation beside the image.
  7. Validate the file. Confirm UTF-8 text, valid markup, and resolvable links.
  8. Render and inspect. Check the actual output, not only the source code.
  9. Iterate. Fix clipping, overlap, density, contrast, and misleading visual claims before finishing.

Diagram Selection

Learning problemUseful diagram
Competing explanationsSide-by-side hypothesis cards
Multi-step mechanismDirected causal chain
Timing or protocolTimeline or sequence comic
Anatomy or circuit placementSpatial map with labeled regions
Parameter changes an outcomeSmall-multiple comparison or response curve
Evidence vs interpretationLayered evidence map
Dense source panelAnnotated overlay with boxes and arrows

Skip a diagram when the content is only a naming fact and no relationship is made clearer visually.

SVG Standards

Start SVG files with an explicit UTF-8 declaration and view box:

xml
<?xml version="1.0" encoding="UTF-8"?>
<svg xmlns="http://www.w3.org/2000/svg" width="1200" height="700" viewBox="0 0 1200 700">

Use these defaults unless the surrounding note already has a visual system:

ElementDefault
Background#f8fafc
Title#0f172a, 16–18 px, weight 700
Body#334155, 11–13 px
Secondary text#64748b
Cardwhite fill, #cbd5e1 stroke, rounded corners
Font-apple-system, BlinkMacSystemFont, "Segoe UI", sans-serif

Craft rules:

  • Give each diagram one job.
  • Use a limited palette and consistent colors for repeated meanings.
  • Prefer large, spaced panels over one crowded canvas.
  • Put the meaningful contrast directly on the panels when useful.
  • Keep labels readable at the size used in the note.
  • Use arrows only when direction or causality is intended.
  • Distinguish measured evidence from explanatory analogy.
  • Avoid decorative elements that compete with the lesson.

Annotating Source Figures

Only annotate a source figure when the user's context and the intended output permit reuse. Preserve the source citation and do not present the annotation as original evidence.

Use boxes, arrows, and short labels to identify the exact visual evidence. Do not cover axes, legends, scale bars, uncertainty marks, or controls. If reuse rights are unclear for a public output, provide a source link and create an original schematic instead.

UTF-8 and Rendering

For diagrams containing non-ASCII text:

  • write and read the file explicitly as UTF-8;
  • include encoding="UTF-8" in SVG;
  • verify the file can be decoded after writing;
  • render the SVG to an image or open it in a visual preview;
  • if a preview cache is stale, use a new filename and update the note link.

A file that exists but renders as a broken image may have invalid XML, damaged encoding, an unsupported font reference, or a bad embedded asset. Inspect those before assuming the Markdown path is wrong.

Visual QA Checklist

Before finishing, verify:

  • no text is clipped or hidden behind shapes;
  • arrows do not cross labels or imply the wrong direction;
  • margins prevent canvas-edge cropping;
  • font size and contrast work at normal note width;
  • repeated concepts use consistent colors and shapes;
  • the visual conclusion matches the accompanying text;
  • the image link resolves from the note;
  • non-ASCII text survives a UTF-8 round trip;
  • at least one rendered output has been inspected visually.

Report the asset path, where it was embedded, how it was rendered, and any remaining limitation.

Downloads
616All time
Security audit
Pass
Last updated
3mo ago
Current version
v1.0.1
License
MIT-0

Install

$
openclaw skills install @illustrated-paper-guide/teaching-diagram-maker
Downloads
616All time
Security audit
Pass
Last updated
3mo ago
Current version
v1.0.1
License
MIT-0
ClawHub

Skills and plugins for OpenClaw agents. Part of the wider OpenClaw ecosystem.

Explore docs

SkillsPluginsOfficialAudits

Publish SkillPublish PluginCreate org

OverviewOpenClawDocsBlog

SupportGitHubDiscord

Built alongside the OpenClaw ecosystem

LobsterCrabboxClickClackCrabfleetOctopoolClawSweeperagent-skillsdiscrawlgitcrawlslacrawlnotcrawltelecrawlgraincrawlcrawlkitcrawlbaracpxmcporterTachikomaclawpatchclawbenchPeekaboocookbookplugin-inspectorwacrawlcrabpotAll projectsLobsterCrabboxClickClackCrabfleetOctopoolClawSweeperagent-skillsdiscrawlgitcrawlslacrawlnotcrawltelecrawlgraincrawlcrawlkitcrawlbaracpxmcporterTachikomaclawpatchclawbenchPeekaboocookbookplugin-inspectorwacrawlcrabpotAll projects

© 2026 OpenClaw Foundation

Privacy policy·Status·Deployed on Vercel·Powered by Convex

....:: clawhub/openclaw ::....  skills plugins publishers trust signals   :::: signed manifests ::::: moderated releases ::::: version history ::::   openclaw ecosystem    crabbox clickclack crawler packs gateway plugins
>>> install scan publish verify    @@ gateway @@ registry @@ agents @@     hooks runners slash-commands skill.md templates scanners review-bots   ---- downloads installs stars lineage ownership docs package integrity
  30 skills 12 plugins    /api/v1/skills   /owners   /audit   /ship   openclaw ecosystem    crabbox clickclack crawler packs gateway plugins     safe browse paths   official gateways   publisher handles   org trust
:::: signed manifests ::::: moderated releases ::::: version history ::::   ---- downloads installs stars lineage ownership docs package integrity   ....:: clawhub/openclaw ::....  skills plugins publishers trust signals
  hooks runners slash-commands skill.md templates scanners review-bots     safe browse paths   official gateways   publisher handles   org trust   >>> install scan publish verify    @@ gateway @@ registry @@ agents @@
openclaw ecosystem    crabbox clickclack crawler packs gateway plugins   ....:: clawhub/openclaw ::....  skills plugins publishers trust signals     30 skills 12 plugins    /api/v1/skills   /owners   /audit   /ship
---- downloads installs stars lineage ownership docs package integrity   >>> install scan publish verify    @@ gateway @@ registry @@ agents @@   :::: signed manifests ::::: moderated releases ::::: version history ::::
  safe browse paths   official gateways   publisher handles   org trust     30 skills 12 plugins    /api/v1/skills   /owners   /audit   /ship     hooks runners slash-commands skill.md templates scanners review-bots
....:: clawhub/openclaw ::....  skills plugins publishers trust signals   :::: signed manifests ::::: moderated releases ::::: version history ::::   openclaw ecosystem    crabbox clickclack crawler packs gateway plugins
>>> install scan publish verify    @@ gateway @@ registry @@ agents @@     hooks runners slash-commands skill.md templates scanners review-bots   ---- downloads installs stars lineage ownership docs package integrity
  30 skills 12 plugins    /api/v1/skills   /owners   /audit   /ship   openclaw ecosystem    crabbox clickclack crawler packs gateway plugins     safe browse paths   official gateways   publisher handles   org trust
:::: signed manifests ::::: moderated releases ::::: version history ::::   ---- downloads installs stars lineage ownership docs package integrity   ....:: clawhub/openclaw ::....  skills plugins publishers trust signals
  hooks runners slash-commands skill.md templates scanners review-bots     safe browse paths   official gateways   publisher handles   org trust   >>> install scan publish verify    @@ gateway @@ registry @@ agents @@
openclaw ecosystem    crabbox clickclack crawler packs gateway plugins   ....:: clawhub/openclaw ::....  skills plugins publishers trust signals     30 skills 12 plugins    /api/v1/skills   /owners   /audit   /ship
---- downloads installs stars lineage ownership docs package integrity   >>> install scan publish verify    @@ gateway @@ registry @@ agents @@   :::: signed manifests ::::: moderated releases ::::: version history ::::
  safe browse paths   official gateways   publisher handles   org trust     30 skills 12 plugins    /api/v1/skills   /owners   /audit   /ship     hooks runners slash-commands skill.md templates scanners review-bots
....:: clawhub/openclaw ::....  skills plugins publishers trust signals   :::: signed manifests ::::: moderated releases ::::: version history ::::   openclaw ecosystem    crabbox clickclack crawler packs gateway plugins
>>> install scan publish verify    @@ gateway @@ registry @@ agents @@     hooks runners slash-commands skill.md templates scanners review-bots   ---- downloads installs stars lineage ownership docs package integrity
  30 skills 12 plugins    /api/v1/skills   /owners   /audit   /ship   openclaw ecosystem    crabbox clickclack crawler packs gateway plugins     safe browse paths   official gateways   publisher handles   org trust
:::: signed manifests ::::: moderated releases ::::: version history ::::   ---- downloads installs stars lineage ownership docs package integrity   ....:: clawhub/openclaw ::....  skills plugins publishers trust signals
  hooks runners slash-commands skill.md templates scanners review-bots     safe browse paths   official gateways   publisher handles   org trust   >>> install scan publish verify    @@ gateway @@ registry @@ agents @@
openclaw ecosystem    crabbox clickclack crawler packs gateway plugins   ....:: clawhub/openclaw ::....  skills plugins publishers trust signals     30 skills 12 plugins    /api/v1/skills   /owners   /audit   /ship
---- downloads installs stars lineage ownership docs package integrity   >>> install scan publish verify    @@ gateway @@ registry @@ agents @@   :::: signed manifests ::::: moderated releases ::::: version history ::::
  safe browse paths   official gateways   publisher handles   org trust     30 skills 12 plugins    /api/v1/skills   /owners   /audit   /ship     hooks runners slash-commands skill.md templates scanners review-bots
....:: clawhub/openclaw ::....  skills plugins publishers trust signals   :::: signed manifests ::::: moderated releases ::::: version history ::::   openclaw ecosystem    crabbox clickclack crawler packs gateway plugins
>>> install scan publish verify    @@ gateway @@ registry @@ agents @@     hooks runners slash-commands skill.md templates scanners review-bots   ---- downloads installs stars lineage ownership docs package integrity
  30 skills 12 plugins    /api/v1/skills   /owners   /audit   /ship   openclaw ecosystem    crabbox clickclack crawler packs gateway plugins     safe browse paths   official gateways   publisher handles   org trust
:::: signed manifests ::::: moderated releases ::::: version history ::::   ---- downloads installs stars lineage ownership docs package integrity   ....:: clawhub/openclaw ::....  skills plugins publishers trust signals
  hooks runners slash-commands skill.md templates scanners review-bots     safe browse paths   official gateways   publisher handles   org trust   >>> install scan publish verify    @@ gateway @@ registry @@ agents @@
openclaw ecosystem    crabbox clickclack crawler packs gateway plugins   ....:: clawhub/openclaw ::....  skills plugins publishers trust signals     30 skills 12 plugins    /api/v1/skills   /owners   /audit   /ship
---- downloads installs stars lineage ownership docs package integrity   >>> install scan publish verify    @@ gateway @@ registry @@ agents @@   :::: signed manifests ::::: moderated releases ::::: version history ::::
  safe browse paths   official gateways   publisher handles   org trust     30 skills 12 plugins    /api/v1/skills   /owners   /audit   /ship     hooks runners slash-commands skill.md templates scanners review-bots
....:: clawhub/openclaw ::....  skills plugins publishers trust signals   :::: signed manifests ::::: moderated releases ::::: version history ::::   openclaw ecosystem    crabbox clickclack crawler packs gateway plugins
>>> install scan publish verify    @@ gateway @@ registry @@ agents @@     hooks runners slash-commands skill.md templates scanners review-bots   ---- downloads installs stars lineage ownership docs package integrity
  30 skills 12 plugins    /api/v1/skills   /owners   /audit   /ship   openclaw ecosystem    crabbox clickclack crawler packs gateway plugins     safe browse paths   official gateways   publisher handles   org trust
:::: signed manifests ::::: moderated releases ::::: version history ::::   ---- downloads installs stars lineage ownership docs package integrity   ....:: clawhub/openclaw ::....  skills plugins publishers trust signals
  hooks runners slash-commands skill.md templates scanners review-bots     safe browse paths   official gateways   publisher handles   org trust   >>> install scan publish verify    @@ gateway @@ registry @@ agents @@
openclaw ecosystem    crabbox clickclack crawler packs gateway plugins   ....:: clawhub/openclaw ::....  skills plugins publishers trust signals     30 skills 12 plugins    /api/v1/skills   /owners   /audit   /ship
---- downloads installs stars lineage ownership docs package integrity   >>> install scan publish verify    @@ gateway @@ registry @@ agents @@   :::: signed manifests ::::: moderated releases ::::: version history ::::
  safe browse paths   official gateways   publisher handles   org trust     30 skills 12 plugins    /api/v1/skills   /owners   /audit   /ship     hooks runners slash-commands skill.md templates scanners review-bots
....:: clawhub/openclaw ::....  skills plugins publishers trust signals   :::: signed manifests ::::: moderated releases ::::: version history ::::   openclaw ecosystem    crabbox clickclack crawler packs gateway plugins
>>> install scan publish verify    @@ gateway @@ registry @@ agents @@     hooks runners slash-commands skill.md templates scanners review-bots   ---- downloads installs stars lineage ownership docs package integrity
  30 skills 12 plugins    /api/v1/skills   /owners   /audit   /ship   openclaw ecosystem    crabbox clickclack crawler packs gateway plugins     safe browse paths   official gateways   publisher handles   org trust
:::: signed manifests ::::: moderated releases ::::: version history ::::   ---- downloads installs stars lineage ownership docs package integrity   ....:: clawhub/openclaw ::....  skills plugins publishers trust signals