excalidraw-learning-aids

Installation
SKILL.md

Excalidraw Learning Aids

Use this skill to turn complex systems into clear, large, teachable Excalidraw visuals. Prioritize comprehension over diagram density: the result should be more readable than a typical Mermaid diagram and should not require squinting.

Core workflow

  1. Clarify the teaching target only when necessary: audience, repo area, mechanism, and output format.
  2. Inspect the source material. For software repositories, map entrypoints, modules, runtime boundaries, data/control flow, and the specific mechanism being taught. Use scripts/repo_snapshot.py when a quick repo map would help.
  3. Choose the visual format:
    • architecture map: services, packages, layers, dependencies
    • request/mechanism flow: numbered path through handlers, queues, stores, workers
    • lifecycle/state model: phases, triggers, side effects
    • mental model: concepts, analogies, and constraints
    • before/after or comparison: tradeoffs and design alternatives
  4. Draft a storyboard before drawing: title, 3-7 key ideas, visual chunks, arrows, callouts, and learner takeaway.
  5. Create the Excalidraw output through the best available route:
    • if an Excalidraw MCP tool is available, call its documentation/readme tool first, then create or update the scene with large elements and labels.
    • if a self-hosted or Plus API is available, use the configured endpoint and credentials; do not assume the alpha Plus API is stable.
    • if no live drawing tool is available, generate a portable .excalidraw file. Use scripts/create_excalidraw_scene.py for structured flow/architecture diagrams.
Related skills

More from jarmen423/skills

Installs
1
GitHub Stars
2
First Seen
3 days ago